Die Microsoft Clarity Consent API mit Pandectes einbinden

Microsoft Clarity ist ein kostenloses Analysewerkzeug mit Heatmaps und Sitzungsaufzeichnungen, das Ihnen hilft, das Nutzerverhalten auf Ihrer Website zu verstehen. Da Clarity Verhaltensdaten erhebt, ist sein Einsatz in der EU nach DSGVO und ePrivacy-Richtlinie nur mit vorheriger Einwilligung zulässig.

Mit Pandectes binden Sie Microsoft Clarity unkompliziert in Ihren Shopify-Shop ein und stellen sicher, dass die Datenerhebung erst nach einer wirksamen Einwilligung beginnt.

Voraussetzungen

Bevor Sie beginnen:

• Sie benötigen ein Microsoft-Clarity-Konto.
• In Ihrem Shopify-Shop muss die App Pandectes GDPR Compliance installiert und konfiguriert sein.
• Stellen Sie sicher, dass Sie die Microsoft-Clarity-Integration in der App aktiviert haben.

Was ist die Clarity Consent API?

Mit der Clarity Consent API steuern Sie anhand der Entscheidungen des Nutzers, was Clarity erfassen darf. So halten Sie die DSGVO ein und verhindern eine unbefugte Datenerhebung.
Clarity kennt zwei voneinander unabhängige Einwilligungstypen:

Jede Berechtigung kann unabhängig erteilt oder verweigert werden. Ein Nutzer kann zum Beispiel Analyse akzeptieren und Werbung ablehnen. Pandectes respektiert jede Entscheidung und übermittelt sie einzeln an Clarity.

So funktioniert die Integration

Ist die Integration aktiviert, sendet Pandectes Einwilligungssignale an Clarity, die auf den Entscheidungen des Nutzers beruhen. Dabei gilt: Es werden keine Cookies gesetzt und es findet kein Tracking statt, bis das entsprechende Einwilligungssignal vorliegt.

Wie das Clarity-Skript geladen wird, hängt davon ab, ob Sie in den Pandectes-Einstellungen eine Project ID hinterlegen:

• Mit Project ID: Pandectes lädt das Clarity-Skript automatisch so früh wie möglich beim Seitenaufbau, entsprechend der offiziellen Empfehlung von Microsoft, dass das Skript unabhängig vom Einwilligungsstatus laufen soll, damit keine Signale verloren gehen.
• Ohne Project ID: Sie sind selbst dafür verantwortlich, das Clarity-Skript in Ihrem Shop zu laden. Pandectes sendet die Einwilligungssignale weiterhin, doch das Skript muss auf der Seite vorhanden sein, damit sie wirken.

Das geschieht, nachdem der Nutzer mit dem Einwilligungsbanner interagiert hat:

1. Pandectes liest die Cookie-Entscheidungen des Nutzers.
2. Für jede akzeptierte Kategorie wird die zugehörige Clarity-Berechtigung auf "granted" gesetzt.
3. Für jede abgelehnte Kategorie wird die zugehörige Berechtigung auf "denied" gesetzt.
4. Pandectes ruft die Clarity Consent API mit den ermittelten Berechtigungen auf.

Was Clarity ohne Einwilligung tut

Wird die Einwilligung verweigert, stoppt Clarity nicht einfach, sondern wechselt in den cookielosen Modus. Das bedeutet:

• Es findet kein sitzungsübergreifendes Tracking statt.
• Die einwilligungspflichtigen Cookies werden nicht gesetzt (siehe Tabelle unten).
• Begrenzte, nicht identifizierende Daten können weiterhin erhoben werden.

Cookies, die von der Einwilligung abhängen

Den Consent Mode in Clarity aktivieren

Bevor Pandectes die Einwilligung an Clarity übermitteln kann, muss der Consent Mode in den Einstellungen Ihres Clarity-Projekts aktiv sein. Das verhindert, dass Clarity Cookies setzt, bevor ein gültiges Einwilligungssignal vorliegt.

Den Consent Mode in den Clarity-Einstellungen aktivieren

• Öffnen Sie Ihr Microsoft-Clarity-Dashboard.
• Gehen Sie zu Settings → Setup.
• Scrollen Sie nach unten und schalten Sie die Option Cookies aus.
• Clarity bestätigt, dass Cookies deaktiviert sind, bis eine Einwilligung vorliegt.

Prüfen, ob die Einwilligung korrekt ankommt

Nach der Einrichtung können Sie prüfen, ob Clarity die Einwilligungssignale von Pandectes korrekt erhält:

1. Öffnen Sie Ihren Shop im Browser und öffnen Sie die Entwicklerwerkzeuge (Strg+Umschalt+I / Cmd+Option+I).
2. Wechseln Sie zum Reiter Console.
3. Fügen Sie Folgendes ein und führen Sie es aus:

clarity('metadata', (d, upgrade, consent) => {
    console.log('consentStatus:', consent);
}, false, true, true);

4. Liegt keine Einwilligung vor, sollten Sie dies sehen:

{ "analytics_storage": "DENIED", "ad_storage": "DENIED" }

5. Nachdem Sie die Cookies im Pandectes-Banner akzeptiert haben, sollte die Ausgabe die Entscheidungen des Nutzers widerspiegeln.

Microsoft Clarity in Pandectes aktivieren

Gehen Sie so vor:

1. Melden Sie sich in Ihrem Shopify-Shop an und öffnen Sie die Pandectes-App.
2. Gehen Sie zu Settings > Integrations.
3. Scrollen Sie zu Microsoft Clarity und klicken Sie auf Configure.

1. Schalten Sie den Schalter um, um die Integration zu aktivieren.
2. (Optional) Fügen Sie Ihre Clarity Project ID ein, wenn Pandectes das Clarity-Skript für Sie laden soll. Lassen Sie das Feld leer, müssen Sie das Skript selbst in Ihrem Shop einbinden.

Nach der Aktivierung wird Pandectes:

• granulare Einwilligungssignale senden (analytics_Storage und ad_Storage), basierend auf den tatsächlichen Entscheidungen des Nutzers.
• verhindern, dass Clarity-Cookies geschrieben werden, bis die entsprechende Einwilligung vorliegt.
• das Clarity-Skript automatisch laden (nur wenn eine Project ID hinterlegt ist), und zwar so früh wie möglich beim Seitenaufbau, damit keine Einwilligungssignale verloren gehen.

Abschließende Hinweise

Diese Integration ist vollständig rechtskonform und optimiert für:

• Shopify-Shops, die in der EU verkaufen
• Händler, die der DSGVO, dem CCPA und weiteren Datenschutzrahmen unterliegen
• Shops, die automatisierte, granulare Kontrolle über Drittanbieter-Tracking suchen

Weitere Einzelheiten finden Sie in der offiziellen Microsoft-Dokumentation zur CMP-Integration mit Clarity.

Aktualisiert am: 22/09/2026