Kukisy.pl

Integracje

Dla WordPressa i PrestaShop generujemy gotową wtyczkę z wpisanym identyfikatorem. Dla platform SaaS mamy instrukcje krok po kroku z informacją, jak wyłączyć wbudowany pasek cookies, żeby nie dublować komunikatów.

Platformy sklepowe

WooCommerce

Ta sama wtyczka co dla WordPressa, plus obsługa integracji sklepowych.

łatwa3 minutywtyczka
  1. 1.Pobierz wtyczkę w panelu Kukisy.pl (Witryny → Twoja witryna → Instalacja) i zainstaluj ją przez Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer, a następnie włącz.
  2. 2.Cookies koszyka WooCommerce (woocommerce_cart_hash, woocommerce_items_in_cart, wp_woocommerce_session_*) są w bazie cookies Kukisy.pl jako niezbędne; po pierwszym skanie pojawią się na liście witryny z opisem.
  3. 3.Integracje Google Listings & Ads i WooCommerce Google Analytics ładują tagi Google, które uwzględniają Consent Mode. Pinterest for WooCommerce i Facebook for WooCommerce są blokowane automatycznie, jeśli ich skrypty są w bazie trackerów i ładują się po skrypcie Kukisy.pl. Kolejność sprawdzisz tak samo jak w instrukcji dla WordPressa (pierwszy <script> w <head>).
  4. 4.Dodaj do stopki link do ustawień zgód: shortcode [kukisy_ustawienia] lub link do #kukisy.
  5. 5.Regulamin sklepu, politykę prywatności i politykę cookies opublikuj na własnej domenie stronami z shortcode [kukisy_dokument typ="regulamin"], [kukisy_dokument typ="polityka-prywatnosci"], [kukisy_dokument typ="polityka-cookies"]; w WooCommerce wskaż stronę regulaminu w WooCommerce → Ustawienia → Zaawansowane, a adresy polityk wpisz w panelu Kukisy.pl (Baner → Linki w banerze).
  6. 6.Wyczyść cache sklepu i sprawdź stronę w trybie incognito: baner powinien pojawić się przed załadowaniem pikseli.

Wyłącz inne wtyczki cookie oraz opcję „Pasek informacji o cookies” w ustawieniach motywu, jeśli motyw taką ma (np. Flatsome, Astra, Woodmart).

  • •Edrone, SALESmanago, Synerise, GetResponse, Smartsupp i Tidio dla WooCommerce są w bazie trackerów i będą blokowane do czasu zgody odpowiedniej kategorii, o ile ładują się po skrypcie Kukisy.pl.
  • •Śledzenie serwerowe: Kukisy.pl blokuje tylko kod wykonywany w przeglądarce. Zdarzenia wysyłane z serwera sklepu (Meta Conversions API we wtyczce Facebook for WooCommerce lub PixelYourSite Pro, Pinterest API for Conversions w Pinterest for WooCommerce) omijają baner. Uzależnij je od zgody w ustawieniach wtyczki – szukaj opcji typu „wymagaj zgody”, „integracja z CMP / consent” albo „GDPR / zgoda na śledzenie” (PixelYourSite: zakładka Consent; Facebook for WooCommerce: ustawienia Conversions API) – albo wyłącz wysyłkę serwerową.

Shoper

Wklejenie kodu w ustawieniach stylu. Wyłącz wbudowany pasek cookies.

łatwa5 minut
  1. 1.Skopiuj kod <script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>.
  2. 2.W panelu Shoper przejdź do Wygląd i treści → Wygląd sklepu → Obecny szablon. Szablony Storefront (nowe, RWD): otwórz ustawienia szablonu i sekcję z własnym kodem (Zaawansowane → Własny kod / Nagłówek (HEAD)). Starsze szablony: Edytuj styl → Kod HTML/JS. Nazwy zakładek zależą od wersji panelu.
  3. 3.Wklej kod w polu dla sekcji HEAD, jako pierwszy, przed innymi skryptami (np. Google Tag Manager, piksel Meta). Zapisz zmiany i sprawdź w źródle strony (Ctrl+U), że znacznik Kukisy.pl jest pierwszym <script> w <head>; w szablonach Storefront Shoper może wstawiać własne skrypty wyżej.
  4. 4.Jeśli korzystasz z integracji Shopera z Google Analytics lub Google Ads, zostaw je włączone: Kukisy.pl ustawia Consent Mode, a tagi Google uwzględniają ten sygnał, o ile kod Kukisy.pl ładuje się przed nimi. Sprawdź to skanem w panelu Kukisy.pl.
  5. 5.Do stopki lub menu dodaj link Ustawienia cookies prowadzący do adresu #kukisy (Wygląd i treści → Linki / Stopka).

