Menu della documentazione
Google Tag Manager
Il modello CookieHug per Google Tag Manager: installazione, attivatore Consent Initialization, parametri, comportamento e permessi del modello.
Modello per Google Tag Manager
CookieHug pubblica un modello personalizzato ufficiale per Google Tag Manager con cui puoi distribuire il banner di consenso e Google Consent Mode v2 interamente da GTM, senza lo snippet nell'<head>. È pubblicato nella galleria dei modelli della community di GTM (cerca *CookieHug Consent Banner*) e il codice sorgente vive in un repository pubblico dedicato: github.com/cookiehug-com/gtm-cookiehug.
Il modello è un loader leggero e universale: ogni sito incolla la propria chiave di licenza, quindi lo stesso modello funziona per qualsiasi dominio CookieHug. Fa esattamente due cose: porta tutti i segnali GCM v2 su denied *prima* che parta qualsiasi tag, poi inserisce l'SDK di CookieHug, che applica i tuoi valori predefiniti regionali e richiama updateConsentState quando il visitatore decide. Tutta la configurazione del banner (categorie, testi, colori, blocco) resta nella dashboard CookieHug; il modello è un connettore, non una superficie di impostazioni.
Quando usarlo
Usa il modello GTM al posto dello snippet nell'<head> se già gestisci i tag di analytics e advertising con Google Tag Manager e vuoi un unico punto — la Consent Initialization di GTM — in cui i valori predefiniti vengono impostati prima che qualsiasi tag valuti il proprio consenso. Se non usi GTM, resta con lo snippet <script> standard o con il plugin WordPress; non installare entrambi, altrimenti i valori predefiniti verranno impostati due volte.
Installazione
- Dalla galleria (consigliato): GTM → Modelli → Modelli di tag → Cerca nella galleria → cerca *CookieHug Consent Banner* → Aggiungi all'area di lavoro.
- Importazione manuale (finché la scheda in galleria non è pubblicata): scarica `template.tpl`, poi vai su GTM → Modelli → Modelli di tag → Nuovo → ⋮ → Importa e seleziona il file.
- Crea un tag: Tag → Nuovo → CookieHug Consent Banner.
- Collegalo all'attivatore Consent Initialization — All Pages. È l'attivatore nativo più precoce di GTM e garantisce che i valori predefiniti negati siano impostati prima che parta qualsiasi tag di analytics o advertising. Non usare Page View / All Pages / DOM Ready.
Parametri
| Parametro | Tipo | Predefinito | Note |
|---|---|---|---|
licenseKey | TEXT | *obbligatorio* | La chiave del tuo sito in Dashboard → Dominio → Impostazioni. |
region | SELECT | auto | Forza una regione per lo stato di consenso predefinito (EEA/GB/CH/US/US-CA/ROW). In produzione lascia su auto. |
loadPosition | SELECT | async | async (veloce, non bloccante) o defer (dopo l'analisi dell'HTML). Entrambi impostano i valori predefiniti prima degli altri tag. |
debugMode | CHECKBOX | false | Mostra il badge diagnostico di CookieHug. Solo per container di anteprima o test, mai in produzione. |
Cosa esegue il modello
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 }) — impedisce ai tag di marketing e analytics di partire prima che il consenso venga aggiornato.
2. injectScript('https://cookiehug.com/api/script/<licenseKey>.js') — carica l'SDK di CookieHug, che sostituisce i valori predefiniti con quelli adatti alla regione, mostra il banner se serve e richiama updateConsentState quando l'utente clicca.
Se rifiuti il permesso inject_script in un container blindato, il tag richiama in modo pulito gtmOnFailure(): nessun banner viene caricato, ma i tag a valle restano bloccati perché i valori predefiniti rimangono su denied.
Permessi richiesti
access_consent— lettura e scrittura per ogni segnale GCM v2 (ad_storage,ad_user_data,ad_personalization,analytics_storage,functionality_storage,personalization_storage,security_storage).inject_script— limitato esclusivamente ahttps://cookiehug.com/api/script/*.logging— solo negli ambienti di debug.
Non usarlo insieme allo snippet
Il modello GTM e lo snippet nell'<head> impostano entrambi i valori predefiniti di Consent Mode. Usa esattamente una integrazione per sito. Se migri un sito dallo snippet al modello GTM, rimuovi prima il tag <script id="cookiehug"> dall'<head>: altrimenti la seconda chiamata default di GTM può sovrascrivere i valori regionali di CookieHug e rompere il controllo per il SEE.