Dokumentácia

Všetko, čo potrebujete vedieť na rýchlu implementáciu Consentio

Vlastný web

Pokročilá implementácia Consentio pre vývojárov

Základná implementácia

Na základnú implementáciu stačí vložiť jeden riadok kódu hneď za otvárací tag <head>, pred všetky Google tagy:

HTML
<script src="https://consentio.cz/widget/YOUR_SCRIPT_KEY/consentio.min.js" async></script>

Widget sa automaticky inicializuje a pri prvom načítaní stránky zobrazí cookie lištu. Kód s vaším jedinečným SCRIPT_KEY nájdete v dashboarde v sekcii Moje weby → váš web → Inštalácia.

Tip: Identifikácia webu je súčasťou URL (SCRIPT_KEY), žiadne ďalšie dátové atribúty nie sú potrebné. Jazyk lišty sa riadi atribútom lang na elemente <html>, a to v rámci jazykov, ktoré máte zapnuté (pozri Jazyky).

JavaScript API

Po načítaní widgetu je dostupný globálny objekt window.Consentio na programové ovládanie. Widget sa načítava asynchrónne, takže kód, ktorý beží pri načítaní stránky, nemôže počítať s tým, že objekt už existuje. Ako naň počkať, ukazujú príklady nižšie.

Dostupné metódy

Metóda Popis
show() Zobrazí cookie banner
hide() Skryje cookie banner
showPreferences() Zobrazí nastavenie preferencií
getConsent() Vráti voľbu návštevníka, alebo null, kým si návštevník nevybral
updateConsent(updates) Zmení voľbu, ktorú už návštevník urobil. Pred prvou voľbou neurobí nič; pri odvolaní kategórie stránku znova načíta
onConsentChange(callback) Zavolá callback po každej voľbe a raz pri každom načítaní stránky, ak je voľba už uložená. Callback zaregistrovaný neskôr sa zavolá raz s aktuálnou voľbou
getBlockedScripts() Vráti objekt s počtom doteraz zadržaných skriptov v každej kategórii (označených aj zadržaných automaticky), napr. { marketing: 2 }
getBlockedIframes() Vráti rovnaký objekt pre označené iframe

Zobrazenie lišty

JavaScript
// Volajte až po načítaní widgetu, napríklad z obsluhy kliknutia.
// Zápis window.Consentio?. volanie preskočí, ak widget ešte nie je načítaný.

// Zobraziť cookie lištu
window.Consentio?.show()

// Skryť cookie lištu
window.Consentio?.hide()

// Zobraziť nastavenie preferencií
window.Consentio?.showPreferences()

Získanie stavu súhlasov

JavaScript
// Voľba návštevníka, alebo null, kým si nevybral
const consent = window.Consentio?.getConsent()
// { necessary: true, functionality: false, analytics: false, marketing: false }

// Pred čítaním kategórie vždy počítajte s hodnotou null
if (consent?.analytics) {
  // Analytika je povolená
}

if (consent?.marketing) {
  // Marketing je povolený
}

// Skript, ktorý má čakať na súhlas, načítavajte cez onConsentChange (nižšie)

Aktualizácia súhlasov

JavaScript
// Zmení voľbu, ktorú už návštevník urobil; pred prvou voľbou neurobí nič.
// Volajte len z akcie samotného návštevníka (napríklad z vlastného prepínača):
// zaznamená sa ako jeho voľba.
window.Consentio?.updateConsent({
  analytics: true,
  marketing: false
})
// Vypnutie kategórie, ktorá bola zapnutá, stránku znova načíta

Event listenery

Obe možnosti sa spustia po každej voľbe a raz pri každom načítaní stránky, ak je voľba už uložená. Na jednej stránke sa môžu spustiť viackrát, preto skript načítavajte len raz a nikdy z nich stránku znova nenačítavajte.

JavaScript
// Možnosť 1: onConsentChange. Funguje z akéhokoľvek kódu, aj z toho, ktorý beží neskôr
// (bundle, hook frameworku): callback zaregistrovaný neskôr sa zavolá raz
// s aktuálnou voľbou. Widget sa načítava asynchrónne, preto naň počkajte:
function onConsent(callback) {
  if (window.Consentio) {
    Consentio.onConsentChange(callback)
  } else {
    window.addEventListener('consentio:consent', (event) => callback(event.detail))
  }
}

let analyticsLoaded = false
onConsent((consent) => {
  if (consent.analytics && !analyticsLoaded) {
    analyticsLoaded = true
    loadGoogleAnalytics()
  }
})

// Možnosť 2: udalosť na window. Neopakuje sa, preto listener zaregistrujte
// v inline skripte priamo v HTML stránky, skôr než sa stránka dočíta.
window.addEventListener('consentio:consent', (event) => {
  const consent = event.detail
  console.log('Súhlas:', consent)
})

Google Consent Mode v2

Consentio posiela signály Google Consent Mode v2 za vás. Jedinou podmienkou je, aby bol jeho kód na stránke pred Google Analytics a ďalšími Google tagmi: jeho prvá časť nastaví všetko na „zamietnuté“ skôr, ako si to Google prečíta.

Basic, alebo Advanced?

Consentio posiela Googlu signály súhlasu vo všetkých plánoch. V akom režime vaše Google skripty bežia, určuje spôsob ich vloženia na web:

  • Advanced (štandardná inštalácia, ukážka nižšie) — gtag.js sa načíta hneď a pred súhlasom posiela Googlu anonymné pingy bez cookies, z ktorých GA4 modeluje konverzie. Z pohľadu ePrivacy ide o šedú zónu: dáta odchádzajú ešte pred súhlasom.
  • Basic (blokovaný skript) — gtag.js vložíte ako <script type="text/plain" data-category="analytics">. Načíta sa až po súhlase a Google pred ním nedostane nič. Najbezpečnejšia možnosť, prichádzate len o modelované dáta.

