Integracje

Zgoda na pliki cookie w koszyku osadzonym na Twojej stronie

Jak koszyk Zanfii osadzony na Twojej własnej stronie stosuje decyzję jej banera cookie: Google Consent Mode v2, IAB TCF v2, wywołanie setConsent i atrybut data-zanfia-consent, z przykładem dla każdego.

5 min czytaniaOstatnia aktualizacja: 20 paź 2026

Koszyk osadzony na Twojej stronie kodem z Integracje → Osadzony koszyk (/integrations/checkout-embed) nigdy nie pokazuje banera cookie Zanfii. Zgoda na Twojej stronie należy do Twojej strony: koszyk stosuje decyzję banera cookie, który tam działa. Ten artykuł wyjaśnia, co koszyk odczytuje, co się dzieje bez banera i jak przekazać decyzję banera, którego koszyk sam nie odczyta.

Zasada

  • Koszyk stosuje decyzję Twojego banera. Sam odczytuje Google Consent Mode v2, IAB TCF v2 i popularne wtyczki banerów wymienione niżej, a z Twojego własnego kodu przyjmuje decyzję przez zanfiaCheckout.setConsent albo atrybut data-zanfia-consent.
  • Odmowa w banerze oznacza brak zdarzeń do Meta, Google, TikToka i innych platform, także zakupu. Dziennik zdarzeń pokazuje je jako zablokowane przez zgodę na cookie.
  • Dopóki baner jest otwarty, koszyk czeka i nic nie wysyła, aż odwiedzający odpowie.
  • Bez banera na Twojej stronie koszyk wysyła zdarzenia, tak jak strona w Zanfii z wyłączonym banerem. Prośba o zgodę na Twojej stronie to Twój obowiązek.
  • Baner, którego koszyk nie odczytuje, jest dla niego niewidoczny: koszyk śledzi przed odpowiedzią odwiedzającego i niezależnie od niej. To baner napisany samodzielnie albo wtyczka spoza listy niżej z wyłączonym Google Consent Mode v2. Włącz w niej Consent Mode v2 albo przekaż decyzję przez setConsent.

Nie dotyczy to stron w Zanfii i linku do koszyka (/c/…): mają własny baner Zanfii, a koszyk otwarty na stronie w Zanfii stosuje baner tej strony.

Gdzie znaleźć kod

Otwórz Integracje → Osadzony koszyk, kliknij Otwórz edytor osadzenia, wybierz koszyk i kliknij Osadź na stronie. Pod kodem osadzenia okno pokazuje blok Zgoda na pliki cookie na Twojej stronie z oboma fragmentami kodu opisanymi niżej, gotowymi do skopiowania.

Większość banerów cookie potrafi przekazać wybór odwiedzającego do Google Consent Mode v2. Jeśli Twój to robi, nic nie dodajesz: koszyk odczytuje tę samą odpowiedź co Twoje tagi Google.

Co koszyk z niej bierze:

Sygnał Consent ModeZdarzenia koszyka
analytics_storageAnalityka (Google Analytics 4)
ad_storage oraz ad_user_data / ad_personalization, gdy są ustawioneMarketing (Meta, Google Ads, TikTok i pozostałe)

Jeśli ustawiasz Consent Mode samodzielnie, na przykład w Google Tag Managerze, odpowiedź odwiedzającego to polecenie update:

gtag('consent', 'update', {
  analytics_storage: 'granted',
  ad_storage: 'denied',
  ad_user_data: 'denied',
  ad_personalization: 'denied',
});

Ustawienie default, które wszystkiego odmawia, a po którym nigdy nie przychodzi update, zostawia koszyk w oczekiwaniu, więc nic nie wysyła.

Inne wtyczki cookie

Wiele wtyczek banerów ma w ustawieniu domyślnym wyłączony Google Consent Mode v2. Wtyczki z następnej sekcji koszyk odczytuje bez niego. W każdej innej wtyczce otwórz ustawienia, znajdź Google Consent Mode (często nazwany Consent Mode v2 albo GCM) i włącz go. Dzięki temu wtyczka przekaże odpowiedź także Twoim własnym tagom Google.

Wtyczki banerów, które koszyk odczytuje sam

Te wtyczki koszyk odczytuje bezpośrednio, z ich własnego pliku cookie albo interfejsu JavaScript, także przy wyłączonym Google Consent Mode. Nic nie dodajesz.

