Analityka i zgody cookies

• Dotyczy wersji 0.5.1
• Zaktualizowano 6.10.2026
• 7 min czytania

Ustawienia

Sekcja „Analityka i baner zgody” w zakładce WooCommerceUstawieniaDocket. Ten moduł nie ma włącznika. Działa wtedy i tylko wtedy, gdy wpiszesz identyfikator GA4 albo Meta Pixel.

Google Analytics 4

W polu „Identyfikator GA4” wpisz identyfikator pomiaru w formacie G-…. Podpowiedź przy polu prowadzi do „Administracja” → „Strumienie danych” w Google Analytics. Statystyki zbierają się dopiero po zgodzie odwiedzającego na kategorię „Statystyki”.

Meta Pixel

W polu „Identyfikator Meta Pixel” wpisz sam numer piksela. Podpowiedź przy polu wskazuje Menedżera zdarzeń w Meta Business, sekcję źródeł danych. Piksel ładuje się wyłącznie po zgodzie na kategorię „Marketing”, w obu trybach Consent Mode. Docket wysyła też PageView po zgodzie.

Search Console

W polu „Token Search Console” wpisz samą wartość atrybutu content ze znacznika weryfikacyjnego. Docket dodaje do nagłówka strony znacznik google-site-verification. Weryfikacja nie zapisuje niczego na urządzeniu, więc nie wymaga zgody i działa od razu po wpisaniu, także bez GA4 i piksela.

Consent Mode v2

Na początku nagłówka strony, przed jakimkolwiek znacznikiem, Docket ustawia stany domyślne zgody: ad_storage, ad_user_data, ad_personalization i analytics_storage na denied, a functionality_storage i security_storage na granted. Po decyzji odwiedzającego aktualizuje je: „Statystyki” sterują analytics_storage, „Marketing” trzema sygnałami reklamowymi.

Tryb podstawowy

Domyślny. Przed zgodą nie ładuje się nic: zero ciasteczek, zero połączeń z Google i Meta. Znacznik Google ładuje się po zgodzie na statystyki, piksel po zgodzie na marketing.

Tryb zaawansowany

Włączasz go polem „Tryb zaawansowany Consent Mode”. Znacznik Google ładuje się od razu, ze stanem denied. Wysyła sygnały bez ciasteczek i identyfikatorów, dzięki czemu Google może modelować konwersje. Po zgodzie przechodzi w tryb pełny. Zdarzenia e-commerce i tak wychodzą do GA4 dopiero po zgodzie na statystyki.

Baner zgody

Baner stoi na dole strony. Nie jest oknem modalnym: nie blokuje strony i nie zabiera fokusu. Ma trzy przyciski obok siebie: „Akceptuję wszystkie”, „Tylko niezbędne” i „Ustawienia”. Odmowa jest tak samo widoczna jak zgoda i zamyka baner jednym kliknięciem.

„Ustawienia” rozwijają dwie kategorie z polami wyboru: „Statystyki” i „Marketing”, oraz przycisk „Zapisz wybór”. Jeśli wskazana jest strona polityki prywatności, w opisie pojawia się odnośnik „Polityka prywatności”.

Tytuł i opis zmienisz w polach „Tytuł banera” i „Opis w banerze”. Puste pole przywraca tekst domyślny. Wygląd jest neutralny. Motyw może go nadpisać przez klasy .docket-zgody, a filtr docket_banner_css wyłącza wbudowane style.

Przycisk „Ustawienia prywatności”

Zgodę trzeba dać się wycofać równie łatwo, jak się ją wyraża. Gdy pole „Odnośnik »Ustawienia prywatności«” jest zaznaczone, w lewym dolnym rogu strony pojawia się mały przycisk „Ustawienia prywatności”. Otwiera baner z bieżącym wyborem.

Jeśli motyw ma własne miejsce, na przykład stopkę, wyłącz przycisk w rogu i wstaw shortcode:

[docket_ustawienia_prywatnosci]

W szablonie motywu możesz użyć akcji do_action( 'docket_privacy_settings_link' ). Baner otwiera też każdy element z atrybutem data-docket-zgody-otworz. Shortcode i akcja działają tylko wtedy, gdy wpisany jest identyfikator GA4 lub piksela.

Zdarzenia e-commerce

Każde zdarzenie wychodzi do GA4 tylko po zgodzie na statystyki, a do Meta tylko po zgodzie na marketing. Zdarzenie sprzed decyzji czeka w pamięci strony i wychodzi, gdy odwiedzający się zgodzi.

Identyfikatorem pozycji jest SKU, a gdy go brak, identyfikator produktu. Zakup niesie numer zamówienia, wartość, podatek, koszt wysyłki i ceny pozycji brutto. Znacznik wysłanego zakupu siedzi przy zamówieniu, nie w ciasteczku, więc odświeżenie strony podziękowania ani wejście z innej przeglądarki nie zgłosi sprzedaży drugi raz.

Gdy działa wtyczka Vetted, zakup ma dodatkowy parametr kanal o wartości b2b albo b2c. Produkty z ceną ukrytą przed gośćmi idą wtedy bez ceny, żeby pomiar nie zdradzał ceny.

Ciasteczko i zdarzenie JavaScript

Decyzję zapisuje ciasteczko docket_zgody na 365 dni. Wartość ma postać 1.a1.m0: wersja zapisu, statystyki i marketing. Gdy w przyszłości zmieni się wersja zapisu, baner zapyta jeszcze raz.

Inne skrypty mogą sprawdzić decyzję przez window.docketZgody.stan(). Funkcja zwraca { analityka, marketing } albo null, gdy decyzji jeszcze nie ma. Po decyzji dokument dostaje zdarzenie docket:zgody z decyzją w detail.

document.addEventListener( 'docket:zgody', function ( e ) {
	if ( e.detail && e.detail.marketing ) {
		// tu włącz narzędzie wymagające zgody na marketing
	}
} );

Praca z cache

Docket działa ze stronami z pamięci podręcznej serwera albo wtyczki. Baner jest zawsze w kodzie strony, a o jego widoczności decyduje przeglądarka po odczycie ciasteczka. HTML nie zależy więc od tego, kto go ogląda. Na stronach katalogu i kart produktów zdarzenia opisują tylko treść strony, bez danych koszyka i osoby.

Kiedy nie włączać

Jeśli korzystasz z innych narzędzi, które też wymagają zgody, na przykład czatu albo osadzonych filmów, i masz już baner, który nimi zarządza, zostaw ten baner. Pola GA4 i Meta Pixel w Docket zostaw wtedy puste. Dwa banery na jednej stronie to dwa różne zapisy decyzji. Token Search Console możesz wpisać niezależnie.

Od wersji 0.5.1 możesz też zostać przy swoim banerze i nadal mieć zdarzenia sprzedaży z Docketu: wtedy Docket nie pokazuje drugiego banera, tylko przekazuje zakupy i koszyk do Twojego GA4 i Meta Pixel zgodnie z decyzją z Twojego banera. To wymaga krótkiego podpięcia przez programistę (filtr docket_external_consent), opisanego w artykule dla deweloperów.

Programista może też włączyć baner Docket dla zewnętrznych narzędzi filtrem docket_ask_consent i nasłuchiwać zdarzenia docket:zgody. Opis jest w artykule dla deweloperów.

Ostatnia zmiana: 6.10.2026, wersja 0.5.1Zgłoś błąd w tej stronie