Wyłącz natywny baner Shopera: w zależności od wersji panelu w Konfiguracja → Regulaminy i zgody albo Ustawienia → Pliki cookies (starsze panele: Konfiguracja → Sklep → Pliki cookies / RODO), żeby nie wyświetlały się dwa banery.

  • •Ograniczenie: jeśli sklep korzysta z natywnych zgód Shopera do sterowania integracjami (np. przekazywanie zgody do Google), decyzje z baneru Kukisy.pl nie są do nich synchronizowane. Tagi Google integracji Shopera uwzględniają Consent Mode ustawiany przez Kukisy.pl; pozostałe integracje sterowane natywnymi zgodami Shopera trzeba wyłączyć albo oznaczyć ręcznie. Zweryfikuj skanem.
  • •Cookies Shopera (shop_*, sesja koszyka, język, waluta) są w naszej bazie jako niezbędne lub funkcjonalne.
  • •Aplikacje z Shoper App Store (Ceneo Zaufane Opinie, Edrone, Smartsupp, GetResponse) wstrzykują własne skrypty; auto-blokowanie obejmuje te, których adresy są w bazie trackerów i które ładują się po skrypcie Kukisy.pl. Pozostałe wykaże skan.

IdoSell

Własny kod w sekcji HEAD szablonu. IdoSell ma natywny tryb zgód, który trzeba wyłączyć.

średnia10 minut
  1. 1.Skopiuj kod <script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>.
  2. 2.W panelu IdoSell przejdź do Moderacja → Własne skrypty JavaScript i CSS (w starszych panelach: Marketing i integracje → Integracje → Kody HTML/JS).
  3. 3.Dodaj nowy skrypt w sekcji HEAD, z zakresem „Wszystkie strony”, i wklej kod. Ustaw najwyższy priorytet, aby ładował się przed innymi integracjami, i po zapisaniu sprawdź w źródle strony (Ctrl+U), że jest pierwszym <script> w <head>.
  4. 4.Zapisz i opublikuj zmiany szablonu, jeśli IdoSell tego wymaga.
  5. 5.Dodaj link Ustawienia cookies do stopki (Moderacja → Stopka / Linki), kierujący do #kukisy.

Wyłącz wbudowany komunikat o cookies: Administracja → Konfiguracja → Pliki cookies i RODO – ustaw „nie wyświetlaj komunikatu” lub tryb zgodny z zewnętrznym narzędziem. Jeżeli IdoSell w Twojej wersji wymusza własny baner, wybierz wariant „zgoda zarządzana zewnętrznie”.

  • •Cookies IdoSell (client, basket_id, iai_*) są rozpoznawane automatycznie.
  • •IdoSell potrafi sam przekazywać zgodę do Google. Skorzystaj tylko z jednego źródła sygnału Consent Mode: zostaw Kukisy.pl, wyłącz natywny.

PrestaShop

Moduł wygenerowany dla tej witryny, instalowany przez panel administracyjny.

łatwa3 minutywtyczka
  1. 1.Pobierz moduł w panelu Kukisy.pl: Witryny → Twoja witryna → Instalacja (przycisk „Pobierz moduł…”). Pakiet ma już wpisany identyfikator tej witryny.
  2. 2.W panelu PrestaShop przejdź do Moduły → Menedżer modułów → Wgraj moduł i wskaż pobrany plik .zip. Moduł zainstaluje się automatycznie.
  3. 3.Moduł podpina się do hooka displayHeader, przy instalacji ustawia się w nim na pierwszej pozycji i wstawia znacznik <script> możliwie wcześnie w sekcji <head>. Nie jest to jednak gwarancja pierwszeństwa: motyw może wstawiać własne skrypty przed wywołaniem hooka, a inne moduły mogą zmienić kolejność.
  4. 4.Po instalacji sprawdź sklep w trybie incognito albo uruchom skan w panelu Kukisy.pl. Jeśli jakieś narzędzie (np. GTM, piksel Meta) uruchamia się przed zgodą: (1) w Moduły → Pozycje (w starszych wersjach Projekt → Pozycje) wybierz hook displayHeader i przesuń Kukisy.pl na pierwsze miejsce; (2) jeśli to nie wystarczy, wklej znacznik ręcznie jako pierwszy element <head> w pliku themes/<motyw>/templates/_partials/head.tpl i w Pozycjach odepnij moduł od displayHeader, żeby nie dublować skryptu.
  5. 5.Dodaj link Ustawienia cookies do stopki: Projekt → Strony/Linki, adres #kukisy. Moduł udostępnia też hook displayFooter z gotowym linkiem (możesz go włączyć w konfiguracji modułu).
  6. 6.Wyczyść cache: Zaawansowane → Wydajność → Wyczyść cache.

