Microsoft Clarity installeren

Het installeren van Microsoft Clarity 

Voor je begint met het installeren van Microsoft Clarity, is het handig om de snelheid van je website te controleer. Hoe je dat doet, leggen we je hier uit. 

Microsoft Clarity installeren is het makkelijkst via Google Tag Manager (GTM). Hiervoor moet je wel Google Tag Manager al op je website geïnstalleerd is. Weet je niet hoe je dat moet doen? Geen zorgen, dat lees je hier. 

Voor een correcte installatie heb je een goed ingestelde cookiebanner of Consent Management Platform (CMP) nodig. Deze moet de toestemmingskeuze van de bezoeker aan Microsoft Clarity doorgeven.

1. Gebruik je een CMP met ingebouwde integratie:
   
   Verschillende CMP’s, zoals Cookiebot, kunnen de toestemmingen automatisch aan Microsoft Clarity doorgeven. Je hoeft in dit geval zelf geen Clarity Consent API in te stellen of te programmeren. Je moet Clarity Consent Mode wel inschakelen. Ga hiervoor binnen je Clarity-project naar Instellingen –> installatie en zet de cookie setting aan. Welke CMP’s dit hebben vind je hier: Cookie CMPs
   
   
2. Gebruik je een CMP zonder ingebouwde integratie?
   
   Heeft jouw CMP geen ingebouwde integratie met Microsoft Clarity? Dan moet je de juiste toestemming handmatig doorgeven met code. In dat geval heb je adstorage (marketingcookies) nodig. Dit koppel je aan de bijbehorende consenttrigger. In veel gevallen is dit cookieconsent_update, maar de naam van deze trigger verschilt per CMP. Controleer daarom altijd welke trigger jouw CMP gebruikt.

Stap 1: Account aanmaken 

Begin met het aanmaken van een account bij Microsoft Clarity. Bezoek de Clarity website en klik op de knop om je te registreren. Volg daarna de instructies om je account op te zetten. 

Stap 2: Voeg een nieuw project toe 

Eenmaal ingelogd in Clarity voeg je linksboven een nieuw project toe. Dit is je eerste stap naar het verzamelen van data over je website. 

Stap 3: Voer de naam en website-URL in 

In het scherm voor het nieuwe project voer je de naam van je project en de URL van je website in. Klik daarna op “Voeg nieuw project toe” om verder te gaan. 

Stap 4: Controleer de Consent Mode

Ga binnen je Clarity-project naar:

Instellingen → Installatie

Welke instelling je kiest, hangt af van de CMP die je gebruikt.

• Gebruik je een CMP met een ingebouwde integratie met Microsoft Clarity? Zet de cookie setting dan aan. De CMP kan de toestemming van bezoekers automatisch aan Clarity doorgeven.

• Gebruik je een CMP zonder ingebouwde integratie? Dan moet je de juiste toestemming handmatig doorgeven met code. Controleer daarom goed welke instelling nodig is voor jouw CMP en implementatie.

Stap 5: Kopieer je project-ID

Voor de installatie via Google Tag Manager heb je het project-ID van Clarity nodig. Je kunt het project-ID vinden in de URL van je Clarity-project.

Stap 5: Open Google Tag Manager 

Open vervolgens Google Tag Manager en log in. Selecteer daarna het domein waarvoor je Clarity graag wilt instellen. 

Stap 6: Voeg een nieuwe tag toe 

Binnen Google Tag Manager ga je naar “Tags” en klik je op “Nieuwe Tag” om de Microsoft Clarity trackingcode aan je website toe te voegen. 

Stap 7: Geef de tag een naam 

Geef je nieuwe tag een naam. Zorg dat dit een naam is die voor jezelf goed herkenbaar is, bijvoorbeeld: “Microsoft Clarity”. 

Stap 8: Selecteer het officiële Clarity-template

Klik op Tagconfiguratie. Kies vervolgens onder ‘Choose tag type’ voor ‘Discover more tag types in the Community Template Gallery’.

Zoek in de galerij naar Clarity en selecteer Microsoft Clarity – Official. Voeg het officiële template van Microsoft daarna toe aan je werkruimte.

Na het toevoegen wordt de officiële Clarity-template direct geopend binnen de tag die je aan het aanmaken bent.

Stap 9: Vul je project-ID in

Plak het project-ID dat je eerder hebt gekopieerd in het daarvoor bestemde veld. Controleer goed of je alleen het ID hebt ingevuld en niet de volledige URL van het project.

Stap 10: Stel de trigger en consentinstellingen in

Welke trigger en consentinstellingen je gebruikt, hangt af van jouw CMP.

• Je gebruikt een CMP met een ingebouwde integratie
  Kies onderaan de pagina voor de trigger ‘All Pages’. De Clarity-tag wordt hierdoor op iedere pagina geladen.
  Ga daarna binnen de tag naar Consent Settings en selecteer ‘No additional consent required’. De CMP geeft de toestemming van de bezoeker automatisch door aan Microsoft Clarity.

• Je gebruikt een CMP zonder ingebouwde integratie
  Koppel de Clarity-tag dan aan de bijbehorende consenttrigger. In veel gevallen is dit cookie_consent_update, maar de naam van deze trigger verschilt per CMP.
  Stel daarnaast bij Consent Settings in dat voor het activeren van de tag toestemming voor ad_storage vereist is. Controleer altijd welke consenttrigger jouw CMP gebruikt.

Stap 11: Test de installatie

Voordat je de wijzigingen publiceert, is het belangrijk om de installatie goed te testen.

Open je website in een incognitovenster en controleer via de ontwikkelaarstools welke cookies op welk moment worden geplaatst. Gebruik daarnaast de voorbeeldmodus van Google Tag Manager om te controleren wanneer de Clarity-tag wordt geactiveerd.

Test minimaal de volgende situaties:

• Je hebt nog geen keuze gemaakt in de cookiebanner;
• Je weigert alle niet-noodzakelijke cookies;
• Je accepteert alleen analytische cookies;
• Je accepteert alle cookies;
• Je past je cookievoorkeuren later weer aan.

Controleer bij iedere situatie of de Clarity-cookies pas worden geplaatst nadat de juiste toestemming is gegeven.

Bekijk in de documentatie van Microsoft Clarity welke cookies je tijdens de test moet controleren:

Stap 12: Verzend de wijzigingen

Nadat je de tag en trigger correct hebt ingesteld en het getest hebt, is het tijd om de wijzigingen te publiceren. Klik op “Verzenden” om je nieuwe configuratie live te zetten. 

Stap 13: Open Clarity 

Ga in Clarity naar de instellingen van je account. En druk op ‘ip-blocking’. 

Stap 14: Blokkeer je IP-adres 

Klik op ‘+ block IP-adres’. Vul een herkenbare naam in en voer hier je eigen IP-adres in. Zo zorg je ervoor dat als je zelf op de website zit, dit niet wordt meegerekend in de data. Hoe je je IP-adres kan vinden leggen we je hier uit.  

Stap 15: Controleer de snelheid van je website 

Als laatste stap controleer je nogmaals de snelheid van je website. Bekijk of het gebruik van Clarity niet te veel impact heeft. Is dat wel het geval? Dan kun je het misschien beter weer van je website weghalen en je website eerst optimaliseren voor een snellere laadtijd. 

En dat was hem al! Hartstikke makkelijk dus! Houd er wel rekening mee dat het twee uur kan duren voordat de eerste data zichtbaar is en je gebruik kan maken van Microsoft Clarity!