Menu dokumentacji
Google Tag Manager
Szablon CookieHug dla Google Tag Managera: instalacja, wyzwalacz Consent Initialization, parametry, zachowanie i uprawnienia szablonu.
Szablon Google Tag Manager
CookieHug udostępnia oficjalny szablon niestandardowy Google Tag Manager, dzięki któremu wdrożysz baner zgód i Google Consent Mode v2 w całości z poziomu GTM — bez snippetu w <head>. Jest opublikowany w GTM Community Template Gallery (szukaj *CookieHug Consent Banner*), a źródło znajduje się w dedykowanym publicznym repozytorium: github.com/cookiehug-com/gtm-cookiehug.
Szablon to lekki, uniwersalny loader: każda strona wkleja własny klucz licencyjny, więc ten sam szablon działa dla każdej domeny CookieHug. Robi dokładnie dwie rzeczy — ustawia wszystkie sygnały GCM v2 na denied *zanim* odpali się jakikolwiek tag, a następnie wstrzykuje SDK CookieHug, które stosuje Twoje regionalne wartości domyślne i wywołuje updateConsentState, gdy odwiedzający podejmie decyzję. Cała konfiguracja banera (kategorie, treści, kolory, blokowanie) pozostaje w panelu CookieHug; szablon jest łącznikiem, a nie miejscem ustawień.
Kiedy go używać
Użyj szablonu GTM zamiast snippetu w <head>, gdy zarządzasz już tagami analityki/reklam przez Google Tag Manager i chcesz mieć jedno miejsce — Consent Initialization w GTM — gdzie wartości domyślne są ustawiane, zanim jakikolwiek tag sprawdzi zgodę. Jeśli nie używasz GTM, zostań przy standardowym snippecie <script> lub wtyczce WordPress; nie instaluj obu naraz, bo wartości domyślne zostaną ustawione dwukrotnie.
Instalacja
- Z galerii (zalecane): GTM → Szablony → Szablony tagów → Przeszukaj galerię → wyszukaj *CookieHug Consent Banner* → Dodaj do przestrzeni roboczej.
- Import ręczny (zanim wpis w galerii będzie aktywny): pobierz `template.tpl`, następnie GTM → Szablony → Szablony tagów → Nowy → ⋮ → Importuj i wskaż plik.
- Utwórz tag: Tagi → Nowy → CookieHug Consent Banner.
- Podepnij go pod regułę Consent Initialization — All Pages. To najwcześniejsza natywna reguła GTM i gwarantuje, że wartości
deniedzostaną ustawione przed odpaleniem tagów analityki/reklam. Nie używaj Page View / All Pages / DOM Ready.
Parametry
| Parametr | Typ | Domyślnie | Uwagi |
|---|---|---|---|
licenseKey | TEXT | *wymagany* | Klucz strony z Dashboard → Domena → Ustawienia. |
region | SELECT | auto | Wymuszenie regionu dla domyślnego stanu zgody (EEA/GB/CH/US/US-CA/ROW). W produkcji zostaw auto. |
loadPosition | SELECT | async | async (szybki, nieblokujący) lub defer (po sparsowaniu HTML). Oba ustawiają wartości domyślne przed innymi tagami. |
debugMode | CHECKBOX | false | Pokazuje diagnostyczny znaczek CookieHug. Tylko kontenery podglądu/testowe — nigdy na produkcji. |
Co uruchamia szablon
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 }) — wstrzymuje tagi marketingowe/analityczne do czasu aktualizacji zgody.
2. injectScript('https://cookiehug.com/api/script/<licenseKey>.js') — ładuje SDK CookieHug, które zastępuje wartości domyślne odpowiednimi dla regionu, pokazuje baner (jeśli trzeba) i wywołuje updateConsentState, gdy użytkownik kliknie przycisk.
Jeśli w zablokowanym kontenerze odrzucisz uprawnienie inject_script, tag wywoła gtmOnFailure() w sposób czysty: baner się nie załaduje, a tagi pozostaną zablokowane, bo wartości domyślne nadal są denied.
Wymagane uprawnienia
access_consent— odczyt + zapis dla każdego sygnału GCM v2 (ad_storage,ad_user_data,ad_personalization,analytics_storage,functionality_storage,personalization_storage,security_storage).inject_script— ograniczone wyłącznie dohttps://cookiehug.com/api/script/*.logging— tylko środowiska debug.
Nie łącz z snippetem
Szablon GTM i snippet w <head> oba ustawiają wartości domyślne Consent Mode. Używaj dokładnie jednej integracji na stronę. Jeśli migrujesz stronę ze snippetu na szablon GTM, najpierw usuń tag <script id="cookiehug"> z <head> — w przeciwnym razie drugie wywołanie wartości domyślnych z GTM może nadpisać regionalne ustawienia CookieHug i zepsuć bramkowanie EEA.