Cookienovo

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:

< script >
window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments);}
gtag('consent','default',{'ad_storage':'denied','ad_personalization':'denied','ad_user_data':'denied','analytics_storage':'denied','functionality_storage':'denied','personalization_storage':'denied','security_storage':'granted','wait_for_update':500});
gtag('set','ads_data_redaction',true);
< / script >

< script site-token='' type='text/javascript' src='https://cookienovo.com/assets/client.js' defer>< / script >


            <!-- Step 1: Set consent defaults (simple) -->
<script src='https://cookienovo.com/assets/cmp.js'></script>

<!-- Step 2: Load Cookienovo banner (can use defer) -->
<script site-token='<site-token>' type='text/javascript' src='https://cookienovo.com/assets/client.js' defer></script>


            <!-- Step 1: Set consent defaults (with custom settings) -->
<script>
window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments);}
gtag('consent','default',{
  'ad_storage':'denied',
  'ad_personalization':'denied',
  'ad_user_data':'denied',
  'analytics_storage':'denied',
  'functionality_storage':'denied',
  'personalization_storage':'denied',
  'security_storage':'granted',
  'wait_for_update':500
});
gtag('set','ads_data_redaction',true);
</script>

<!-- Step 2: Load Cookienovo banner (can use defer) -->
<script site-token='<site-token>' type='text/javascript' src='https://cookienovo.com/assets/client.js' defer></script>

Musíte sa uistiť, že tento skript vložíte na začiatok prvku 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 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' cn-category='analytics'>
  // some analytic script
</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:


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

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


            {
  "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:


            < <a class="text-green-600">script</a> type =''text/javascript'' cn-category =''analytics'' ><a class="text-grey-600"><br />// some analytic script</a><br />< / <a class="text-green-600">script</a> >

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é

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

Naše riešenie plne vyhovuje Google Consent Mode v2. Cookienovo používa dvojdielnu inštaláciu, ktorá zabezpečuje, že predvolené nastavenia súhlasu sú nastavené pred spustením akýchkoľvek Google tagov:

Časť 1: Inline skript, ktorý synchrónne nastaví predvolené nastavenia Google Consent Mode v2 (ad_storage, analytics_storage, ad_personalization, ad_user_data sú všetky predvolene nastavené na 'denied')

Časť 2: Skript banneru Cookienovo (podporuje atribút defer pre lepší výkon)

Tento prístup sleduje priemyselné štandardy (rovnaké ako Cookiebot, CookieHub) a zabezpečuje súlad aj s asynchrónne načítanými Google tagmi. Predvolené nastavenia súhlasu zahŕňajú wait_for_update:500 a ads_data_redaction:true pre maximálnu ochranu súkromia.

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

Debug Functions

CookieNovo provides debug functions that you can run in your browser console to verify Consent Mode v2 implementation. Open your browser console (F12) on any page with CookieNovo installed and run:


            // Enable debug mode and run full validation
window.cookienovoDebug.enableDebugMode()

// Run only validation checks
window.cookienovoDebug.runFullValidation()

// Generate compliance report
window.cookienovoDebug.generateComplianceReport()

// Check consent mode status
window.cookienovoDebug.checkConsentMode()

// Test implementation
window.cookienovoDebug.testConsentModeImplementation()

// Check Shopify integration
window.cookienovoDebug.checkShopifyIntegration()

These functions will output detailed information about your Consent Mode v2 implementation, including: compliance score, detected Google tags, implementation issues, and actionable recommendations.

You can also use our online checker at Google Consent Mode v2 Checker to scan your website without opening the console.