Consentl z Google Tag Manager

Szablon Google Tag Manager (import ręczny): ustawia domyślne wartości Consent Mode v2 dla regionów, a od planu Pro przekazuje każdy wybór do tagów Google.

Skrypt ładujący jako pierwszy w <head>: Zależy od metody
Pobierz: consentl-gtm-template-1.2.1.tpl · Wersja 1.2.1 · 41 KB · SHA-256

Szablon Consentl dla Google Tag Manager (GTM) zarządza Google Consent Mode v2 w Państwa witrynie:

Ustawia domyślne wartości Google Consent Mode v2 dla poszczególnych regionów, zanim uruchomi się jakikolwiek inny tag.
Ładuje baner Consentl (opcjonalnie) i przekazuje wybory odwiedzającego do Consent Mode: wybór powracającego odwiedzającego zaraz po uruchomieniu banera, a następnie każdą zmianę.

Consent Mode wymaga planu Pro lub wyższego. Szablon odczytuje z banera Państwa plan i przełącznik Google Consent Mode v2 z panelu: przekazuje wybory odwiedzającego tylko wtedy, gdy plan obejmuje Consent Mode, a przełącznik jest włączony. W planie Free nadal ustawia wartości domyślne, ale nigdy nie wysyła aktualizacji (zob. Plany).

Którą konfigurację wybrać

Konfiguracja	Wstrzymuje narzędzia śledzące spoza Google (plan Business)	Consent Mode (plan Pro)
Fragment kodu jako pierwszy w `<head>`, bez szablonu (zalecane, zob. Każda strona internetowa)	Tak, od początku strony	Ustawiane przez baner
Fragment kodu w `<head>` z `&gcm=ext` i ten szablon z odznaczonym „Load the banner”	Tak	Ustawiane przez szablon; przydatne, gdy GTM jest jedynym źródłem konfiguracji tagów
Tylko ten szablon (witryny, w których można dodać tylko GTM)	Tylko tagi dodane po załadowaniu banera	Ustawiane przez szablon

Gdy szablon ładuje baner, GTM wstrzykuje go asynchronicznie, więc narzędzia śledzące zapisane na stałe w kodzie HTML strony uruchamiają się, i są pobierane, przed nim. Tagi zarządzane w GTM nie stanowią problemu: czekają na Consent Mode.

Jedno źródło Consent Mode (`gcm=ext`)

Gdy szablon ładuje baner, dodaje gcm=ext do adresu URL banera: baner nie wysyła wtedy własnych poleceń Consent Mode i nigdy nie wstrzymuje tagów Google. Jeżeli fragment kodu również znajduje się na stronie, należy samodzielnie dodać &gcm=ext do jego adresu URL:

<script src="https://api.consentl.com/v1/loader.js?k=SITE_KEY&l=LANG&gcm=ext"></script>

Bez tego strona otrzymuje dwa zestawy wartości domyślnych, a dodatkowo obowiązują ustawienia Consent Mode banera z panelu.

Instalacja

Należy dodać szablon do kontenera:
- Community Template Gallery (po opublikowaniu): Szablony → Szablony tagów → Szukaj w galerii → „Consentl” → Dodaj do obszaru roboczego.
- Import ręczny (dostępny już teraz): należy pobrać plik szablonu ze strony Pobieranie, a następnie Szablony → Szablony tagów → Nowy → ⋮ → Importuj → wybrać plik .tpl → Zapisz.
Należy utworzyć tag: Tagi → Nowy → Konfiguracja tagu → Consentl Cookie Consent (Consent Mode v2).
- Site key: ze strony Konfiguracja witryny w panelu Consentl.
- Banner language: opcjonalnie, na przykład {{Page Language}}.
- Load the Consentl banner from this tag: należy odznaczyć, jeżeli fragment kodu już znajduje się w <head> (z &gcm=ext).
- Consent Mode defaults: jeden wiersz na grupę regionów, odzwierciedlający reguły regionów w panelu, w tym regułę dla wszystkich pozostałych regionów. Należy używać kodów ISO 3166 (stany USA zapisuje się jako US-CA). Działają też skróty EU (27 państw członkowskich), EEA (UE oraz Islandia, Liechtenstein i Norwegia) i UK (to samo co GB). Przykład: EEA, GB, CH wszystko denied oraz wiersz z pustym regionem dla reszty świata. Bez wierszy wszystko jest denied wszędzie, co jest najbezpieczniejszym wyborem.
Aktywacja: Consent Initialization – All Pages. To jedyny aktywator, który uruchamia się przed każdym innym tagiem.
W Administracja → Ustawienia kontenera należy włączyć Przegląd zgody (Consent overview) i upewnić się, że każdy tag ma właściwe wbudowane kontrole zgody lub ustawienia Dodatkowa zgoda (na przykład ad_storage dla Meta, TikTok i innych pikseli reklamowych).
Podgląd (Tag Assistant) → karta Consent: powinny być widoczne wartości domyślne przy Consent Initialization (raz) i aktualizacja po akceptacji.
Prześlij / Opublikuj.

