Menu dokumentacji

Konfiguracja usług Google

Konfiguracja po stronie Google dla Consent Mode v2: GA4, Google Ads, GTM i weryfikacja end-to-end razem z CookieHug.

Google CMP Partner — wymagania dla bannera (Sprint 5)

CookieHug został zaprojektowany tak, aby spełniać wymagania programu Google CMP Partner. Ta sekcja mapuje każdy wymóg Google na funkcjonalność, która go realizuje — klienci aplikujący o certyfikację mogą wskazać konkretną implementację. Referencja: Google Consent Mode v2 advanced — developers.google.com/tag-platform/security/guides/consent?consentmode=advanced.

Wymóg 1 — Banner w pełni konfigurowalny z GUI

Cały banner konfiguruje się bez dotykania kodu. Panel admina (Domain detail) udostępnia każdą właściwość bannera przez kontrolki GUI — żadne pole nie wymaga kodu, plików konfiguracyjnych ani wywołań API.

Zakładka / sekcja GUI	Kontrolki
Teksty bannera	Nagłówek, opis, small text, etykiety przycisków (akceptuj/odrzuć/akceptuj wybrane), link kategorii
Layout	Pozycja (left/right/bottom-center/center), zaokrąglenia, wyrównanie tekstu, Google Font, opcjonalna ikona cookie (emoji/SVG), umiejscowienie przycisku kategorii
Kolory	Tło bannera, nagłówek, opis, linki, small text, przyciski accept/reject/kategorii (bg/text/hover/border)
Kategorie	Włączanie/wyłączanie 4 kategorii, etykiety i opisy per kategoria, inwentarz cookies
Google Consent Mode	Toggle Ads/GA4/outside-CMP, 4 defaulty sygnałów GCM v2, regionalne defaulty (EEA/US-CA/ROW/custom), mapowanie kategoria→sygnał, toggle szablonu CMP
Polityka zgody	Model zgody (opt-in / opt-out / notice-only), obsługa GPC / DNT, adapter USP (US Privacy), widok post-consent
Diagnostyka	Aktywacja Debug Mode, przyjmowanie raportów diagnostycznych od klienta

Wymóg 2 — Szablon bannera spełniający wymagania Google

CookieHug dostarcza szablon bannera zgodny z Google CMP, który klient włącza jednym switchem: Domain detail → Google Consent Mode → Certyfikacja Google CMP → toggle ON. Po włączeniu banner spełnia wszystkie trzy pod-wymagania:

(a) Cel zbierania danych. Domyślny opis informuje, że cookies są używane do personalizacji treści i analizy ruchu. Klient może rozszerzyć tekst z GUI — pole jest dowolne, więc można dodać cele specyficzne dla produktu (np. "do mierzenia skuteczności reklam przez Google"). Rozwijane karty kategorii (link Dostosuj preferencje cookie) wymieniają granularne cele per kategoria.

(b) Link do https://business.safety.google/privacy. Renderowany inline w bannerze jako <a> bezpośrednio pod paragrafem opisu. Widoczny w pierwszym widoku bannera — użytkownik nie musi przechodzić na inną stronę. Używa target="_blank" rel="noopener noreferrer".

(c) Affirmative consent. Banner zawsze renderuje dedykowany przycisk Zaakceptuj wszystkie / Accept all jako jawny, niezaznaczony domyślnie opt-in. Wszystkie sygnały GCM v2 startują jako "denied" i przełączają się na "granted" dopiero po kliknięciu akceptacji — bez pre-check, bez domniemanej zgody przez scroll, a przycisk odrzucenia ma równą wagę wizualną w każdym presecie.

Wymóg 3 — Rekomendacja szablonu w UI

Gdy klient włącza Google Consent Mode (toggle Google Ads podłączone lub Google Analytics 4 podłączone), a szablon CMP nie jest jeszcze aktywny, admin UI wyświetla inline-owe zalecenie na górze sekcji Google Consent Mode:

> Zalecenie: włącz szablon Google CMP > Masz aktywny Consent Mode v2, ale banner nie zawiera wymaganego linku do polityki prywatności Google. Włącz szablon CMP, aby banner spełniał wymagania certyfikacji Google CMP Partner. > [Włącz szablon] • [Dokumentacja Consent Mode Google]

Zalecenie zawiera przycisk włączający szablon jednym kliknięciem oraz link do Google Consent Mode advanced guide. Znika automatycznie po włączeniu szablonu. CookieHug nie obsługuje IAB TCF — to zalecenie dotyczy zatem wszystkich wdrożeń Consent Mode na platformie.

Konfiguracja po stronie Google — wprowadzenie

