Zdroje pre vývojárov Cookienovo

Nižšie sú uvedené technické informácie o banneri Cookienovo, ktorý je určený predovšetkým pre vývojárov. V budúcnosti sa plánuje rozšírenie tejto funkcie o ďalšie veci vhodné pre vývojárov, ako sú obsluhy udalostí a priamy prístup k súborom cookie.

Vloženie skriptu

Aby vaša webová stránka mala sledovací banner Cookienovo a súhlas používateľov so súbormi cookie, musíte do zdrojového kódu svojej webovej stránky vložiť náš skript, ktorý ste dostali poštou pri registrácii. Tento skript nájdete aj vo svojom účte na webovej lokalite Cookienovo. Tento skript by mal vyzerať približne takto:

Musíte sa uistiť, že tento skript vložíte na začiatok prvku < head > webovej stránky. Uistite sa, že atribúty type a src sú správne nastavené, ako je znázornené na tomto obrázku.

Poznámka: Keďže banner Cookienovo pracuje s GTM (Google Tag Manager), uistite sa, že ste vložili skript Cookienovo do prvku < head > pred inicializačnú časť GTM.

Značky skriptov

Náš banner Cookienovo obsahuje dve značky, ktoré si teraz môžete nakonfigurovať, a v budúcnosti sa plánuje rozšíriť o ďalšie značky.

site-token: Toto je povinné a musí byť nastavené na základe ID, ktoré ste dostali poštou alebo na našej webovej stránke. Uistite sa, že ste nastavili správne UUID, inak sa banner Cookien nezobrazí.
- UUID

theme: Pomocou tohto nastavenia môžete definovať motív bannera tak, aby bol vždy v svetlom alebo tmavom režime.
- "light"
- "dark"

consent-mode: Pomocou tohto nastavenia môžete prepísať režim súhlasu nastavený bannerom. Predvolená hodnota je true. Nastavte túto hodnotu na "false", ak nechcete odosielať súhlas používateľov.
- "true"
- "false"

Spracovanie udalostí

Ak chcete spracovať súhlas používateľa sami v iných skriptoch, môžete pridať počúvač udalostí na CookienovoUserConsentChanged. Príklad toho by mohol vyzerať niečo takto:

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

Ak chcete získať skutočné hodnoty, ktoré používateľ vybral, môžete sa pozrieť do objektu detail, kde sú dodávané objekty súhlasu s cookies. Každý objekt obsahuje kategóriu a boolovskú hodnotu, či ju používateľ povolil. Príklad tohto objektu je:

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

Statické skripty

Aby súbory cookie fungovali správne, mali by ste sa uistiť, že ste pre skript určili kategóriu. Pomocou tejto kategórie potom náš banner Cookienovo môže zabezpečiť, aby sa tieto skripty spustili alebo nespustili na základe preferencií používateľa, ktoré nastavil v banneri. Každý skript, ktorý vyžaduje nejaký druh súhlasu so súbormi cookie, by mal byť definovaný nasledovne:

Pridajte atribút cn-category s požadovanou kategóriou súhlasu so súbormi cookie. Možné hodnoty sú:
- funkčné
- marketing
- analytika
- potrebné