WtyczkaAnalityka wedługMarketing według
CookieYesAnalyticsAdvertisement
ComplianzStatystykaMarketing
Cookie Notice & Compliance (Hu-manity)Optymalizacja strony (albo jedno tak / nie)Personalizacja reklam (albo jedno tak / nie)
GDPR Cookie Consent (WebToffee), wersja bezpłatna lub starszy banerAnalyticsAdvertisement
CookiebotStatystykaMarketing
Borlabs CookieStatystykaMarketing
GDPR Cookie Compliance (Moove)Pliki cookie stron trzecichDodatkowe pliki cookie
iubendaPomiar (albo jedno tak / nie)Marketing (albo jedno tak / nie)

Dopóki odwiedzający nie odpowie na baner wtyczki, koszyk czeka. Tylko niezbędne (albo odrzucenie wszystkich) oznacza brak zdarzeń. Wtyczka spoza listy potrzebuje Consent Mode v2 albo setConsent.

Płatnej wtyczki GDPR Cookie Consent od WebToffee z nowym banerem koszyk jeszcze nie odczytuje: włącz w niej Consent Mode v2 albo wywołaj setConsent. Gdy baner GDPR Cookie Consent nazywa kategorie inaczej (nie Analytics i Advertisement), koszyk uznaje zgodę tylko wtedy, gdy odwiedzający zaakceptował wszystkie.

Baner certyfikowany dla IAB TCF v2

Narzędzie zgody zgodne z IAB TCF v2 (interfejs __tcfapi) też nie wymaga niczego więcej. Koszyk go nasłuchuje i przyjmuje:

  • analitykę, gdy cele 1 i 8 są dozwolone,
  • marketing, gdy cele 1, 3, 4 i 7 są dozwolone.

Gdy narzędzie poda, że RODO nie obejmuje odwiedzającego, koszyk przestaje na nie czekać.

Baner napisany samodzielnie lub każdy inny: setConsent

Jeśli Twój baner to Twój własny kod albo nie umie przekazać odpowiedzi do Consent Mode ani TCF, wywołaj z niego setConsent. Umieść wywołanie pod tagiem skryptu koszyka, po decyzji odwiedzającego:

window.zanfiaCheckout.setConsent({
  analytics: true,
  marketing: false,
});

true to zgoda, false to odmowa. Możesz wywoływać je dowolnie wiele razy: późniejsze kliknięcie dotrze także do koszyka, który jest już otwarty.

Baner zapamiętuje wybór i na kolejnej podstronie już się nie pokazuje. Wywołuj więc setConsent przy każdym wczytaniu strony z zapisanym wyborem, nie tylko po kliknięciu. Przykład dla banera, który trzyma wybór w localStorage:

<script src="…zanfia-checkout-2.0.min.js?…"></script>
<script>
  function passChoice(choice) {
    window.zanfiaCheckout.setConsent({
      analytics: choice === 'all',
      marketing: choice === 'all',
    });
  }
  // Wybór zapisany przy wcześniejszej wizycie.
  var saved = localStorage.getItem('my_cookie_choice');
  if (saved) passChoice(saved);
  // Przyciski banera.
  document.getElementById('accept-all').addEventListener('click', function () {
    localStorage.setItem('my_cookie_choice', 'all');
    passChoice('all');
  });
  document.getElementById('necessary-only').addEventListener('click', function () {
    localStorage.setItem('my_cookie_choice', 'necessary');
    passChoice('necessary');
  });
</script>

Zamień my_cookie_choice, accept-all i necessary-only na nazwy, których używa Twój baner.

Gdy decyzja nie zależy od banera, dodaj atrybut do tagu skryptu koszyka:

<script src="…zanfia-checkout-2.0.min.js?…" data-zanfia-consent="denied"></script>

denied oznacza, że koszyk nigdy nie wysyła zdarzeń na tej stronie, granted, że zawsze je wysyła. W trybie „Na stronie” atrybut działa też na elemencie data-zanfia-checkout. Wywołanie setConsent ma pierwszeństwo przed atrybutem.

Które źródło wygrywa

Gdy odpowiada kilka źródeł, koszyk bierze pierwsze, które ma decyzję, w tej kolejności: setConsent, atrybut data-zanfia-consent, IAB TCF v2, wtyczka banera z listy wyżej, Google Consent Mode v2. Sam koszyk niczego nie zapisuje: każda strona pyta Twój baner od nowa.

Kod osadzenia wklejony dawno temu

Kody, które wczytują starszy skrypt (zanfia-checkout.js, zanfia-checkout-1.0.min.js albo starszy plik mailingr-checkout…, bez 2.0), nie przekazują odpowiedzi Twojego banera, więc śledzą jak na stronie bez banera. Skopiuj kod ponownie z Integracje → Osadzony koszyk, aby koszyk stosował Twój baner.

Czy ten artykuł był pomocny?

Powiązane artykuły

Coś się nie zgadza? Napisz do nas na support@zanfia.com.