Consentl met Google Tag Manager

Een handmatig geïmporteerd Google Tag Manager-sjabloon dat per regio de standaardwaarden van Consent Mode v2 instelt en vanaf Pro elke keuze doorgeeft.

Loader als eerste in <head>: Hangt af van de methode
Downloaden: consentl-gtm-template-1.2.1.tpl · Versie 1.2.1 · 41 KB · SHA-256

Het Consentl-sjabloon voor Google Tag Manager (GTM) beheert Google Consent Mode v2 voor uw site:

Het stelt per regio de standaardwaarden van Google Consent Mode v2 in, voordat een andere tag wordt uitgevoerd.
Het laadt de Consentl-banner (optioneel) en geeft de keuzes van de bezoeker door aan Consent Mode: de keuze van een terugkerende bezoeker zodra de banner is uitgevoerd, en daarna elke wijziging.

Consent Mode vereist het plan Pro of hoger. Het sjabloon leest uw plan en de schakelaar Google Consent Mode v2 in het dashboard uit de banner: het geeft de keuzes van de bezoeker alleen door als uw plan Consent Mode omvat en de schakelaar aan staat. Bij Free stelt het nog steeds uw standaardwaarden in, maar verstuurt het nooit een update (zie Plannen).

Welke configuratie u kiest

Configuratie	Houdt trackers die niet van Google zijn tegen (plan Business)	Consent Mode (plan Pro)
Snippet als eerste in `<head>`, geen sjabloon (aanbevolen, zie Elke website)	Ja, vanaf het begin van de pagina	Ingesteld door de banner
Snippet in `<head>` met `&gcm=ext` plus dit sjabloon met "Load the banner" uitgevinkt	Ja	Ingesteld door het sjabloon; handig als GTM uw enige bron voor tagconfiguratie is
Alleen dit sjabloon (sites waar u alleen GTM kunt toevoegen)	Alleen tags die zijn toegevoegd nadat de banner is geladen	Ingesteld door het sjabloon

Wanneer het sjabloon de banner laadt, voegt GTM hem asynchroon in, zodat trackers die vast in de HTML van de pagina staan, vóór de banner worden uitgevoerd en opgevraagd. Tags die binnen GTM worden beheerd, zijn geen probleem: ze wachten op Consent Mode.

Eén bron voor Consent Mode (`gcm=ext`)

Wanneer het sjabloon de banner laadt, voegt het gcm=ext toe aan de URL van de banner: de banner verstuurt dan geen eigen Consent Mode-opdrachten en houdt nooit Google-tags tegen. Als de snippet ook in uw pagina staat, voeg dan zelf &gcm=ext toe aan de URL ervan:

<script src="https://api.consentl.com/v1/loader.js?k=SITE_KEY&l=LANG&gcm=ext"></script>

Zonder deze parameter krijgt de pagina twee sets standaardwaarden, en gelden ook de Consent Mode-instellingen van de banner uit het dashboard.

Installeren

Voeg het sjabloon toe aan uw container:
- Community Template Gallery (zodra het is gepubliceerd): Templates → Tag Templates → Search Gallery → "Consentl" → Add to workspace.
- Handmatige import (nu beschikbaar): download het sjabloonbestand van Downloads, en daarna Templates → Tag Templates → New → ⋮ → Import → kies het .tpl-bestand → Save.
Maak de tag aan: Tags → New → Tag configuration → Consentl Cookie Consent (Consent Mode v2).
- Site key: van de pagina Installatie van uw site in het Consentl-dashboard.
- Banner language: optioneel, bijvoorbeeld {{Page Language}}.
- Load the Consentl banner from this tag: vink dit uit als de snippet al in <head> staat (met &gcm=ext).
- Consent Mode defaults: één rij per groep regio's, overeenkomstig uw regionale regels in het dashboard, inclusief de regel voor alle andere regio's. Gebruik ISO 3166-codes (Amerikaanse staten worden geschreven als US-CA). De afkortingen EU (de 27 lidstaten), EEA (de EU plus IJsland, Liechtenstein en Noorwegen) en UK (hetzelfde als GB) werken ook. Voorbeeld: EEA, GB, CH alles geweigerd, plus een rij met een lege regio voor de rest van de wereld. Zonder rijen wordt alles overal geweigerd, wat de veiligste keuze is.
Triggering: Consent Initialization – All Pages. Dit is de enige trigger die vóór elke andere tag wordt uitgevoerd.
Schakel in Admin → Container settings Consent overview in en zorg ervoor dat elke tag de juiste ingebouwde toestemmingscontroles of instellingen bij Additional consent heeft (bijvoorbeeld ad_storage voor Meta, TikTok en andere advertentiepixels).
Preview (Tag Assistant) → tabblad Consent: u zou standaardwaarden moeten zien bij Consent Initialization (één keer) en een update na het accepteren.
Submit / Publish.