Odporúčame Basic. Advanced zvoľte vedome, ak modelované dáta v GA4 a Google Ads naozaj potrebujete.

HTML
<!-- 1. Najprv kód Consentio, nad všetkými Google tagmi (bez async) -->
<script src="https://consentio.cz/widget/YOUR_SCRIPT_KEY/consentio.min.js"></script>

<!-- 2. Potom Google tag -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXX"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());
  gtag('config', 'G-XXXXXXX');
</script>

Mapovanie kategórií na Consent Mode

Kategória Consentio Google Consent Mode
necessary žiadny (security_storage je vždy povolený)
analytics analytics_storage
marketing ad_storage, ad_user_data, ad_personalization
functionality functionality_storage, personalization_storage

Automatické blokovanie známych služieb

Skripty známych meracích a reklamných služieb Consentio rozpozná podľa adresy a zadrží ich samo, kým návštevník nepovolí ich kategóriu. V kóde webu nemusíte nič meniť. Platí to aj pre skripty, ktoré na stránku neskôr pridá správca značiek alebo iný kód.

  • Analytické: Hotjar, Microsoft Clarity, Smartlook, Mouseflow, FullStory, Mixpanel, Amplitude, Heap, Segment, Crazy Egg, Lucky Orange, Yandex Metrica
  • Marketingové: Meta Pixel, TikTok Pixel, LinkedIn Insight Tag, Microsoft Advertising (UET), Pinterest Tag, X (Twitter) Pixel, Snapchat Pixel, Reddit Pixel, Quora Pixel, Criteo, Taboola, Outbrain, AdRoll, Adform, RTB House, HubSpot, Klaviyo, Mailchimp, Sklik, Heureka (meranie konverzií), Glami Pixel, Leady

Google tagy (Google Analytics, Google Ads, Tag Manager) sa neblokujú: zostávajú načítané a riadia sa signálmi Consent Mode. Chat, vložené videá a mapy Consentio samo nezadrží, pretože by to zmenilo, čo návštevník na stránke vidí; tie označte ručne podľa návodu nižšie.

Kedy automatika nestačí: zadržať sa dá len skript, ktorý sa ešte nespustil. Kód Consentio sa načítava asynchrónne, takže pri úplne prvej návšteve sa skript vložený priamo do stránky môže spustiť skôr, ako Consentio dorazí. Jeho cookies potom Consentio zmaže, ale prvé zobrazenie stránky už služba zaznamenala. Od druhej stránky má prehliadač kód Consentio spravidla uložený a spúšťa ho ako prvý. Istotu už od prvej stránky dáva ručné označenie skriptu (nižšie) alebo kód Consentio vložený bez async ako prvý skript v <head>.

Výnimka pre jednu službu: pridajte jej tagu data-category="necessary" a Consentio ju nechá bežať. Vypnutie pre celý web: v dashboarde v Designeri, sekcia Správanie, prepínač „Automaticky blokovať známe meracie a reklamné skripty“.

Blokovanie skriptov

Na blokovanie skriptov pred udelením súhlasu použite atribút type="text/plain" s dátovým atribútom data-category:

HTML
<!-- Skript sa spustí až po udelení súhlasu s analytics -->
<script type="text/plain" data-category="analytics">
  // Kód Google Analytics
  gtag('config', 'G-XXXXXXX');
</script>

<!-- Skript sa spustí až po udelení súhlasu s marketing -->
<script type="text/plain" data-category="marketing">
  // Kód Facebook Pixel
  fbq('init', 'XXXXXXX');
</script>

<!-- Skript sa spustí až po udelení súhlasu s functionality -->
<script type="text/plain" data-category="functionality">
  // Personalizačný kód
  initPersonalization();
</script>

Dostupné kategórie

Kategória Popis
necessary Nevyhnutné cookies (vždy povolené)
analytics Analytické cookies
marketing Marketingové cookies
functionality Funkčné cookies na personalizáciu

Tlačidlo na otvorenie preferencií

Plávajúce tlačidlo na zmenu voľby sa zobrazuje vždy. Navyše môžete pridať vlastný odkaz alebo tlačidlo, ktoré preferencie otvorí:

HTML
<!-- V pätičke webu -->
<a href="#" onclick="Consentio.showPreferences(); return false;">
  Nastavenia cookies
</a>

<!-- Alebo ako tlačidlo -->
<button onclick="Consentio.showPreferences()">
  Upraviť preferencie cookies
</button>
Tip: Návštevník musí mať možnosť svoju voľbu kedykoľvek zmeniť alebo odvolať. To zabezpečuje plávajúce tlačidlo; s odkazom v pätičke alebo v zásadách ochrany osobných údajov ju nájde ľahšie.

Single Page Applications (SPA)

Widget funguje aj v Reacte, Vue, Angulari a ďalších SPA frameworkoch. Zachytí zmenu URL, znova pošle Googlu stav súhlasu a spustí novo pridané označené skripty, ktorých kategória je povolená.

JavaScript
// Príklad: Kontrola stavu súhlasov pri zmene route (Vue Router)
router.afterEach(() => {
  // null, kým si návštevník nevybral
  const consent = window.Consentio?.getConsent()
  if (consent?.analytics) {
    // Analytické skripty sú povolené
  }
})
ShoptetGoogle Tag Manager