Cookiebanner koppelen

Toestemming uit Cookiebot, CookieYes, Complianz, OneTrust of Google Consent Mode doorgeven aan Leadspotr.

Voor het herkennen van bedrijven heb je geen cookiebanner-koppeling nodig. Het script zet zonder toestemming geen cookies en schrijft niets in de opslag van de browser.

Een koppeling is alleen nodig als je ook personen wilt herkennen: leads met naam en e-mailadres. Dat zet je per site aan met Personen identificeren bij /admin/sites.

Hoe toestemming werkt

Het principe is eenvoudig:

roep leadspotr('consent', true) aan als de bezoeker akkoord geeft;
roep leadspotr('consent', false) aan als hij zijn toestemming intrekt.

Bij true krijgt de bezoeker een eigen id in localStorage, onder de sleutels ls_consent en ls_id. Daarmee koppelen we bezoeken aan een persoon zodra die zich bekendmaakt via een formulier, de widget of identify. Bij false worden beide sleutels weer verwijderd.

De wachtrij

Je cookiebanner kan sneller zijn dan het Leadspotr-script. Zet daarom deze regel vóór het snippet. Dan worden aanroepen bewaard tot het script geladen is:

<script>window.leadspotr = window.leadspotr || function () { (window.leadspotr.q = window.leadspotr.q || []).push(arguments) };</script>
<script defer data-navigate-once src="https://t.leadspotr.nl/s.js" data-site="JOUW-SITESLEUTEL"></script>

Gebruik je de code voor Google Tag Manager? Daar zit deze regel al in.

Welke categorie?

In de voorbeelden hieronder gebruiken we steeds de categorie marketing. Deel je de opslagitems anders in, pas de categorie dan aan. Hoe je ze indeelt, bepaal je samen met je privacyadviseur. Ons advies:

ls_consent en ls_id (localStorage) onder marketing;
de widget onder functioneel. Die onthoudt alleen voor de duur van het tabblad (sessionStorage) of je de begroeting al zag en wat je in de AI-chat schreef.

Cookiebot

Cookiebot meldt bij elke pagina én bij elke wijziging CookiebotOnConsentReady:

<script>
  window.addEventListener('CookiebotOnConsentReady', function () {
    leadspotr('consent', !!(window.Cookiebot && Cookiebot.consent.marketing));
  });
</script>

Automatische blokkering. Gebruik je data-blockingmode="auto"? Zet dan data-cookieconsent="ignore" op het Leadspotr-script. Anders blokkeert Cookiebot ook de anonieme meting:

<script data-cookieconsent="ignore" defer data-navigate-once src="https://t.leadspotr.nl/s.js" data-site="JOUW-SITESLEUTEL"></script>

Declareren. De scanner van Cookiebot vindt ls_consent en ls_id pas na toestemming. Declareer ze daarom zelf:

categorie Marketing;
type HTML Local Storage;
doel: Koppelt websitebezoeken aan een contactpersoon na toestemming.

CookieYes

<script>
  document.addEventListener('cookieyes_banner_load', function (e) {
    leadspotr('consent', !!e.detail.categories.advertisement);
  });
  document.addEventListener('cookieyes_consent_update', function (e) {
    leadspotr('consent', e.detail.accepted.indexOf('advertisement') >= 0);
  });
</script>

CookieYes noemt de marketingcategorie advertisement.

Complianz (WordPress)

<script>
  document.addEventListener('cmplz_fire_categories', function (e) {
    leadspotr('consent', e.detail.categories.indexOf('marketing') >= 0);
  });
  document.addEventListener('cmplz_revoke', function () { leadspotr('consent', false); });
</script>

Plaats dit bijvoorbeeld via WPCode in de header, net als het snippet zelf.

OneTrust

OneTrust roept OptanonWrapper aan bij het laden en bij elke wijziging. Heb je die functie al? Zet de regel er dan in.

<script>
  function OptanonWrapper() {
    leadspotr('consent', (',' + (window.OnetrustActiveGroups || '') + ',').indexOf(',C0004,') >= 0);
  }
</script>

C0004 is standaard de groep Targeting. Controleer het id in je OneTrust-omgeving.

Gebruik je in Tag Manager een cookiebanner-template die Consent Mode v2 zet? Dan kun je de toestemming laten volgen zonder eigen JavaScript:

Laat de tag Leadspotr staan zoals beschreven in Google Tag Manager, zonder extra toestemming.
Maak een tweede tag Leadspotr – toestemming (Aangepaste HTML) met:
```
<script>leadspotr('consent', true);</script>
```
Kies bij Toestemmingsinstellingen → Extra toestemming vereist voor ad_storage en ad_user_data.
Gebruik als trigger All Pages, plus het event dat je banner pusht bij een wijziging. Bijvoorbeeld cookie_consent_update (CookieYes) of cookie_consent_marketing (Cookiebot).
Voor intrekken maak je een derde tag met leadspotr('consent', false) op hetzelfde event, met een uitzondering als ad_storage verleend is. Je kunt hiervoor ook het JavaScript-stukje van je banner hierboven gebruiken.

Andere cookiebanners

Elke cookiebanner heeft een manier om JavaScript uit te voeren na een keuze: een event, een callback of een plek voor scripts per categorie. Roep daar leadspotr('consent', true) of leadspotr('consent', false) aan. Zet bij een banner met scripts per categorie alleen de toestemmingsaanroep in de categorie marketing, niet het Leadspotr-snippet zelf. Anders verlies je de anonieme bedrijfsherkenning bij bezoekers die weigeren.

Testen

Open je site in een privévenster.
Geef akkoord in je cookiebanner.
Open de console van je browser (F12) en typ:
```
localStorage.ls_consent
```
Je moet "1" zien.
Trek je toestemming in via de banner en controleer opnieuw. De waarde moet nu leeg (undefined) zijn.

Werkt het niet? Kijk dan in de console of er een foutmelding staat. Een veelvoorkomende oorzaak is dat het stukje van de banner vóór de wachtrijregel staat. Dan bestaat leadspotr nog niet.

Let op: browsers met Global Privacy Control worden helemaal niet gemeten, ook niet anoniem. Test daarom niet met Brave of met GPC aan.