> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.pandectes.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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](https://apps.shopify.com/gdpr-cookie-consent) 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:

| Clarity-Berechtigung | Was sie abdeckt | Pandectes-Cookie-Kategorie |
| ---- |
| `analytics_Storage` | Nutzerverhalten, Sitzungen, Heatmaps | Leistung / Analytics |
| `ad_Storage` | Retargeting, Conversions, Werbeleistung | Marketing / Werbung |

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](https://learn.microsoft.com/en-us/clarity/setup-and-installation/cmp-integration-guide), 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

| Cookie | Erfordert |
| ---- |
| `_clck` (First Party) | `analytics_Storage=granted` |
| `_clsk` (First Party) | `analytics_Storage=granted` |
| `MUID` | `ad_Storage=granted` |

### 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.

|| Hinweis: Für Besucher aus dem Europäischen Wirtschaftsraum (EWR), dem Vereinigten Königreich und der Schweiz ist der Consent Mode standardmäßig aktiviert. Verkauft Ihr Shop ausschließlich in diese Regionen, ist keine Änderung nötig. Für Shops mit weltweitem Publikum folgen Sie den Schritten unten.

###### Den Consent Mode in den Clarity-Einstellungen aktivieren

* Öffnen Sie Ihr [Microsoft-Clarity-Dashboard](https://clarity.microsoft.com/).
* 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.

![](https://storage.crisp.chat/users/helpdesk/website/-/1/a/5/a/1a5af239e847cf00/image_ho0429.png =800x405)
###### 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**.
![](https://storage.crisp.chat/users/helpdesk/website/-/1/a/5/a/1a5af239e847cf00/image_eszb4s.png =300x225)
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.

![](https://storage.crisp.chat/users/helpdesk/website/-/1/a/5/a/1a5af239e847cf00/image_tiaixj.png =800x315)

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](https://learn.microsoft.com/en-us/clarity/setup-and-installation/cmp-integration-guide).