Naar de hoofdinhoud

Microsoft Clarity-toestemming-API integreren

Geschreven door Alexandre Dias Da Silva

Microsoft Clarity is een krachtig hulpmiddel voor het analyseren van gebruikersgedrag. Vanwege regelgeving is het echter essentieel om de implementatie aan te passen voor conformiteit.

In december 2024 heeft Microsoft een belangrijke update over Clarity gedeeld. Vanaf begin 2025 moeten websites die Clarity gebruiken in de EER, het Verenigd Koninkrijk en Zwitserland expliciete toestemming van gebruikers verkrijgen voordat cookies worden geplaatst.

Door de onderstaande procedure te volgen, zult u:

  • Clarity configureren om standaard geen gebruikersgegevens te verzamelen.

  • extra code toevoegen om het volgen door Clarity te beheren op basis van de toestemmingskeuzes die bezoekers via uw cookiebanner uitdrukken.

Stap 0: Vereisten

Voordat u verder gaat, moet u ervoor zorgen dat Microsoft Clarity in uw Axeptio-cookiebanner staat.

Raadpleeg onze handleiding hier als dat niet het geval is: Hoe voeg ik een cookie toe aan mijn widget?

Stap 1: Cookies in Clarity uitschakelen

Standaard is het volgen van bezoekers via cookieplaatsing in Clarity ingeschakeld.

Als u cookies wilt uitschakelen, gaat u naar Instellingen > Configuratie > Geavanceerde instellingen en schakelt u Cookies uit.

Stap 2: Code toevoegen aan uw site

Ons voorbeeld hieronder stelt u in staat de keuzes die uw bezoekers in uw Axeptio-cookiebanner maken, aan de toestemmings-API van Clarity te koppelen:

<script>  void 0 === window._axcb && (window._axcb = []); // Initialisation d'Axeptio  window._axcb.push(function (axeptio) {          // Récupération des choix des cookies    axeptio.on("cookies:complete", function (choices) { // Déclenché après les choix de l'utilisateur      if (choices.clarity) {                      // Si Clarity est accepté        window.clarity('consent');               // Démarre le suivi Clarity      } else {                                   // Sinon        window.clarity('consent', false);        // Désactive le suivi      }    });  });</script>

U kunt deze code op verschillende manieren toevoegen, bijvoorbeeld:

  • hardcoded in de <head> van uw site.

  • via Google Tag Manager in een aangepaste HTML-tag: gebruik de trigger "Consent Initialization - All Pages" om te garanderen dat dit script wordt uitgevoerd voordat andere services worden gestart.

Stap 3: Testen

Volg de volgende stappen om te bevestigen dat Clarity geen cookies plaatst in de browser van uw bezoekers:

  1. Wis de cookies van uw website.

  2. Ga naar uw website.

  3. Weiger cookies via uw Axeptio-banner.

  4. Zorg ervoor dat Clarity correct is geladen (controleer de aanroepen naar /collect).

  5. Controleer de cookies in uw browser en bevestig dat er geen vermeldingen zijn voor _clck of _clsk.


Door deze stappen te volgen, voldoet uw site aan de nieuwe regelgeving en kunt u volledig gebruikmaken van de geavanceerde functies van Microsoft Clarity.

Voor meer informatie kunt u de officiële documentatie van Microsoft Clarity raadplegen:

Was dit een antwoord op uw vraag?