← Integracje
Google Tag ManagerGoogle Tag Manager
dokumentacja presetuDokumentacja

Dokumentacja GTM dla CookiePilot

GTM jest warstwą wdrożenia. CookiePilot publikuje consent update, a reguły GTM powinny uruchamiać vendorów po zgodzie.

Zacznij konfiguracjęDokumentacja

Opis

GTM jest warstwą wdrożenia. CookiePilot publikuje consent update, a reguły GTM powinny uruchamiać vendorów po zgodzie.

Warstwa: instalacja i orkiestracja tagów.
Event: cookiepilot_consent_update.
Najważniejsze: stub przed innymi tagami.

GTM to warstwa orkiestracji, nie tracker

Sam kontener GTM nie zbiera danych — ale odpala tagi, które to robią. Dlatego w konfiguracji z CookiePilot najważniejsza jest kolejność: stub Consent Mode przed kontenerem, tag CookiePilot na triggerze Consent Initialization – All Pages, a default consent ustawiony na denied zanim jakikolwiek tag wystartuje.

Wybierz jedną metodę instalacji dla domeny: szablon/tag w GTM albo instalację natywną (bezpośredni skrypt lub wtyczka WordPress). Dwie metody naraz oznaczają podwójne ustawianie default consent i trudne do debugowania wyścigi.

Stub przed kontenerem GTM
Tag CookiePilot: Consent Initialization – All Pages
Jedna metoda instalacji na domenę
Pełny przewodnik: CookiePilot i Google Tag Manager

Reguły zgody dla tagów w kontenerze

Tagi Google (GA4, Ads, Floodlight) mają wbudowane consent checks — wystarczy im poprawny default i update Consent Mode. Tagom spoza ekosystemu Google (Meta, TikTok, Hotjar, Klaviyo) ustaw Custom Event Trigger na cookiepilot_consent_update z warunkiem na właściwą kategorię z obiektu cookiepilot_consent.

Event jest emitowany przy każdej decyzji użytkownika oraz — co ważne dla triggerów — przy każdej odsłonie strony u powracającego użytkownika z zapisaną zgodą. Tagi warunkowane zgodą działają więc na każdej stronie, nie tylko tam, gdzie użytkownik kliknął banner.

W trybie Preview sprawdź trzy rzeczy: tag CookiePilot odpala jako pierwszy, zakładka Consent pokazuje denied przed decyzją, a vendory startują dopiero po consent update.

Google: wbudowane consent checks
Non-Google: trigger na cookiepilot_consent_update
Preview: CookiePilot pierwszy, vendory po update

Kroki wdrożenia

  1. 1Dodaj stub przed GTM.
  2. 2Dodaj tag CookiePilot na Consent Initialization.
  3. 3Ustaw required consent przy tagach vendorów.

Checklista testowa

  • Preview pokazuje tag CookiePilot jako pierwszy.
  • Consent state startuje jako denied.
  • Vendors czekają na update zgody.

FAQ

Czy to jest porada prawna?

Nie. To techniczny przewodnik wdrożeniowy. Przy nietypowym modelu danych warto skonsultować konfigurację z prawnikiem lub inspektorem ochrony danych.

Czy CookiePilot blokuje wszystkie skrypty automatycznie?

CookiePilot ma autoblocking i Consent Mode, ale twardo wklejone trackery uruchomione przed CMP trzeba przenieść za stub albo do GTM Consent Initialization.