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:
<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.
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
// 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
// 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
// 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.
// 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.
<!-- 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.
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:
<!-- 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í:
<!-- 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>
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á.
// 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é
}
})