Zdroje pro vývojáře Cookienovo

Níže jsou uvedeny technické informace o banneru Cookienovo, které jsou určeny především vývojářům. Do budoucna se plánuje rozšíření této funkcionality o další vývojářsky přívětivé věci, jako jsou obsluhy událostí a přímý přístup k souborům cookie.

Vložení skriptu

Aby vaše webové stránky měly Cookienovo baner pro sledování a souhlasy se soubory cookie pro uživatele, musíte do zdrojového kódu svých webových stránek vložit náš skript, který jste obdrželi poštou při registraci. Tento skript najdete také ve svém účtu na webových stránkách Cookienovo. Tento skript by měl vypadat nějak takto:

Musíte se ujistit, že tento skript vkládáte na začátek do prvku < head > webové stránky. Ujistěte se, že jsou správně nastaveny atributy type a src, jak je uvedeno zde.

Poznámka: Protože banner Cookienovo spolupracuje s GTM (Google Tag Manager), ujistěte se, že skript Cookienovo vkládáte do elementu < head > před inicializační část GTM.

Štítky skriptů

Náš banner Cookienovo má dvě značky, které můžete nakonfigurovat právě teď, přičemž se počítá s rozšířením o další značky v budoucnu.

site-token: Toto je povinné a musíte jej nastavit na základě ID, které jste obdrželi poštou, nebo na našich webových stránkách. Ujistěte se, že máte nastaveno správné UUID, jinak se banner Cookienovo nezobrazí.
- UUID

theme: Pomocí tohoto nastavení můžete nadefinovat téma banneru tak, aby byl vždy ve světlém nebo tmavém režimu.
- "light"
- "dark"

consent-mode: Pomocí tohoto nastavení můžete přepsat režim souhlasu nastavený bannerem. Výchozí hodnota je true. Nastavte tuto hodnotu na "false", pokud nechcete odesílat souhlas uživatelů.
- "true"
- "false"

Ovládání událostí

Pokud chcete řídit souhlas uživatele sami v jiných skriptech, můžete přidat posluchač událostí na CookienovoUserConsentChanged. Příklad toho může vypadat nějak takto:

< script type="text/javascript">
  document.addEventListener("CookienovoUserConsentChanged", (e) => {
    console.log("změna cookie", e.detail);
  });
< / script >
            

Pokud chcete získat skutečné hodnoty, které uživatel vybral, můžete se podívat do objektu detail, kde jsou dodávány objekty souhlasu s cookies. Každý objekt obsahuje kategorii a boolovskou hodnotu, zda ji uživatel povolil. Příklad tohoto objektu je:

{"detail": [
  {"category": "necessary", "allowed": true},
  {"category": "analytics", "allowed": false},
  {"category": "functional", "allowed": true},
  {"category": "marketing", "allowed": true}
]}
            

Statické skripty

Aby soubory cookie správně fungovaly, měli byste se ujistit, že pro daný skript uvádíte kategorii. Díky této kategorii pak může náš banner Cookienovo zajistit spuštění nebo nespuštění těchto skriptů na základě preferencí uživatele, které v banneru nastaví. Každý skript, který vyžaduje nějaký druh souhlasu se soubory cookie, by měl být definován následujícím způsobem:

Přidejte atribut cn-category s požadovanou kategorií souhlasu se soubory cookie. Možné hodnoty jsou:
- funkční
- marketing
- analytika
- nezbytné

Consent Mode

Our solution implements relevant Google Consent Mode features. This solution is automatic and does not require user or admin intervention. It sets upon loading the default consent state as mentioned here: Google Developer Documentation

On each users update we also set his consent state as mentioned here: Google Developer Documentation

Consent Mode v2

Our solution also complies with Googles Consent v2. This solution is automatic and does not require user or admin intervention.

For more information please visit relevant Google documentation here: Google Developer Documentation