Zdarzenia, na których można uruchamiać tagi

Zdarzenie	Kiedy
`consentl_consent`	Przy każdym wyświetleniu strony, gdy region odwiedzającego jest znany, oraz po każdym wyborze
`consentl_update`	Tylko gdy odwiedzający dokonuje wyboru lub go zmienia

Oba zawierają consentl.preferences, consentl.analytics, consentl.marketing, consentl.sale, consentl.stored (odwiedzający podjął decyzję) i consentl.region. Aby uruchomić tag po wyrażeniu zgody przez odwiedzającego, należy użyć consentl_update lub consentl_consent z warunkiem na consentl.stored.

Plany

Baner informuje szablon, czy Państwa plan obejmuje Consent Mode (Pro i wyższe) i czy włączony jest przełącznik Regions → Google Consent Mode v2 → Send consent signals to Google tags. Przy gcm=ext przełącznik nie zmienia niczego innego, więc korzystając z tego szablonu, należy pozostawić go włączonym.

Sytuacja	Co robi szablon	Co otrzymują tagi Google w kontenerze
Pro i wyższe, przełącznik włączony	Wartości domyślne, a następnie wybory odwiedzającego	Wybór odwiedzającego
Free (fragment kodu jako pierwszy lub baner ładowany przez szablon)	Państwa wartości domyślne (bez wierszy: wszystko denied), nigdy aktualizacja; konsola Tag Assistant wyświetla wskazówkę	Państwa wartości domyślne na stałe, również po akceptacji przez odwiedzającego: tam, gdzie wiersze oznaczają denied, tagi z kontrolami zgody się nie uruchamiają, a tagi Google w trybie zaawansowanym wysyłają tylko pingi bez plików cookie
Pro i wyższe, przełącznik wyłączony, fragment kodu jako pierwszy	Nic; konsola Tag Assistant wyświetla wskazówkę	Żadnego stanu zgody, chyba że samodzielnie ustawią Państwo wartości domyślne Consent Mode: tagi Google działają wtedy tak, jakby udzielono zgody, również w UE, Zjednoczonym Królestwie i Szwajcarii
Pro i wyższe, przełącznik wyłączony, baner ładowany przez szablon	Od razu wartości domyślne (stan przełącznika nie jest jeszcze znany), potem nic	Państwa wartości domyślne na stałe

W planie Free wartości domyślne są celowe: tagi Google nigdy nie działają w regionie opt-in bez stanu zgody. Aby w planie Free uruchamiać tagi po wyrażeniu zgody przez odwiedzającego, należy uruchamiać je na zdarzeniu consentl_update lub consentl_consent z warunkiem na consentl.analytics lub consentl.marketing albo przejść na plan Pro.

Gdy przełącznik jest wyłączony, a fragment kodu jest pierwszy, szablon respektuje Państwa wybór i nie wysyła żadnego polecenia Consent Mode. Tagi Google w kontenerze działają wtedy bez żadnego stanu zgody, chyba że samodzielnie ustawią Państwo wartości domyślne (własne gtag('consent', 'default', …) przed GTM lub inne narzędzie), a Google traktuje brak stanu jak zgodę. Jeżeli Consent Mode ma obsługiwać ten szablon, należy pozostawić przełącznik włączony.

Dopóki informacja o planie nie zostanie wdrożona we wszystkich banerach, witryna w planie Pro z wyłączonym przełącznikiem może nadal być traktowana jak w planie Free (wartości domyślne, bez aktualizacji).

