Dokumentationsmenü
Google Tag Manager
Die CookieHug-Vorlage für Google Tag Manager: Installation, der Trigger Consent Initialization, Parameter, Verhalten und Berechtigungen der Vorlage.
Google-Tag-Manager-Vorlage
CookieHug liefert eine offizielle Custom-Vorlage für Google Tag Manager, mit der Sie das Einwilligungsbanner und Google Consent Mode v2 vollständig aus GTM heraus ausrollen — ganz ohne <head>-Snippet. Sie ist in der GTM Community Template Gallery veröffentlicht (Suche nach *CookieHug Consent Banner*), der Quellcode liegt in einem eigenen öffentlichen Repository: github.com/cookiehug-com/gtm-cookiehug.
Die Vorlage ist ein schlanker, universeller Loader: Jede Website trägt ihren eigenen Lizenzschlüssel ein, dieselbe Vorlage funktioniert also für jede CookieHug-Domain. Sie erledigt genau zwei Dinge — sie setzt alle GCM-v2-Signale auf denied, *bevor* irgendein Tag feuert, und bindet anschließend das CookieHug-SDK ein, das Ihre regionsabhängigen Standardwerte anwendet und updateConsentState aufruft, sobald der Besucher entscheidet. Die gesamte Banner-Konfiguration (Kategorien, Texte, Farben, Blocking) bleibt im CookieHug-Dashboard; die Vorlage ist ein Konnektor, keine Einstellungsoberfläche.
Wann Sie sie einsetzen
Nutzen Sie die GTM-Vorlage statt des <head>-Snippets, wenn Sie Ihre Analytics- und Ads-Tags ohnehin über Google Tag Manager verwalten und einen einzigen Ort wollen — GTMs Consent Initialization —, an dem die Standardwerte gesetzt werden, bevor ein Tag seine Einwilligung auswertet. Wenn Sie GTM nicht verwenden, bleiben Sie beim <script>-Snippet oder beim WordPress-Plugin; installieren Sie nicht beides, sonst werden die Standardwerte doppelt gesetzt.
Installation
- Aus der Galerie (empfohlen): GTM → Vorlagen → Tag-Vorlagen → Galerie durchsuchen → nach *CookieHug Consent Banner* suchen → Zum Arbeitsbereich hinzufügen.
- Manueller Import (solange der Galerie-Eintrag nicht live ist): `template.tpl` herunterladen, dann GTM → Vorlagen → Tag-Vorlagen → Neu → ⋮ → Importieren und die Datei auswählen.
- Tag anlegen: Tags → Neu → CookieHug Consent Banner.
- Hängen Sie es an den Trigger Consent Initialization — All Pages. Das ist der früheste GTM-eigene Trigger und garantiert, dass die abgelehnten Standardwerte vor jedem Analytics-/Ads-Tag gesetzt sind. Verwenden Sie nicht Page View / All Pages / DOM Ready.
Parameter
| Parameter | Typ | Standard | Hinweise |
|---|---|---|---|
licenseKey | TEXT | *Pflicht* | Ihr Website-Schlüssel aus Dashboard → Domain → Einstellungen. |
region | SELECT | auto | Erzwingt eine Region für den Standard-Einwilligungsstatus (EEA/GB/CH/US/US-CA/ROW). In der Produktion auf auto lassen. |
loadPosition | SELECT | async | async (schnell, nicht blockierend) oder defer (nach dem HTML-Parsing). Beide setzen die Standardwerte vor anderen Tags. |
debugMode | CHECKBOX | false | Zeigt das Diagnose-Badge von CookieHug. Nur für Vorschau-/Test-Container — niemals in die Produktion. |
Was die Vorlage ausführt
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 }) — verhindert, dass Marketing- und Analytics-Tags feuern, bevor die Einwilligung aktualisiert ist.
2. injectScript('https://cookiehug.com/api/script/<licenseKey>.js') — lädt das CookieHug-SDK, das die Standardwerte durch die regionsgerechten ersetzt, bei Bedarf das Banner zeigt und updateConsentState aufruft, sobald der Nutzer klickt.
Wird die Berechtigung inject_script in einem streng abgesicherten Container verweigert, ruft das Tag sauber gtmOnFailure() auf: Es lädt kein Banner, nachgelagerte Tags bleiben aber blockiert, weil die Standardwerte auf denied stehen.
Angeforderte Berechtigungen
access_consent— Lesen und Schreiben für jedes GCM-v2-Signal (ad_storage,ad_user_data,ad_personalization,analytics_storage,functionality_storage,personalization_storage,security_storage).inject_script— ausschließlich beschränkt aufhttps://cookiehug.com/api/script/*.logging— nur in Debug-Umgebungen.
Nicht zusammen mit dem Snippet einsetzen
Die GTM-Vorlage und das <head>-Snippet setzen beide die Standardwerte für Consent Mode. Verwenden Sie pro Website genau eine Integration. Wenn Sie eine Website vom Snippet auf die GTM-Vorlage umstellen, entfernen Sie zuerst das Tag <script id="cookiehug"> aus dem <head> — sonst kann der zweite Default-Aufruf aus GTM die regionalen Standardwerte von CookieHug überschreiben und die EWR-Steuerung brechen.