Dokumentationsmenu
Google Tag Manager
CookieHug-skabelonen til Google Tag Manager: installation, udløseren Consent Initialization, parametre, adfærd og skabelonens tilladelser.
Skabelon til Google Tag Manager
CookieHug udgiver en officiel brugerdefineret skabelon til Google Tag Manager, så du kan udrulle samtykkebanneret og Google Consent Mode v2 udelukkende fra GTM — helt uden snippet i <head>. Den er udgivet i GTM Community Template Gallery (søg efter *CookieHug Consent Banner*), og kildekoden ligger i et dedikeret offentligt repository: github.com/cookiehug-com/gtm-cookiehug.
Skabelonen er en let, universel loader: hvert websted indsætter sin egen licensnøgle, så den samme skabelon virker for ethvert CookieHug-domæne. Den gør præcis to ting — den sætter alle GCM v2-signaler til denied, *før* noget tag udløses, og indsætter derefter CookieHug-SDK'et, som anvender dine regionale standardværdier og kalder updateConsentState, når den besøgende handler. Hele bannerets opsætning (kategorier, tekster, farver, blokering) bliver i CookieHug-kontrolpanelet; skabelonen er en konnektor, ikke en indstillingsflade.
Hvornår du skal bruge den
Brug GTM-skabelonen i stedet for snippet'et i <head>, hvis du allerede styrer dine analyse- og annoncetags i Google Tag Manager og vil have ét sted — GTM's Consent Initialization — hvor standardværdierne sættes, før noget tag vurderer sit samtykke. Bruger du ikke GTM, så bliv ved standard-<script>-snippet'et eller WordPress-pluginnet; installer ikke begge dele, ellers sættes standardværdierne to gange.
Installation
- Fra galleriet (anbefalet): GTM → Skabeloner → Tagskabeloner → Søg i galleriet → søg efter *CookieHug Consent Banner* → Føj til arbejdsområdet.
- Manuel import (indtil visningen i galleriet er live): hent `template.tpl`, og gå derefter til GTM → Skabeloner → Tagskabeloner → Ny → ⋮ → Importér, og vælg filen.
- Opret et tag: Tags → Ny → CookieHug Consent Banner.
- Knyt det til udløseren Consent Initialization — All Pages. Det er GTM's tidligste indbyggede udløser og sikrer, at de afviste standardværdier er sat, før noget analyse- eller annoncetag kører. Brug ikke Page View / All Pages / DOM Ready.
Parametre
| Parameter | Type | Standard | Bemærkninger |
|---|---|---|---|
licenseKey | TEXT | *påkrævet* | Nøglen til dit websted i Kontrolpanel → Domæne → Indstillinger. |
region | SELECT | auto | Fremtvinger en region for standard-samtykketilstanden (EEA/GB/CH/US/US-CA/ROW). Lad den stå på auto i produktion. |
loadPosition | SELECT | async | async (hurtig, ikke-blokerende) eller defer (efter HTML-parsing). Begge sætter standardværdierne før andre tags. |
debugMode | CHECKBOX | false | Viser CookieHugs diagnostikmærke. Kun til preview- eller testcontainere — aldrig i produktion. |
Hvad skabelonen kører
1. setDefaultConsentState({ ad_storage: 'denied', ad_user_data: 'denied', ad_personalization: 'denied', analytics_storage: 'denied', functionality_storage: 'denied', personalization_storage: 'denied', security_storage: 'granted', wait_for_update: 500 }) — forhindrer markedsførings- og analysetags i at udløses, før samtykket er opdateret.
2. injectScript('https://cookiehug.com/api/script/<licenseKey>.js') — indlæser CookieHug-SDK'et, som erstatter standardværdierne med dem, der passer til regionen, viser banneret om nødvendigt og kalder updateConsentState, når brugeren klikker.
Afviser du tilladelsen inject_script i en låst container, kalder tagget pænt gtmOnFailure(): der indlæses intet banner, men efterfølgende tags forbliver blokeret, fordi standardværdierne stadig er denied.
Anmodede tilladelser
access_consent— læsning og skrivning for hvert GCM v2-signal (ad_storage,ad_user_data,ad_personalization,analytics_storage,functionality_storage,personalization_storage,security_storage).inject_script— udelukkende begrænset tilhttps://cookiehug.com/api/script/*.logging— kun i debugmiljøer.
Brug den ikke sammen med snippet'et
Både GTM-skabelonen og snippet'et i <head> sætter standardværdierne for Consent Mode. Brug præcis én integration pr. websted. Flytter du et websted fra snippet'et til GTM-skabelonen, skal du først fjerne tagget <script id="cookiehug"> fra <head> — ellers kan GTM's andet default-kald overskrive CookieHugs regionale standardværdier og ødelægge EØS-styringen.