Events waarop u tags kunt activeren

Event	Wanneer
`consentl_consent`	Bij elke paginaweergave zodra de regio van de bezoeker bekend is, en na elke keuze
`consentl_update`	Alleen wanneer de bezoeker een keuze maakt of wijzigt

Beide bevatten consentl.preferences, consentl.analytics, consentl.marketing, consentl.sale, consentl.stored (de bezoeker heeft een beslissing genomen) en consentl.region. Om een tag te activeren zodra de bezoeker heeft ingestemd, gebruikt u consentl_update, of consentl_consent met een voorwaarde op consentl.stored.

Plannen

De banner laat het sjabloon weten of uw plan Consent Mode omvat (Pro en hoger) en of de schakelaar Regio's en wetten → Google Consent Mode v2 → Toestemmingssignalen naar Google-tags sturen aan staat. Met gcm=ext verandert de schakelaar verder niets, dus laat hem aan staan als u dit sjabloon gebruikt.

Situatie	Wat het sjabloon doet	Wat Google-tags in uw container krijgen
Pro en hoger, schakelaar aan	Standaardwaarden, daarna de keuzes van de bezoeker	De keuze van de bezoeker
Free (snippet als eerste, of banner geladen door het sjabloon)	Uw standaardwaarden (zonder rijen: alles geweigerd), nooit een update; de console van Tag Assistant toont een hint	Definitief uw standaardwaarden, ook nadat de bezoeker accepteert: waar uw rijen weigeren, worden tags met toestemmingscontroles niet geactiveerd, en Google-tags in de geavanceerde modus versturen alleen cookieloze pings
Pro en hoger, schakelaar uit, snippet als eerste	Niets; de console van Tag Assistant toont een hint	Helemaal geen toestemmingsstatus, tenzij u zelf standaardwaarden voor Consent Mode instelt: Google-tags worden dan uitgevoerd alsof toestemming is gegeven, ook in de EU, het VK en Zwitserland
Pro en hoger, schakelaar uit, banner geladen door het sjabloon	Direct standaardwaarden (de schakelaar is dan nog niet bekend), daarna niets	Definitief uw standaardwaarden

Bij Free zijn de standaardwaarden bewust gekozen: Google-tags worden in een opt-in-regio nooit uitgevoerd zonder toestemmingsstatus. Om bij Free tags uit te voeren nadat de bezoeker heeft ingestemd, activeert u ze op het event consentl_update of consentl_consent met een voorwaarde op consentl.analytics of consentl.marketing, of stapt u over naar Pro.

Als de schakelaar uit staat en de snippet als eerste staat, respecteert het sjabloon uw keuze en verstuurt het helemaal geen Consent Mode-opdracht. Google-tags in uw container worden dan zonder enige toestemmingsstatus uitgevoerd, tenzij u de standaardwaarden zelf instelt (uw eigen gtag('consent', 'default', …) vóór GTM, of een andere tool), en Google behandelt een ontbrekende status als toegestaan. Als u voor Consent Mode op dit sjabloon vertrouwt, laat de schakelaar dan aan staan.

Zolang de planinformatie nog naar alle banners wordt uitgerold, kan een Pro-site met de schakelaar uit nog als Free worden behandeld (standaardwaarden, geen updates).

