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
WooCommerce
Ta sama wtyczka co dla WordPressa, plus obsługa integracji sklepowych.
- 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.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.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.Dodaj do stopki link do ustawień zgód: shortcode
[kukisy_ustawienia]lub link do#kukisy. - 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.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
Shoper
Wklejenie kodu w ustawieniach stylu. Wyłącz wbudowany pasek cookies.
- 1.Skopiuj kod
<script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>. - 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.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.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.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
IdoSell
Własny kod w sekcji HEAD szablonu. IdoSell ma natywny tryb zgód, który trzeba wyłączyć.
- 1.Skopiuj kod
<script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>. - 2.W panelu IdoSell przejdź do Moderacja → Własne skrypty JavaScript i CSS (w starszych panelach: Marketing i integracje → Integracje → Kody HTML/JS).
- 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.Zapisz i opublikuj zmiany szablonu, jeśli IdoSell tego wymaga.
- 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
PrestaShop
Moduł wygenerowany dla tej witryny, instalowany przez panel administracyjny.
- 1.Pobierz moduł w panelu Kukisy.pl: Witryny → Twoja witryna → Instalacja (przycisk „Pobierz moduł…”). Pakiet ma już wpisany identyfikator tej witryny.
- 2.W panelu PrestaShop przejdź do Moduły → Menedżer modułów → Wgraj moduł i wskaż pobrany plik .zip. Moduł zainstaluje się automatycznie.
- 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.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
displayHeaderi przesuń Kukisy.pl na pierwsze miejsce; (2) jeśli to nie wystarczy, wklej znacznik ręcznie jako pierwszy element<head>w plikuthemes/<motyw>/templates/_partials/head.tpli w Pozycjach odepnij moduł oddisplayHeader, żeby nie dublować skryptu. - 5.Dodaj link Ustawienia cookies do stopki: Projekt → Strony/Linki, adres
#kukisy. Moduł udostępnia też hookdisplayFooterz gotowym linkiem (możesz go włączyć w konfiguracji modułu). - 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-#) orazPHPSESSIDsą klasyfikowane jako niezbędne. - •Znacznik wstawiony w
head.tpltrzeba przenieść po aktualizacji motywu; pamiętaj o tym przy zmianie wersji szablonu.
Sky-Shop
Własny kod w nagłówku sklepu.
łatwa5 minut
Sky-Shop
Własny kod w nagłówku sklepu.
- 1.Skopiuj kod
<script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>. - 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.Zapisz. Jeśli sklep używa cache, odśwież je w ustawieniach.
- 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
Shopify
Kod w theme.liquid. Kukisy.pl przekazuje zgodę do natywnego API prywatności Shopify.
- 1.Skopiuj kod
<script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>. - 2.W panelu Shopify przejdź do Sklep online → Motywy → ⋯ → Edytuj kod, otwórz plik
layout/theme.liquid. - 3.Wklej kod bezpośrednio po otwierającym tagu
<head>, przed{{ content_for_header }}. Zapisz. - 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.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.liquidponiż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.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
Sellingo
Własny kod w sekcji HEAD w ustawieniach wyglądu.
- 1.Skopiuj kod
<script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>. - 2.W panelu przejdź do Wygląd → Własne kody → Sekcja HEAD, wklej kod na górze i zapisz.
- 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
RedCart
Własny kod w nagłówku szablonu.
- 1.Skopiuj kod
<script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>. - 2.W panelu przejdź do Konfiguracja → Wygląd → Edycja szablonu → Nagłówek (HEAD), wklej kod jako pierwszy i zapisz.
- 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
Magento / Adobe Commerce
Pole „HTML Head → Scripts and Style Sheets” w konfiguracji projektu.
- 1.Skopiuj kod
<script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>. - 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.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
WordPress
Wtyczka z wbudowanym identyfikatorem witryny. Instalacja zajmuje kilka minut.
- 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.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.Wtyczka wypisuje znacznik
<script>Kukisy.pl w akcjiwp_headz priorytetem-1000, czyli przed skryptami, które inne wtyczki i motyw dodają przezwp_head()(w tym kolejkowanymi przezwp_enqueue_scripts, które WordPress wypisuje wwp_headz priorytetem 9). Nie trafi jednak przed: (a) skryptami wpisanymi na sztywno wheader.phpmotywu powyżej wywołaniawp_head(), (b) wtyczkami, które wypisują kod wwp_headz priorytetem niższym niż-1000albo pozawp_head(np. buforując cały HTML), (c) skryptami przenoszonymi przez optymalizatory JS. - 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
kukisypowinien 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 wheader.phpmotywu potomnego bezpośrednio po<head>, a we wtyczce wyłącz wypisywanie skryptu filtremadd_filter( 'kukisy_disable', '__return_true' );, żeby go nie dublować. - 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.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.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.netjest w bazie trackerów, a kod inline zfbq('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
Wix
Własny kod w ustawieniach witryny (wymaga planu Premium z własną domeną).
- 1.Skopiuj kod
<script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>. - 2.W panelu Wix przejdź do Ustawienia → Zaawansowane → Kod niestandardowy → + Dodaj kod niestandardowy.
- 3.Wklej kod, nazwij go „Kukisy.pl”, wybierz Wszystkie strony, opcję Załaduj kod raz i miejsce Head. Zastosuj.
- 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
Squarespace
Code Injection w nagłówku.
- 1.Skopiuj kod
<script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>. - 2.Przejdź do Settings → Advanced → Code Injection i wklej kod w polu Header, na samej górze. Zapisz.
- 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
Webflow
Custom code w ustawieniach projektu.
- 1.Skopiuj kod
<script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>. - 2.Przejdź do Site settings → Custom code → Head code, wklej kod jako pierwszy i zapisz. Opublikuj witrynę.
- 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
Joomla
Wtyczka systemowa do kodu w nagłówku albo edycja szablonu.
- 1.Skopiuj kod
<script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>. - 2.Najprościej: zainstaluj darmową wtyczkę do wstawiania kodu (np. „Custom Code”, „Head & Footer Code”) i wklej kod w sekcji Head.
- 3.Alternatywnie edytuj
templates/TWÓJ_SZABLON/index.phpi wstaw kod bezpośrednio po<head>. - 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
Drupal
Szablon html.html.twig (pewniej) albo moduł Asset Injector (bez edycji motywu).
- 1.Skopiuj kod
<script src="https://kukisy.pl/s/TWOJ-ID.js" data-kukisy></script>. - 2.Pewniejsza metoda: w swoim motywie otwórz
html.html.twigi wklej znacznik jako pierwszy element<head>, przed<head-placeholder …>. W module własnym możesz zamiast tego użyćhook_page_attachments()z elementemhtml_tagi wagą-100. Wyczyść cache Drupala. - 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.Skrypt dodany w ten sposób nie ma gwarancji pierwszeństwa przed innymi skryptami w
<head>(np. GTM z moduługoogle_tag). Jeśli skan w panelu Kukisy.pl pokaże narzędzia uruchamiane przed zgodą, przejdź na wariant zhtml.html.twig. - 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
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.
- 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 maasyncanidefer, 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 synchroniczniegtag('consent','default', …), więc domyślny stan zgody jest w warstwie danych, zanim kontener wystartuje. - 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.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.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.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 kluczyads_data_redactioniurl_passthrough. - 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.Lista kontrolna przed wyjściem z bety (kliknij Podgląd i sprawdź w Tag Assistant): (1) import pliku
.tplprzebiega bez błędów, a GTM pokazuje trzy uprawnienia szablonu: zgody, wstrzyknięcie skryptu z kukisy.pl oraz zapisads_data_redaction/url_passthrough; (2) przy zdarzeniu Consent Initialization (karta Zgoda) stan wszystkich typów zgody (pozasecurity_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 zdarzeniezg_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 nazg_consent_update(kroki poniżej) uruchamiają się tylko po zgodzie na ich kategorię. - 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.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 nazwiezg_consent_updatez warunkiem na zmiennej warstwy danych:zg_marketingrówna siętrue(narzędzia reklamowe) albozg_analyticsró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 nazg_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 odtrue). - 10.Dlaczego przepinać? Auto-blokowanie Kukisy.pl przechwytuje skrypty i ramki, które GTM wstrzykuje z atrybutem
src(nadpisane ustawianiesrcelementó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.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.Sprawdź w Podglądzie GTM: zdarzenie
zg_consent_defaultw drodze A pojawia się przedContainer Loaded(skrypt Kukisy.pl wykonuje się przed kontenerem), a w drodze B poContainer 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_updatepojawia się po decyzji w banerze (i przy wejściu, jeśli zgoda jest już zapisana). Tagi spoza Google nie powinny odpalać przedzg_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_updateniesie polezg_consent_action(accept_all,reject_all,custom,withdraw,restore) oraz po jednym poluzg_<kategoria>(zg_functional,zg_analytics,zg_marketing) z wartościątrue/falsedla każdej kategorii włączonej w panelu.
Inna platforma / własny kod
Jeden znacznik script jak najwyżej w sekcji head.
dla developera10 minut
Inna platforma / własny kod
Jeden znacznik script jak najwyżej w sekcji head.
- 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 maasyncanidefer, 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.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.Dodaj link Ustawienia cookies do stopki, adres
#kukisylub element z atrybutemdata-zg-open. Skrypt sam obsłuży kliknięcie; własny kod JavaScript nie jest potrzebny. - 4.Jeśli używasz Google Tag Managera z własnymi regułami, podepnij tagi spoza Google pod zdarzenie
zg_consent_updatez 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