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 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 |
|---|---|---|
| Gebruikersgedrag, sessies, heatmaps | Performance / Analytics |
| 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 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:
- Pandectes leest de cookiekeuzes van de gebruiker.
- Voor elke geaccepteerde categorie wordt de bijbehorende Clarity-toestemming ingesteld op
"granted". - Voor elke geweigerde categorie wordt de bijbehorende toestemming ingesteld op
"denied". - 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 |
|---|---|
|
|
|
|
|
|
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.
Consent Mode inschakelen in de Clarity-instellingen
- Ga naar je Microsoft Clarity-dashboard.
- Ga naar Settings → Setup.
- Scrol omlaag en zet de optie Cookies uit.
- Clarity bevestigt dat cookies zijn uitgeschakeld totdat toestemming is ontvangen.

Controleren of toestemming goed werkt
Na het instellen van de integratie kun je controleren of Clarity de toestemmingssignalen van Pandectes correct ontvangt:
- Open je winkel in een browser en open de Developer Tools (
Ctrl+Shift+I/Cmd+Option+I). - Ga naar het tabblad Console.
- Plak de volgende code en voer die uit:
clarity('metadata', (d, upgrade, consent) => {
console.log('consentStatus:', consent);
}, false, true, true);
- Als er geen toestemming is gegeven, zie je:
{ "analytics_storage": "DENIED", "ad_storage": "DENIED" }- 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:
- Log in op je Shopify-winkel en open de Pandectes app.
- Ga naar Integrations.
- Scrol naar Microsoft Clarity en klik op Configure.

- Zet de schakelaar aan om de integratie in te schakelen.
- (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.

Zodra de integratie is ingeschakeld, zal Pandectes:
- Gedetailleerde toestemmingssignalen versturen (
analytics_Storageenad_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.
Bijgewerkt op: 19/10/2026
Dankuwel!