Odinstaluj moduły typu „Cookie banner” / „RGPD Cookie” dostarczane z motywem albo z Addons, żeby nie dublować komunikatów.

  • •Cookie sesji PrestaShop (PrestaShop-#) oraz PHPSESSID są klasyfikowane jako niezbędne.
  • •Znacznik wstawiony w head.tpl trzeba przenieść po aktualizacji motywu; pamiętaj o tym przy zmianie wersji szablonu.

Sky-Shop

Własny kod w nagłówku sklepu.

łatwa5 minut
  1. 1.Skopiuj kod <script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>.
  2. 2.W panelu Sky-Shop przejdź do Ustawienia → Wygląd → Własne kody (HTML / JavaScript) i wklej kod w polu dla sekcji HEAD, na samej górze.
  3. 3.Zapisz. Jeśli sklep używa cache, odśwież je w ustawieniach.
  4. 4.Dodaj link Ustawienia cookies do stopki, kierujący do #kukisy.

W Ustawienia → Sklep → Komunikat o cookies wyłącz wbudowany pasek.

Shopify

Kod w theme.liquid. Kukisy.pl przekazuje zgodę do natywnego API prywatności Shopify.

średnia10 minut
  1. 1.Skopiuj kod <script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>.
  2. 2.W panelu Shopify przejdź do Sklep online → Motywy → ⋯ → Edytuj kod, otwórz plik layout/theme.liquid.
  3. 3.Wklej kod bezpośrednio po otwierającym tagu <head>, przed {{ content_for_header }}. Zapisz.
  4. 4.W Ustawienia → Prywatność klientów → Zbieranie zgody na pliki cookie ustaw region (Unia Europejska) i opcję „Wymagaj zgody”. Po każdej decyzji użytkownika Kukisy.pl przekazuje ją do Shopify Customer Privacy API (Shopify.customerPrivacy.setTrackingConsent: analytics, marketing, preferences, sale_of_data). Czy dana aplikacja lub piksel uwzględni ten sygnał, zależy od tej aplikacji: sprawdź jej dokumentację.
  5. 5.Piksele niestandardowe (Ustawienia → Zdarzenia klientów) skonfiguruj tak, aby wymagały zgody (uprawnienia: marketing / analityka), wtedy Shopify uruchomi je dopiero po sygnale zgody. Skrypty wklejone bezpośrednio w theme.liquid poniżej kodu Kukisy.pl są blokowane przez auto-blokowanie, jeśli ich adresy są w bazie trackerów; pozostałe oznacz ręcznie (type="text/plain" data-zg-category="…").
  6. 6.Dodaj do stopki link Ustawienia cookies prowadzący do #kukisy.

Nie włączaj baneru cookie wbudowanego w motyw ani aplikacji typu „Cookie Banner”. Ustawienie „Wymagaj zgody” w prywatności klientów zostaw włączone: dzięki niemu Shopify wstrzymuje własne śledzenie i piksele wymagające zgody do czasu sygnału z Kukisy.pl.

Sellingo

Własny kod w sekcji HEAD w ustawieniach wyglądu.

łatwa5 minut
  1. 1.Skopiuj kod <script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>.
  2. 2.W panelu przejdź do Wygląd → Własne kody → Sekcja HEAD, wklej kod na górze i zapisz.
  3. 3.Dodaj link Ustawienia cookies do stopki, adres #kukisy.

Wyłącz wbudowany komunikat cookies w ustawieniach sklepu.

RedCart

Własny kod w nagłówku szablonu.

łatwa5 minut
  1. 1.Skopiuj kod <script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>.
  2. 2.W panelu przejdź do Konfiguracja → Wygląd → Edycja szablonu → Nagłówek (HEAD), wklej kod jako pierwszy i zapisz.
  3. 3.Dodaj link Ustawienia cookies do stopki, adres #kukisy.

Wyłącz wbudowany komunikat cookies w ustawieniach sklepu.

Magento / Adobe Commerce

Pole „HTML Head → Scripts and Style Sheets” w konfiguracji projektu.

średnia10 minut
  1. 1.Skopiuj kod <script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>.
  2. 2.Przejdź do Content → Design → Configuration, edytuj widok sklepu, rozwiń HTML Head i wklej kod w Scripts and Style Sheets. Zapisz i wyczyść cache.
  3. 3.Dodaj link Ustawienia cookies w stopce do #kukisy.

Wyłącz Cookie Restriction Mode w Stores → Configuration → General → Web → Default Cookie Settings, żeby nie wyświetlać drugiego komunikatu. Wyjątek: jeśli używasz Product Recommendations / Adobe Sensei, które polegają na tym trybie, zostaw go włączony, a Kukisy.pl traktuj jako warstwę blokującą wyłącznie skrypty zewnętrzne (piksele, analityka); decyzje z baneru Kukisy.pl nie są przekazywane do Cookie Restriction Mode.

Systemy CMS i kreatory

WordPress

Wtyczka z wbudowanym identyfikatorem witryny. Instalacja zajmuje kilka minut.

łatwa2 minutywtyczka
  1. 1.Pobierz wtyczkę w panelu Kukisy.pl: Witryny → Twoja witryna → Instalacja (przycisk „Pobierz wtyczkę…”). Pakiet jest wygenerowany dla tej witryny, nie trzeba nic konfigurować.
  2. 2.W kokpicie WordPressa przejdź do Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer, wskaż pobrany plik i kliknij Zainstaluj, a następnie Włącz.
  3. 3.Wtyczka wypisuje znacznik <script> Kukisy.pl w akcji wp_head z priorytetem -1000, czyli przed skryptami, które inne wtyczki i motyw dodają przez wp_head() (w tym kolejkowanymi przez wp_enqueue_scripts, które WordPress wypisuje w wp_head z priorytetem 9). Nie trafi jednak przed: (a) skryptami wpisanymi na sztywno w header.php motywu powyżej wywołania wp_head(), (b) wtyczkami, które wypisują kod w wp_head z priorytetem niższym niż -1000 albo poza wp_head (np. buforując cały HTML), (c) skryptami przenoszonymi przez optymalizatory JS.
  4. 4.Sprawdź kolejność: uruchom skan w panelu Kukisy.pl i otwórz stronę w trybie incognito, a następnie Pokaż źródło strony (Ctrl+U). Znacznik z adresem zawierającym kukisy powinien być pierwszym <script> w <head>. Jeśli przed nim jest inny skrypt (np. GTM, piksel Meta), skopiuj znacznik z zakładki Instalacja i wklej go ręcznie w header.php motywu potomnego bezpośrednio po <head>, a we wtyczce wyłącz wypisywanie skryptu filtrem add_filter( 'kukisy_disable', '__return_true' );, żeby go nie dublować.
  5. 5.W stopce dodaj link do ustawień zgód: wstaw shortcode [kukisy_ustawienia] albo zwykły link do #kukisy. Możesz też włączyć automatyczny link w Ustawienia → Kukisy.pl.
  6. 6.Dokumenty prawne na Twojej domenie (zalecane): utwórz strony „Polityka cookies”, „Polityka prywatności” i ewentualnie „Regulamin” z treścią [kukisy_dokument typ="polityka-cookies"], [kukisy_dokument typ="polityka-prywatnosci"], [kukisy_dokument typ="regulamin"]. Wtyczka pobiera treść z Kukisy.pl bez linków do Kukisy.pl i odświeża ją co 6 godzin. Adresy tych stron wpisz w Baner → Linki w banerze, żeby baner kierował na Twoją domenę.
  7. 7.Wtyczki cache i optymalizacji: wyczyść cache po aktywacji. Wtyczka sama dodaje skrypt Kukisy.pl do wyjątków w WP Rocket (łączenie i „Delay JavaScript execution”), LiteSpeed Cache (łączenie i „JS Defer/Delay”), Autoptimize i Perfmatters. Sprawdź jednak w ustawieniach tych wtyczek, że skrypt nie jest łączony, odraczany (defer) ani opóźniany (delay). W innych wtyczkach (np. W3 Total Cache, SiteGround Optimizer, Hummingbird) dodaj ręcznie do wyjątków łączenia, defer i delay JS adres /s/ skryptu Kukisy.pl.

Wyłącz lub odinstaluj inne wtyczki cookie (Cookie Notice, Complianz, CookieYes, GDPR Cookie Consent). Dwa banery jednocześnie dezorientują użytkowników i powodują konflikty blokowania.

  • •Site Kit by Google, MonsterInsights i podobne wtyczki ładują tagi Google, które uwzględniają Google Consent Mode ustawiany przez Kukisy.pl, o ile skrypt Kukisy.pl jest w <head> przed nimi. Wtyczka, która nie korzysta z tagów Google, wymaga blokowania jak każde inne narzędzie.
  • •Wtyczki Meta Pixel (PixelYourSite, Pixel Cat): skrypt connect.facebook.net jest w bazie trackerów, a kod inline z fbq('init') rozpoznajemy, więc są blokowane do czasu zgody marketingowej, jeśli wstawiają kod po skrypcie Kukisy.pl. Potwierdź to skanem po instalacji.

Wix

Własny kod w ustawieniach witryny (wymaga planu Premium z własną domeną).

łatwa5 minut
  1. 1.Skopiuj kod <script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>.
  2. 2.W panelu Wix przejdź do Ustawienia → Zaawansowane → Kod niestandardowy → + Dodaj kod niestandardowy.
  3. 3.Wklej kod, nazwij go „Kukisy.pl”, wybierz Wszystkie strony, opcję Załaduj kod raz i miejsce Head. Zastosuj.
  4. 4.Dodaj link Ustawienia cookies w stopce do adresu #kukisy.

W Ustawienia → Prywatność i pliki cookie (Settings → Privacy & Cookies) wyłącz baner Wix („Cookie Consent Banner”), a politykę domyślną ustaw tak, żeby Wix nie ładował narzędzi analitycznych i marketingowych przed zgodą (opcja ograniczająca cookies do niezbędnych do czasu zgody). Korzystaj wyłącznie z baneru Kukisy.pl.

  • •Wix ładuje część własnych skryptów przed kodem niestandardowym; cookies niezbędne Wix (XSRF-TOKEN, hs, svSession) są w bazie jako niezbędne.
  • •Aplikacje i integracje Wix (Wix Analytics, Marketing Integrations: Google Analytics, piksel Meta, Hotjar) są ładowane przez platformę i mogą nie respektować zewnętrznej zgody. Tagi Google uwzględniają Consent Mode ustawiany przez Kukisy.pl; pozostałe sprawdź skanem w panelu Kukisy.pl i w razie potrzeby przenieś z „Marketing Integrations” do kodu niestandardowego z ręcznym oznaczeniem type="text/plain" data-zg-category="…".

Squarespace

Code Injection w nagłówku.

łatwa5 minut
  1. 1.Skopiuj kod <script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>.
  2. 2.Przejdź do Settings → Advanced → Code Injection i wklej kod w polu Header, na samej górze. Zapisz.
  3. 3.Dodaj link Ustawienia cookies do stopki kierujący do #kukisy.

W Settings → Cookies & Visitor Data wyłącz natywny baner (Cookie Banner), ale włącz opcję Restrict Squarespace analytics cookies: wbudowana analityka Squarespace nie czeka na zgodę z zewnętrznego baneru, a ta opcja ogranicza jej cookies.

Webflow

Custom code w ustawieniach projektu.

łatwa5 minut
  1. 1.Skopiuj kod <script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>.
  2. 2.Przejdź do Site settings → Custom code → Head code, wklej kod jako pierwszy i zapisz. Opublikuj witrynę.
  3. 3.Dodaj link Ustawienia cookies do stopki kierujący do #kukisy.

Webflow nie ma własnego baneru zgód, ale natywna integracja piksela Meta w Site settings → Integrations → Facebook Pixel ID ładuje piksel bez zgody. Usuń stamtąd identyfikator i wstaw kod piksela ręcznie w Custom code → Head code poniżej znacznika Kukisy.pl, oznaczony <script type="text/plain" data-zg-category="marketing">…</script>. Google Analytics / GTM wpisane w Integrations uwzględniają Consent Mode ustawiany przez Kukisy.pl.

Joomla

Wtyczka systemowa do kodu w nagłówku albo edycja szablonu.

średnia10 minut
  1. 1.Skopiuj kod <script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>.
  2. 2.Najprościej: zainstaluj darmową wtyczkę do wstawiania kodu (np. „Custom Code”, „Head & Footer Code”) i wklej kod w sekcji Head.
  3. 3.Alternatywnie edytuj templates/TWÓJ_SZABLON/index.php i wstaw kod bezpośrednio po <head>.
  4. 4.Dodaj link Ustawienia cookies do modułu stopki kierujący do #kukisy.

Wyłącz wtyczki typu „Cookies Policy Notification Bar”.

Drupal

Szablon html.html.twig (pewniej) albo moduł Asset Injector (bez edycji motywu).

dla developera15 minut
  1. 1.Skopiuj kod <script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>.
  2. 2.Pewniejsza metoda: w swoim motywie otwórz html.html.twig i wklej znacznik jako pierwszy element <head>, przed <head-placeholder …>. W module własnym możesz zamiast tego użyć hook_page_attachments() z elementem html_tag i wagą -100. Wyczyść cache Drupala.
  3. 3.Bez edycji motywu: zainstaluj moduł Asset Injector i utwórz JS Injector z opcją „Add to head”. Sam adres skryptu tu nie zadziała, bo moduł wstrzykuje kod JS, a nie znacznik <script src>. Wklej kod, który tworzy znacznik: var s=document.createElement('script');s.src='https://kukisy.pl/s/TWOJ-ID.js';s.setAttribute('data-kukisy','');document.head.prepend(s);
  4. 4.Skrypt dodany w ten sposób nie ma gwarancji pierwszeństwa przed innymi skryptami w <head> (np. GTM z modułu google_tag). Jeśli skan w panelu Kukisy.pl pokaże narzędzia uruchamiane przed zgodą, przejdź na wariant z html.html.twig.
  5. 5.Dodaj link Ustawienia cookies do bloku stopki, adres #kukisy.

Wyłącz moduł EU Cookie Compliance, jeśli jest aktywny.

Menedżery tagów i własny kod

Google Tag Manager

Zalecana instalacja: skrypt Kukisy.pl w kodzie strony, przed kontenerem GTM. Alternatywnie (beta): szablon tagu Kukisy.pl importowany do GTM. Tagi spoza Google przepnij na zdarzenie zgody.

średnia15 minutszablon
  1. 1.Droga A (zalecana): znacznik w kodzie strony. Wklej <script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script> w kodzie strony jako pierwszy element <head>, wyżej niż fragment kodu kontenera GTM. Znacznik nie ma async ani defer, więc przeglądarka wykonuje go w całości, zanim przejdzie do kodu GTM. Skrypt Kukisy.pl od razu przy wykonaniu (przy włączonej w panelu opcji Google Consent Mode) wywołuje synchronicznie gtag('consent','default', …), więc domyślny stan zgody jest w warstwie danych, zanim kontener wystartuje.
  2. 2.Jeśli kontener GTM jest w <head> wyżej niż skrypt Kukisy.pl, przenieś kod GTM poniżej znacznika Kukisy.pl (albo znacznik Kukisy.pl nad GTM).
  3. 3.Nie zalecamy ładowania Kukisy.pl z poziomu GTM (tag HTML): zgodnie z dokumentacją Google domyślny stan zgody musi być ustawiony zanim uruchomią się tagi, a tag HTML w GTM nie daje takiej gwarancji. Jeśli nie masz dostępu do kodu strony, poproś wykonawcę o dodanie jednej linii w szablonie, użyj wtyczki dla Twojej platformy albo skorzystaj z drogi B: szablonu tagu Kukisy.pl, który korzysta z natywnych API zgód GTM (dostępny do importu z pliku; publikacja w galerii szablonów GTM jest planowana).
  4. 4.Droga B: instalacja z poziomu GTM przez szablon (beta). Pobierz szablon w panelu Kukisy.pl: Witryny → Twoja witryna → Instalacja → wybierz platformę Google Tag Manager → przycisk „Pobierz szablon tagu Kukisy.pl dla GTM (.tpl)”. Identyfikator witryny jest już wpisany. Upewnij się, że w ustawieniach baneru w panelu Kukisy.pl jest włączona opcja Google Consent Mode v2: szablon ustawia stan domyślny „denied”, a aktualizację zgody po decyzji użytkownika wysyła skrypt baneru tylko przy włączonej opcji.
  5. 5.W GTM przejdź do Szablony → Szablony tagów → Nowy, w edytorze otwórz menu ⋮ (prawy górny róg) → Importuj, wskaż pobrany plik i kliknij Zapisz. Szablon wymaga uprawnień: zapis stanu zgody (7 typów zgód), wstrzykiwanie skryptu z adresu https://kukisy.pl/s/* oraz zapis do warstwy danych kluczy ads_data_redaction i url_passthrough.
  6. 6.Przejdź do Tagi → Nowy → Konfiguracja tagu i wybierz typ „Kukisy.pl – zgody cookie (Consent Mode v2)” (sekcja szablonów własnych). Sprawdź lub wpisz identyfikator witryny, a jako regułę wybierz Inicjowanie zgody – wszystkie strony (Consent Initialization – All Pages). Nie łącz drogi B z drogą A ani z tagiem HTML ładującym Kukisy.pl: zostaw jedno źródło skryptu.
  7. 7.Lista kontrolna przed wyjściem z bety (kliknij Podgląd i sprawdź w Tag Assistant): (1) import pliku .tpl przebiega bez błędów, a GTM pokazuje trzy uprawnienia szablonu: zgody, wstrzyknięcie skryptu z kukisy.pl oraz zapis ads_data_redaction/url_passthrough; (2) przy zdarzeniu Consent Initialization (karta Zgoda) stan wszystkich typów zgody (poza security_storage, które jest zawsze „granted”) jest „denied”, zanim pojawi się Container Loaded; (3) po akceptacji, odmowie i zmianie wyboru w ustawieniach baneru pojawia się Consent update z właściwymi wartościami (oraz zdarzenie zg_consent_update); (4) na kolejnej podstronie zapisany wybór jest odtwarzany: Consent update pojawia się zaraz po załadowaniu strony; (5) tagi spoza Google przepięte na zg_consent_update (kroki poniżej) uruchamiają się tylko po zgodzie na ich kategorię.
  8. 8.Opublikuj kontener. Zastrzeżenie: szablon jest w wersji beta, więc przed publikacją przetestuj go w podglądzie; przy problemach użyj drogi A. W drodze B skrypt Kukisy.pl ładuje się asynchronicznie z poziomu kontenera, więc auto-blokowanie obejmuje tylko skrypty wstrzyknięte później, a u osoby z zapisaną zgodą tagi Google czekają na jej aktualizację najwyżej tyle, ile ustawisz w polu wait_for_update (domyślnie 500 ms). Kolejne kroki dotyczą obu dróg.
  9. 9.Przejrzyj tagi uruchamiane na regule Wszystkie strony / Wyświetlenie strony. Przepiąć trzeba wszystkie tagi uruchamiane z GTM, które ustawiają cookies lub wysyłają dane (piksel Meta, TikTok, Hotjar, Clarity, LinkedIn, Pinterest, własne tagi HTML, piksele obrazkowe itd.), z wyjątkiem tagów Google obsługujących Consent Mode (następne kroki). Utwórz zmienne warstwy danych: zg_analytics, zg_marketing, zg_functional. Tagi inicjalizujące biblioteki (kod bazowy piksela Meta, Hotjar init, Clarity, TikTok itd.) przepnij na regułę Zdarzenie niestandardowe o nazwie zg_consent_update z warunkiem na zmiennej warstwy danych: zg_marketing równa się true (narzędzia reklamowe) albo zg_analytics równa się true (statystyki, nagrania sesji). Warunek jest konieczny: zdarzenie wysyłamy po każdej decyzji, także po odmowie i wycofaniu, oraz przy każdej kolejnej odsłonie u osoby z zapisaną decyzją. Tagów zdarzeń biznesowych (purchase, lead, add_to_cart) nie przepinaj na zg_consent_update, bo odpaliłyby się od razu po zgodzie, a nie przy zdarzeniu: zostaw im dotychczasowe wyzwalacze i dodaj do nich warunek na tej samej zmiennej zgody (albo wyjątek blokujący, gdy zmienna jest różna od true).
  10. 10.Dlaczego przepinać? Auto-blokowanie Kukisy.pl przechwytuje skrypty i ramki, które GTM wstrzykuje z atrybutem src (nadpisane ustawianie src elementów <script> i <iframe>), o ile adres jest w naszej bazie trackerów. Nie obejmuje natomiast kodu inline w tagach Niestandardowy kod HTML (wykonuje się od razu po wstawieniu), pikseli obrazkowych, zapytań wysyłanych z takiego kodu ani narzędzi spoza bazy. Przepięcie reguł zamyka te luki.
  11. 11.Tagi Google (GA4, Google Ads, Floodlight) zostaw na dotychczasowych regułach: obsługują Consent Mode v2 (ad_storage, ad_user_data, ad_personalization, analytics_storage), który ustawia Kukisy.pl, i dostosowują działanie do stanu zgody. W razie potrzeby włącz w tagu Ustawienia zgody → Wymagaj dodatkowej zgody.
  12. 12.Sprawdź w Podglądzie GTM: zdarzenie zg_consent_default w drodze A pojawia się przed Container Loaded (skrypt Kukisy.pl wykonuje się przed kontenerem), a w drodze B po Container Loaded, bo skrypt Kukisy.pl wstrzykuje dopiero tag uruchomiony w kontenerze (stan domyślny ustawia wtedy wcześniej sam szablon przy Consent Initialization). Karta Zgoda pokazywać stan domyślny już przy pierwszym zdarzeniu. zg_consent_update pojawia się po decyzji w banerze (i przy wejściu, jeśli zgoda jest już zapisana). Tagi spoza Google nie powinny odpalać przed zg_consent_update.
  • •Skrypt Kukisy.pl nie zablokuje niczego, co wykonało się przed nim. Dlatego w drodze A musi być pierwszym skryptem w <head>, przed GTM i przed innymi narzędziami wpisanymi bezpośrednio w kod strony.
  • •Szablon tagu Kukisy.pl (beta) jest dostępny do importu z pliku .tpl; publikacja w galerii szablonów społeczności GTM jest planowana. Aby zaktualizować szablon, otwórz go w Szablony → Szablony tagów, wybierz ⋮ → Importuj i wskaż nowo pobrany plik.
  • •Zdarzenie zg_consent_update niesie pole zg_consent_action (accept_all, reject_all, custom, withdraw, restore) oraz po jednym polu zg_<kategoria> (zg_functional, zg_analytics, zg_marketing) z wartością true/false dla każdej kategorii włączonej w panelu.

Inna platforma / własny kod

Jeden znacznik script jak najwyżej w sekcji head.

dla developera10 minut
  1. 1.Wklej <script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script> jako pierwszy element w sekcji <head>, przed wszystkimi innymi skryptami. Znacznik nie ma async ani defer, więc Consent Mode i blokada są ustawione, zanim wykonają się skrypty umieszczone niżej. Skryptów umieszczonych wyżej Kukisy.pl nie zablokuje.
  2. 2.Skrypty osób trzecich spoza naszej bazy oznacz ręcznie atrybutami type="text/plain" data-zg-category="…" (gotowy przykład znajdziesz w zakładce Instalacja w panelu Kukisy.pl).
  3. 3.Dodaj link Ustawienia cookies do stopki, adres #kukisy lub element z atrybutem data-zg-open. Skrypt sam obsłuży kliknięcie; własny kod JavaScript nie jest potrzebny.
  4. 4.Jeśli używasz Google Tag Managera z własnymi regułami, podepnij tagi spoza Google pod zdarzenie zg_consent_update z warunkiem kategorii. Szczegóły (atrybuty, zdarzenia dataLayer, Consent Mode) w sekcji „Dla deweloperów”.

Nie ma Twojej platformy?

Wystarczy możliwość wklejenia jednego znacznika w sekcji head. Napisz do nas, dodamy instrukcję.

Zacznij za darmo