Integrace souhlasu s cookies

Poznámka

Toto je automatický překlad. Komunitní opravy jsou vítány! Odeslat opravu na GitHubu

Přehled

Barion Pixel vyžaduje explicitní souhlas uživatele před sběrem marketingových dat (soulad s GDPR). Plugin musí volat bp('consent', 'grantConsent'), když uživatel souhlas přijme, a bp('consent', 'rejectConsent'), když ho odmítne. Obě události jsou povinné dle požadavků Barion.

Skript základního pixelu se vždy načte pro prevenci podvodů, ale žádná marketingová data nejsou sbírána, dokud není souhlas explicitně udělen nebo odmítnut.

Důležité: Váš banner cookies musí nabízet možnost jak přijetí, tak odmítnutí. „Cookie wall” (pouze přijetí) není v souladu s GDPR od roku 2020 a Barion ho odmítne.

Plugin podporuje tři úrovně integrace souhlasu, kontrolované v tomto pořadí:

1. WP Consent API (doporučeno) — univerzální, funguje se všemi hlavními pluginy pro cookies
2. Cookie Law Info (záloha) — přímá integrace pro weby používající CookieYes/Cookie Law Info
3. Ruční — pro vlastní správce souhlasu nebo speciální případy

---

Úroveň 1: WP Consent API (doporučeno)

WP Consent API je standard WordPressu pro komunikaci souhlasu. Je podporován všemi hlavními pluginy pro souhlas s cookies.

Jak to funguje

Plugin za běhu kontroluje přítomnost funkce wp_has_consent() v JavaScriptu. Pokud je WP Consent API k dispozici:

1. Při načtení stránky zkontroluje, zda je udělen nebo odmítnut souhlas s marketing
2. Volá bp('consent', 'grantConsent'), pokud je marketingový souhlas udělen
3. Volá bp('consent', 'rejectConsent'), pokud marketingový souhlas není udělen
4. Naslouchá události wp_listen_for_consent_change pro aktualizace souhlasu v reálném čase — podle toho udělí nebo odmítne souhlas

Podporované pluginy pro cookies

Automaticky bude fungovat jakýkoli plugin, který implementuje WP Consent API:

Plugin	Aktivní instalace	Poznámky
CookieYes	1,5 M+	WP Consent API zabudované
Complianz	1 M+	Spolutvůrce WP Consent API
Cookie Notice od dFactory	1 M+	Kompatibilní s WP Consent API
GDPR Cookie Compliance (Moove)	300 K+	Kompatibilní s WP Consent API
Real Cookie Banner	100 K+	Kompatibilní s WP Consent API

Nastavení

1. Nainstalujte a aktivujte plugin WP Consent API
2. Nainstalujte a nakonfigurujte váš preferovaný plugin pro souhlas s cookies (viz tabulka výše)
3. Nainstalujte a nakonfigurujte Advanced Pixel for Barion
4. Žádná další konfigurace není potřeba — souhlas je zpracováván automaticky

Kategorie souhlasu

Barion Pixel je registrován v kategorii souhlasu marketing ve WP Consent API. Toto je standardní kategorie pro sledovací pixely používané pro retargeting a analýzy.

---

Úroveň 2: Cookie Law Info (záloha)

Pokud WP Consent API není k dispozici, plugin přejde na přímou integraci s pluginem Cookie Law Info / CookieYes.

Jak to funguje

1. Zkontroluje přítomnost globálního JavaScriptového objektu CLI
2. Pokud jsou cookies již přijaty (vracející se návštěvník), souhlas je udělen okamžitě
3. Pokud cookies nejsou přijaty, souhlas je odmítnut okamžitě
4. Naslouchá události cli_user_preference_set, když uživatel interaguje s bannerem cookies
5. Udělí nebo odmítne souhlas na základě hodnoty cookie cookielawinfo-checkbox-necessary

Nastavení

Není potřeba žádná konfigurace. Nainstalujte oba pluginy a integrace bude fungovat automaticky.

---

Úroveň 3: Ruční integrace

Pro vlastní správce souhlasu nebo prostředí, kde není k dispozici ani WP Consent API, ani Cookie Law Info.

Metoda 1: JavaScriptové funkce (doporučeno)

// Když uživatel přijme marketingové cookies
function onMarketingConsentGranted() {
    if (typeof window.wcBarionGrantConsent === 'function') {
        window.wcBarionGrantConsent();
    }
}

// Když uživatel odmítne marketingové cookies
function onMarketingConsentRejected() {
    if (typeof window.wcBarionRejectConsent === 'function') {
        window.wcBarionRejectConsent();
    }
}

Metoda 2: Vlastní DOM události

// Udělení souhlasu
document.dispatchEvent(new Event('wcBarionGrantConsent'));

// Odmítnutí souhlasu
document.dispatchEvent(new Event('wcBarionRejectConsent'));

Metoda 3: WordPress action hook

// Ve vašem pluginu správce souhlasu nebo šabloně
add_action('wc_barion_pixel_footer_scripts', 'my_barion_consent_handler');

function my_barion_consent_handler() {
    ?>
    <script>
    // Vaše vlastní logika souhlasu zde
    </script>
    <?php
}

Příklady pro konkrétní správce souhlasu

Cookiebot:

window.addEventListener('CookiebotOnAccept', function() {
    if (Cookiebot.consent.marketing) {
        window.wcBarionGrantConsent();
    } else {
        window.wcBarionRejectConsent();
    }
});
window.addEventListener('CookiebotOnDecline', function() {
    window.wcBarionRejectConsent();
});

OneTrust:

function OptanonWrapper() {
    if (OnetrustActiveGroups.includes('C0004')) {
        window.wcBarionGrantConsent();
    } else {
        window.wcBarionRejectConsent();
    }
}

---

Vliv souhlasu na pixel

Stav	Základní pixel (bp.js)	pageView	Sběr marketingových dat
Před jakoukoli akcí souhlasu	Načten	Spouští se (prevence podvodů)	Žádná data nejsou sbírána
Po grantConsent	Načten	Spouští se	Plný sběr dat povolen
Po rejectConsent	Načten	Spouští se (prevence podvodů)	Žádná marketingová data nejsou sbírána

Základní pixel se vždy načte pro prevenci podvodů ze strany Barion. Volání grantConsent / rejectConsent kontrolují, zda jsou marketingová data sbírána.

---

Testování

1. Povolte Režim ladění v Nastavení > Barion Pixel
2. Otevřete konzoli prohlížeče (F12)
3. Hledejte zprávy protokolu týkající se souhlasu:
   • [Barion Pixel] Consent auto-granted via WP Consent API — Úroveň 1, uživatel přijal
   • [Barion Pixel] Consent auto-rejected via WP Consent API — Úroveň 1, uživatel odmítl
   • [Barion Pixel] Consent auto-granted via Cookie Law Info — Úroveň 2, uživatel přijal
   • [Barion Pixel] Consent auto-rejected via Cookie Law Info — Úroveň 2, uživatel odmítl
   • [Barion Pixel] No consent manager detected... — Úroveň 3 (ruční režim)
   • [Barion Pixel] Consent granted (grantConsent) — souhlas byl udělen (jakákoli úroveň)
   • [Barion Pixel] Consent rejected (rejectConsent) — souhlas byl odmítnut (jakákoli úroveň)
4. Otestujte tok přijetí i odmítnutí na vašem banneru cookies
5. Funkce souhlasu lze bezpečně volat vícekrát (jsou idempotentní)