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

# Microsoft Clarity Consent API integreren met Pandectes

Microsoft Clarity is een gratis analysetool met heatmaps en sessieopnames waarmee je het gedrag van gebruikers op je website beter begrijpt. Omdat Clarity gedragsgegevens verzamelt, is in de EU vooraf toestemming van de gebruiker nodig op grond van de **AVG (GDPR)** en de **ePrivacyrichtlijn**.

Met Pandectes integreer je Microsoft Clarity eenvoudig in je Shopify-winkel en zorg je ervoor dat gegevensverzameling pas begint **nadat geldige toestemming van de gebruiker is verkregen**.

### Vereisten

Voordat je begint:

* Je moet een Microsoft Clarity-account hebben.
* In je Shopify-winkel moet de app [Pandectes GDPR Compliance](https://apps.shopify.com/gdpr-cookie-consent) zijn geïnstalleerd en geconfigureerd.
* Zorg dat je de Microsoft Clarity-integratie in de app hebt ingeschakeld.

### Wat is de Clarity Consent API?

Met de Clarity Consent API bepaal je wat Clarity mag bijhouden op basis van de toestemmingskeuzes van de gebruiker. Zo blijf je AVG-conform en voorkom je ongeautoriseerde gegevensverzameling.
Clarity gebruikt twee onafhankelijke toestemmingstypen:

| Clarity permission | What it covers | Pandectes cookie category |
| ---- |
| `analytics_Storage` | Gebruikersgedrag, sessies, heatmaps | Performance / Analytics |
| `ad_Storage` | Retargeting, conversies, advertentieprestaties | Marketing / Advertising |

Elke toestemming kan afzonderlijk worden verleend of geweigerd. Een gebruiker kan bijvoorbeeld analyse accepteren maar advertenties weigeren. Pandectes respecteert elke keuze en geeft die afzonderlijk door aan Clarity.

### Hoe de integratie werkt

Wanneer de integratie is ingeschakeld, stuurt Pandectes toestemmingssignalen naar Clarity op basis van de keuzes van de gebruiker. Er worden echter **geen cookies geplaatst en er vindt geen tracking plaats** totdat het juiste toestemmingssignaal is ontvangen.
naar Clarity afzonderlijk door

**Hoe het Clarity-script wordt geladen** hangt ervan af of je een Project ID opgeeft in de Pandectes-instellingen:
* **Met een Project ID:** Pandectes laadt het Clarity-script automatisch zo vroeg mogelijk tijdens het laden van de pagina, volgens [de officiële aanbeveling van Microsoft](https://learn.microsoft.com/en-us/clarity/setup-and-installation/cmp-integration-guide) dat het script draait ongeacht de toestemmingsstatus, zodat signalen nooit worden gemist.
* **Zonder Project ID:** Je bent zelf verantwoordelijk voor het laden van het Clarity-script in je winkel. Pandectes verstuurt de toestemmingssignalen nog steeds, maar het script moet op de pagina aanwezig zijn om effect te hebben.

Dit gebeurt nadat de gebruiker met de toestemmingsbanner heeft gewerkt:

1. Pandectes leest de cookiekeuzes van de gebruiker.
2. Voor elke geaccepteerde categorie wordt de bijbehorende Clarity-toestemming ingesteld op `"granted"`.
3. Voor elke geweigerde categorie wordt de bijbehorende toestemming ingesteld op `"denied"`.
4. Pandectes roept de Clarity Consent API aan met de bepaalde toestemmingen.

###### Wat Clarity doet zonder toestemming

Wanneer toestemming wordt geweigerd, stopt Clarity **niet** zomaar, maar schakelt het over naar de **cookieloze modus**. Dat betekent:
* Er vindt geen sessieoverstijgende tracking plaats.
* De cookies waarvoor toestemming nodig is, worden niet geplaatst (zie onderstaande tabel).
* Er kunnen nog beperkte, niet-identificerende gegevens worden verzameld.

###### Cookies die door toestemming worden gestuurd

| Cookie | Requires |
| ---- |
| `_clck` (first-party) | `analytics_Storage=granted` |
| `_clsk` (first-party) | `analytics_Storage=granted` |
| `MUID` | `ad_Storage=granted` |

### Consent Mode inschakelen in Clarity

Voordat Pandectes toestemming aan Clarity kan doorgeven, moet je ervoor zorgen dat Consent Mode actief is in de instellingen van je Clarity-project. Zo voorkom je dat Clarity cookies plaatst voordat een geldig toestemmingssignaal is ontvangen.

|| Opmerking: Consent Mode is standaard ingeschakeld voor bezoekers uit de Europese Economische Ruimte (EER), het Verenigd Koninkrijk en Zwitserland. Als je winkel uitsluitend in deze regio's verkoopt, hoef je niets te wijzigen. Volg voor winkels met een wereldwijd publiek onderstaande stappen.

###### Consent Mode inschakelen in de Clarity-instellingen

* Ga naar je [Microsoft Clarity-dashboard](https://clarity.microsoft.com/).
* Ga naar **Settings → Setup**.
* Scrol omlaag en zet de optie **Cookies** **uit**.
* Clarity bevestigt dat cookies zijn uitgeschakeld totdat toestemming is ontvangen.

![](https://storage.crisp.chat/users/helpdesk/website/-/1/a/5/a/1a5af239e847cf00/image_ho0429.png =800x405)
###### Controleren of toestemming goed werkt

Na het instellen van de integratie kun je controleren of Clarity de toestemmingssignalen van Pandectes correct ontvangt:

1. Open je winkel in een browser en open de **Developer Tools** (`Ctrl+Shift+I` / `Cmd+Option+I`).
2. Ga naar het tabblad **Console**.
3. Plak de volgende code en voer die uit:
```
clarity('metadata', (d, upgrade, consent) => {
    console.log('consentStatus:', consent);
}, false, true, true);
```
4. Als er geen toestemming is gegeven, zie je:
```
{ "analytics_storage": "DENIED", "ad_storage": "DENIED" }
```
5. Nadat je cookies hebt geaccepteerd in de Pandectes-banner, wordt de uitvoer bijgewerkt naar de keuzes van de gebruiker.

### Microsoft Clarity inschakelen in Pandectes
Volg deze stappen:

1. Log in op je Shopify-winkel en open de **Pandectes app**.
2. Ga naar **Integrations**.
3. Scrol naar **Microsoft Clarity** en klik op **Configure**.
![](https://storage.crisp.chat/users/helpdesk/website/-/1/a/5/a/1a5af239e847cf00/image_eszb4s.png =300x225)
1. Zet de schakelaar aan om **de integratie in te schakelen**.* *
2. *(Optioneel)* Plak je **Clarity Project ID** als je wilt dat Pandectes het Clarity-script voor je laadt. Als je dit leeg laat, moet je het script zelf in je winkel laden.

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

Zodra de integratie is ingeschakeld, zal Pandectes:
* **Gedetailleerde toestemmingssignalen versturen** (`analytics_Storage` en `ad_Storage`) op basis van de daadwerkelijke keuzes van de gebruiker.
* **Voorkomen dat Clarity-cookies worden geschreven** totdat de bijbehorende toestemming is verleend.
* **Het Clarity-script automatisch laden** (alleen wanneer een Project ID is opgegeven), zo vroeg mogelijk tijdens het laden van de pagina, zodat toestemmingssignalen nooit worden gemist.

### Slotopmerkingen

Deze integratie is volledig conform en geoptimaliseerd voor:
* Shopify-winkels die in de EU verkopen
* Handelaren onder de AVG (GDPR), CCPA en andere privacykaders
* Winkels die geautomatiseerde, gedetailleerde controle over tracking door derden willen

Raadpleeg voor meer details de officiële documentatie van Microsoft over [CMP-integratie met Clarity](https://learn.microsoft.com/en-us/clarity/setup-and-installation/cmp-integration-guide).