Powracający odwiedzający i „Reset all consents”

Szablon sam nie odczytuje pliku cookie consentl. Pobiera wybór odwiedzającego z banera, który już sprawdził wersję zgody („Reset all consents” ponownie pyta wszystkich), wygaśnięcie, domniemane wybory z regionów z samą informacją lub opt-out (nie liczą się w regionach opt-in) i Global Privacy Control. Nic nie jest przyznawane, zanim nie będzie znany bieżący wybór odwiedzającego. „Wait for update” (domyślnie 500 ms) sprawia, że tagi Google czekają na baner.

Unikanie podwójnych wartości domyślnych

Gdy fragment kodu jest na stronie, należy dodać &gcm=ext do jego adresu URL.
Nie należy dodatkowo dodawać na stronie gtag('consent', 'default', …).
Baner stosuje Państwa regułę dla kraju odwiedzającego, który Consentl ustala na podstawie adresu IP (w pamięci, nic nie jest zapisywane); Google stosuje wiersze szablonu na podstawie własnej geolokalizacji. Wiersze należy dopasować do reguł: denied tam, gdzie reguła to opt-in, a wiersz z pustym regionem jak reguła dla wszystkich pozostałych regionów. Baner nie rozróżnia stanów USA: każdy odwiedzający z USA otrzymuje Państwa regułę dla całych USA lub, jeżeli jej nie ma, pierwszą regułę dla stanu USA, dlatego dla USA należy utworzyć jeden wiersz (US) z wartościami domyślnymi tej reguły.

Consentl	Consent Mode
marketing	`ad_storage`, `ad_user_data`
marketing + sale	`ad_personalization`
analytics	`analytics_storage`
preferences	`functionality_storage`, `personalization_storage`
zawsze	`security_storage` = granted

Uprawnienia wyświetlane w GTM

Uprawnienie	Powód
Dostęp do stanu zgody	Zapisuje typy zgody i `wait_for_update`
Wstrzykiwanie skryptów	`https://api.consentl.com/v1/*` (skrypt ładujący banera)
Dostęp do zmiennych globalnych	Wywołuje `Consentl.on`, `Consentl.get`, `Consentl.region`, `Consentl.stored`; odczytuje `Consentl.version`, `consentl.c.gcm.plan` (Państwa plan) i `consentl.c.gcm.on` (przełącznik Consent Mode)
Zapis w warstwie danych	`ads_data_redaction`, `url_passthrough`
Zapis w konsoli	Tylko w trybie debugowania

Sam szablon nie wysyła żadnych danych. Consentl przetwarza w Państwa imieniu, jako właściciela witryny, następujące dane:

Przy każdym wyświetleniu strony żądania do api.consentl.com o skrypt banera, jego interfejs (gdy jest wyświetlany) i ustalenie regionu. Jak każde żądanie internetowe zawierają one adres IP odwiedzającego i identyfikator klienta (user agent) przeglądarki.
Przy każdym wyborze zapis zgody jako dowód zgody: losowy identyfikator zgody (przechowywany również w pliku cookie consentl), działanie i wybory, kod regionu, jeżeli jest znany, język, wersję zgody, ścieżkę strony, nazwę hosta, sygnał Global Privacy Control oraz, podczas testu A/B, wariant banera. Consentl dodaje czas, skrócony adres IP (IPv4 /24, IPv6 /48) i identyfikator klienta (user agent).
Przy pierwszym wyświetleniu banera anonimowa liczba wyświetleń.
Zapisy zgód są przechowywane przez 425 dni (Free, Pro), 730 dni (Business) lub 1825 dni (Enterprise). Zob. politykę prywatności.

Ograniczenia

Gdy baner jest ładowany przez GTM, skrypty zapisane na stałe w kodzie strony uruchamiają się przed nim. Do ścisłego wstępnego blokowania należy umieścić fragment kodu jako pierwszy w <head>.
Szablon nie jest jeszcze opublikowany w Community Template Gallery; należy użyć importu ręcznego.
Consentl nie jest certyfikowaną przez Google platformą CMP dla IAB TCF i nie implementuje TCF.

Potrzebują Państwo pomocy? Prosimy pisać na adres support@consentl.com — odpowiadamy po angielsku w dni robocze.