Menu de la documentation
Google Tag Manager
Le modèle CookieHug pour Google Tag Manager : installation, déclencheur Consent Initialization, paramètres, comportement et permissions du modèle.
Modèle Google Tag Manager
CookieHug propose un modèle personnalisé officiel pour Google Tag Manager qui permet de déployer la bannière de consentement et Google Consent Mode v2 entièrement depuis GTM — sans snippet dans le <head>. Il est publié dans la galerie de modèles de la communauté GTM (recherchez *CookieHug Consent Banner*) et son code source vit dans un dépôt public dédié : github.com/cookiehug-com/gtm-cookiehug.
Le modèle est un chargeur léger et universel : chaque site colle sa propre clé de licence, le même modèle fonctionne donc pour tous les domaines CookieHug. Il fait exactement deux choses — il règle tous les signaux GCM v2 sur denied *avant* le déclenchement de toute balise, puis injecte le SDK CookieHug, qui applique vos valeurs par défaut régionales et appelle updateConsentState dès que le visiteur agit. Toute la configuration de la bannière (catégories, textes, couleurs, blocage) reste dans le tableau de bord CookieHug ; le modèle est un connecteur, pas une surface de réglages.
Quand l'utiliser
Utilisez le modèle GTM à la place du snippet du <head> si vous gérez déjà vos balises analytics et publicitaires dans Google Tag Manager et souhaitez un point unique — la Consent Initialization de GTM — où les valeurs par défaut sont posées avant que la moindre balise n'évalue son consentement. Si vous n'utilisez pas GTM, conservez le snippet <script> standard ou l'extension WordPress ; n'installez pas les deux, sous peine de poser les valeurs par défaut deux fois.
Installation
- Depuis la galerie (recommandé) : GTM → Modèles → Modèles de balise → Parcourir la galerie → recherchez *CookieHug Consent Banner* → Ajouter à l'espace de travail.
- Import manuel (tant que la fiche de la galerie n'est pas publiée) : téléchargez `template.tpl`, puis GTM → Modèles → Modèles de balise → Nouveau → ⋮ → Importer et sélectionnez le fichier.
- Créez une balise : Balises → Nouvelle → CookieHug Consent Banner.
- Rattachez-la au déclencheur Consent Initialization — All Pages. C'est le déclencheur natif le plus précoce de GTM ; il garantit que les valeurs par défaut refusées sont posées avant l'exécution de toute balise analytics ou publicitaire. N'utilisez pas Page View / All Pages / DOM Ready.
Paramètres
| Paramètre | Type | Par défaut | Remarques |
|---|---|---|---|
licenseKey | TEXT | *obligatoire* | La clé de votre site dans Tableau de bord → Domaine → Paramètres. |
region | SELECT | auto | Force une région pour l'état de consentement par défaut (EEA/GB/CH/US/US-CA/ROW). Laissez sur auto en production. |
loadPosition | SELECT | async | async (rapide, non bloquant) ou defer (après l'analyse du HTML). Les deux posent les valeurs par défaut avant les autres balises. |
debugMode | CHECKBOX | false | Affiche le badge de diagnostic CookieHug. Conteneurs d'aperçu ou de test uniquement — jamais en production. |
Ce que le modèle exécute
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 }) — empêche les balises marketing et analytics de se déclencher avant la mise à jour du consentement.
2. injectScript('https://cookiehug.com/api/script/<licenseKey>.js') — charge le SDK CookieHug, qui remplace les valeurs par défaut par celles adaptées à la région, affiche la bannière si nécessaire et appelle updateConsentState lorsque l'utilisateur clique.
Si vous refusez la permission inject_script dans un conteneur verrouillé, la balise appelle proprement gtmOnFailure() : aucune bannière ne se charge, mais les balises en aval restent bloquées car les valeurs par défaut demeurent sur denied.
Permissions demandées
access_consent— lecture et écriture pour chaque signal GCM v2 (ad_storage,ad_user_data,ad_personalization,analytics_storage,functionality_storage,personalization_storage,security_storage).inject_script— restreint exclusivement àhttps://cookiehug.com/api/script/*.logging— environnements de debug uniquement.
Ne le cumulez pas avec le snippet
Le modèle GTM et le snippet du <head> posent tous deux les valeurs par défaut de Consent Mode. N'utilisez qu'une seule intégration par site. Si vous migrez un site du snippet vers le modèle GTM, retirez d'abord la balise <script id="cookiehug"> du <head> — sinon le second appel par défaut de GTM peut écraser les valeurs régionales de CookieHug et casser le filtrage EEE.