CookieHug sam wysyła gtag('consent','default', …) i gtag('consent','update', …) — skrypt wklejony do <head> emituje oba wywołania. Po stronie Google musisz skonfigurować jeszcze trzy rzeczy, aby Consent Mode v2 (advanced) działał end-to-end. Pełna referencja: developers.google.com/tag-platform/security/guides/consent?consentmode=advanced.

Krok 1 — usługa Google Analytics 4 (GA4)

Otwórz GA4 → Administracja → Gromadzenie i modyfikacja danych → Gromadzenie danych.
W karcie Tryb uzyskiwania zgody potwierdź, że Consent Mode jest włączony. Nie ma osobnego przełącznika "advanced" — tryb zaawansowany wynika z poziomu tagu, tzn. z tego, że ad_storage i analytics_storage są ustawione na denied zanim tag się uruchomi (CookieHug to robi).
Zostaw Sygnały Google i Sygnały personalizacji reklam skonfigurowane zgodnie z polityką zgody — honorują sygnały ad_user_data i ad_personalization, które CookieHug mapuje z kategorii Marketing.
Po 24–48 h od pierwszych akceptacji bannera otwórz Administracja → Ustawienia usługi → Diagnostyka trybu uzyskiwania zgody (panel Google). Powinien wskazywać wykryty tryb zaawansowany i zdrowy stosunek consent_update do consent_default.

Krok 2 — konto Google Ads

W Google Ads → Narzędzia → Menedżer danych → Ustawienia zgody (lub Administracja → Zgoda w nowym UI): włącz Consent Mode dla konta.
Dla każdej akcji konwersji Google zacznie stosować modelowanie behawioralne, gdy konto zgromadzi wystarczająco dużo ruchu ze zgodą (zwykle 1000+ kliknięć reklamy w 7 dni na kraj). Do momentu przekroczenia progu diagnostyka może pokazywać "Consent Mode nie w pełni aktywny" — to próg po stronie Google, nie błąd konfiguracji CookieHug.
Zweryfikuj w Narzędzia → Konwersje → Diagnostyka. Liczniki redacted_data oraz consent_default/consent_update powinny być > 0.

Krok 3 — Google Tag Manager (GTM)

Uwaga: nie dodawaj tagu "Consent Initialization — All Pages", który ponownie wywoła gtag('consent','default', …). Snippet CookieHug uruchamia się *przed* GTM (dzięki priorytetowi <head>), więc domyślne wartości są już ustawione. Drugie wywołanie default z GTM nadpisze regionalne domyślne wartości CookieHug i zepsuje gating EOG.

W GTM ładuj tagi (GA4, Ads, Floodlight itp.) normalnie — odczytają stan zgody, który CookieHug już wysłał.
Dla każdego tagu, który ma respektować Consent Mode, otwórz Ustawienia zaawansowane → Ustawienia zgody i dodaj wymagane typy zgody (np. ad_storage, analytics_storage). GTM zablokuje wtedy zapisy cookie/piksela, gdy sygnał jest denied, i uruchomi tag w trybie redakcji pod advanced mode.
Jeśli używasz bezpośrednio Google tag (gtag.js) (bez GTM) — nic dodatkowo nie trzeba, snippet CookieHug uruchamia się przed loaderem gtag.

Krok 4 — weryfikacja end-to-end

Zainstaluj Google Tag Assistant (rozszerzenie Chrome) → włącz → przeładuj domenę w świeżym profilu. W zakładce Summary zobaczysz dwa zdarzenia consent: jedno default (przed akceptacją bannera) z analytics_storage=denied / ad_storage=denied, i jedno update (po akceptacji) z sygnałami przełączonymi na granted.
Otwórz GA4 → Administracja → DebugView. Przy wyłączonym Debug Mode CookieHug na produkcji użyj URL-a ?gtm_debug=1 lub włącz Debug Mode w GTM Preview, aby zobaczyć stan zgody na każdym zdarzeniu.
W Google Ads w zakładce Diagnostyka odczekaj do 24 h i potwierdź, że znacznik Status Consent Mode zmienił się na zielony.

Jak zweryfikować wdrożony banner

Włącz szablon w admin GUI.
(Re)generuj skrypt domeny z dialogu Get Script — nowy HTML bannera zacznie obowiązywać od następnego załadowania strony.
Otwórz docelową domenę i banner. Powinieneś zobaczyć nagłówek, opis, inline link *Dowiedz się, jak Google chroni Twoje dane* wskazujący na https://business.safety.google/privacy oraz przyciski *Zaakceptuj wszystkie / Odrzuć wszystkie* o równej widoczności.
Otwórz DevTools → Network → filtr google. Przed akceptacją tagi GA/Ads powinny się wywoływać z consent denied; po kliknięciu akceptacji zobaczysz gtag('consent','update') przełączające cztery sygnały na granted według mapowania kategorii.