Menu dokumentacji

Consent Mode v2

Google Consent Mode v2 w CookieHug: jak działa, tryb basic vs advanced, mapowanie kategorii na sygnały, regionalne defaulty i diagnostyka.

Google Consent Mode v2

CookieHug automatycznie integruje się z Google Consent Mode v2. Nie jest wymagana dodatkowa konfiguracja.

Czym Consent Mode jest (a czym nie). Consent Mode to mechanizm Google sygnalizujący tagom Google, jak mają się zachować na podstawie wyborów użytkownika — techniczna warstwa sygnalizacji między Twoim banerem zgody a produktami Google. Nie jest to rozwiązanie zapewniające zgodność prawną/regulacyjną i sam w sobie nie ma na celu spełnienia żadnej konkretnej regulacji o prywatności. Spełnienie wymogów danego prawa jest odpowiedzialnością właściciela strony i jego polityki zgód; Consent Mode jedynie przekazuje wynikowe sygnały.

Jak to działa

Przy ładowaniu strony — CookieHug wysyła komendę gtag('consent', 'default', ...) odmawiającą wszystkich typów zgody dla krajów EOG, z wait_for_update: 2000 (2 sekundy na załadowanie bannera zanim tagi Google odpalą z domyślnym stanem odmowy)
Po zgodzie użytkownika — CookieHug wysyła gtag('consent', 'update', ...) z wyborami użytkownika
Przy ponownych wizytach — zapisana zgoda jest przywracana automatycznie

Konfiguracja basic vs advanced

Consent Mode można wdrożyć w dwóch konfiguracjach. Różnica polega na tym, czy tagi Google są blokowane przed uzyskaniem zgody. CookieHug obsługuje obie z poziomu GUI.

	Basic	Advanced (domyślne w CookieHug)
Tag Google ładuje się przed zgodą?	Nie — tag zablokowany do czasu zgody	Tak — tag ładuje się natychmiast
Przed zgodą	Nic się nie ładuje, brak pingów	Tag działa z sygnałami `denied`, wysyła bezciasteczkowe pingi
Po zgodzie	Tag jest odblokowywany i ładowany	`gtag('consent','update')` przełącza sygnały; działa modelowanie
Odzysk danych / modelowanie	Brak przed zgodą	Modelowanie konwersji i zachowań z pingów `denied`

Advanced (domyślne): zostaw Consent Mode włączony i nie blokuj tagu Google blokerem skryptów CookieHug — tag ładuje się na każdej stronie, a gtag('consent','default', denied) (wysyłane przez CookieHug przed tagiem) utrzymuje go w trybie prywatnym do czasu decyzji użytkownika. To konfiguracja opisana w zaawansowanym przewodniku Google. Basic: pozwól CookieHug zablokować tag Google do czasu zgody — albo zostaw data-cookiehug-blockingmode="auto" (tag pasuje do wzorca trackingowego i jest wstrzymywany), albo oznacz go jawnie data-cookiehug-consent, aby wykonał się dopiero po akceptacji. Przed zgodą nie odpala się żaden tag ani ping.

Mapowanie kategorii

Kategoria CookieHug	Parametry Google Consent Mode
Niezbędne	`security_storage: 'granted'` (zawsze)
Statystyki	`analytics_storage`
Marketing	`ad_storage`, `ad_user_data`, `ad_personalization`
Preferencje	`functionality_storage`, `personalization_storage`

Dodatkowe funkcje GCM

CookieHug automatycznie włącza:

Przekazywanie URL (url_passthrough: true) — zachowuje informacje o kliknięciu reklamy w URL-ach
Redakcja danych reklamowych (ads_data_redaction: true) — redaguje dane reklamowe gdy zgoda jest odmówiona

Wyłączanie Google Consent Mode

Jeśli zarządzasz Google Consent Mode osobno, możesz wyłączyć integrację GCM w CookieHug:

<script
  data-cookiehug-consentmode="disabled"
  src="https://cookiehug.com/api/script/TWÓJ-KLUCZ-LICENCYJNY.js">
</script>

Regionalne defaulty i precedencja (Sprint 1)

Każda domena może skonfigurować domyślne wartości czterech sygnałów Google (ad_storage, ad_user_data, ad_personalization, analytics_storage) per region. Region jest wykrywany z nagłówków CF-IPCountry / CF-Region-Code (Cloudflare). Precedencja: dokładne dopasowanie (np. US-CA) → region nadrzędny (US) → fallback ROW → globalne defaults. Konfiguracja w Domain detail → zakładka Google Consent Mode.

Zmiana znaczenia sygnałów Google

Wyłączenie sygnału w categoryMapping nie powoduje, że Google przestaje otrzymywać ruch — ustawia sygnał na "denied", co Google honoruje przełączając produkt w tryb prywatności (modeled conversions, cookieless pings). Aby całkowicie wyłączyć produkt Google, usuń tag ze strony — CookieHug zarządza tylko stanem zgody, nie obecnością tagów.

Panel Diagnostyka

Domain detail → zakładka Diagnostyka uruchamia auto-checklistę (default przed tagami, update po decyzji, dopasowanie regionu, końcowe ad/analytics storage, mapowanie Ads/GA4) dla dowolnej kombinacji symulowanego regionu + symulowanej akcji użytkownika.