Terugkerende bezoekers en "Alle toestemmingen opnieuw instellen"

Het sjabloon leest de cookie consentl niet zelf. Het neemt de keuze van de bezoeker over van de banner, die al heeft gecontroleerd: de toestemmingsrevisie ("Alle toestemmingen opnieuw instellen" vraagt iedereen opnieuw), de vervaldatum, impliciete keuzes uit regio's met kennisgeving of opt-out (die tellen niet in opt-in-regio's) en Global Privacy Control. Er wordt niets toegestaan voordat de huidige keuze van de bezoeker bekend is. "Wait for update" (standaard 500 ms) laat Google-tags op de banner wachten.

Dubbele standaardwaarden vermijden

Als de snippet in de pagina staat, voeg dan &gcm=ext toe aan de URL ervan.
Voeg niet ook gtag('consent', 'default', …) aan de pagina toe.
De banner past uw regel toe voor het land van de bezoeker, dat Consentl uit het IP-adres afleidt (in het geheugen, niets opgeslagen); Google past de rijen van het sjabloon toe op basis van zijn eigen geolocatie. Laat de rijen overeenkomen met uw regels: geweigerd waar een regel opt-in is, en de rij met lege regio zoals uw regel voor alle andere regio's. De banner onderscheidt Amerikaanse staten niet: elke bezoeker uit de VS krijgt uw regel voor de hele VS of, als die er niet is, uw eerste regel voor een Amerikaanse staat, dus geef de VS één rij (US) met de standaardwaarden van die regel.

Consentl	Consent Mode
marketing	`ad_storage`, `ad_user_data`
marketing + verkoop	`ad_personalization`
analyse	`analytics_storage`
voorkeuren	`functionality_storage`, `personalization_storage`
altijd	`security_storage` = granted

Machtigingen die GTM toont

Machtiging	Waarom
Accesses consent state	Schrijft de toestemmingstypen en `wait_for_update`
Injects scripts	`https://api.consentl.com/v1/*` (de bannerloader)
Accesses global variables	Roept `Consentl.on`, `Consentl.get`, `Consentl.region`, `Consentl.stored` aan; leest `Consentl.version`, `consentl.c.gcm.plan` (uw plan) en `consentl.c.gcm.on` (de Consent Mode-schakelaar)
Writes to the data layer	`ads_data_redaction`, `url_passthrough`
Logs to console	Alleen in de foutopsporingsmodus

Het sjabloon zelf verstuurt geen gegevens. Consentl verwerkt het volgende voor u als eigenaar van de site:

Bij elke paginaweergave verzoeken aan api.consentl.com voor het bannerscript, de interface ervan (wanneer getoond) en het opzoeken van de regio. Zoals elk webverzoek bevatten ze het IP-adres van de bezoeker en de user agent van de browser.
Bij elke keuze een toestemmingsregistratie als bewijs van toestemming: een willekeurige toestemmings-ID (ook bewaard in de cookie consentl), de actie en keuzes, de regiocode wanneer die bekend is, de taal, de toestemmingsrevisie, het paginapad, uw hostnaam, het Global Privacy Control-signaal en, tijdens een A/B-test, de bannervariant. Consentl voegt de tijd, het ingekorte IP-adres (IPv4 /24, IPv6 /48) en de user agent toe.
Wanneer de banner voor het eerst wordt getoond, een anonieme telling van de weergave.
Toestemmingsregistraties worden 425 dagen (Free, Pro), 730 dagen (Business) of 1.825 dagen (Enterprise) bewaard. Zie de privacyverklaring.

Beperkingen

Wanneer de banner door GTM wordt geladen, worden scripts die vast in de pagina staan, vóór de banner uitgevoerd. Plaats de snippet als eerste in <head> voor strikte voorafgaande blokkering.
De vermelding in de Community Template Gallery is nog niet gepubliceerd; gebruik de handmatige import.
Consentl is geen door Google gecertificeerd CMP voor IAB TCF en implementeert TCF niet.

Vastgelopen? Schrijf naar support@consentl.com — wij antwoorden op werkdagen in het Engels.