Dokumentace

Vše, co potřebujete vědět pro rychlou implementaci Consentio

Instalace

Detailní návod na instalaci Consentio widget na váš web

Požadavky

Pro správnou funkci Consentio není potřeba žádný speciální software ani závislosti. Widget funguje na všech moderních prohlížečích:

  • Chrome 60+
  • Firefox 55+
  • Safari 12+
  • Edge 79+
  • Opera 47+

Získání instalačního kódu

Po přidání webu do Consentio dashboardu získáte unikátní instalační kód. Najdete ho v sekci Moje weby → váš web → Instalace.

HTML
<script src="https://consentio.cz/widget/YOUR_SCRIPT_KEY/consentio.min.js" async></script>
Důležité: Hodnota YOUR_SCRIPT_KEY je unikátní pro každý web. Klíč najdete v dashboardu v sekci Instalace. Nepoužívejte kód z jiného webu.

Umístění kódu

Kód vložte hned za otevírací tag <head>, před všechny Google tagy (gtag.js, Google Tag Manager). Jeho první část nastaví Google Consent Mode na „zamítnuto“ a Google tagy ji musí najít už na místě:

HTML
<!DOCTYPE html>
<html lang="cs">
<head>
  <meta charset="UTF-8">
  <title>Můj web</title>

  <!-- Consentio: hned za <head>, před všemi Google tagy -->
  <script src="https://consentio.cz/widget/YOUR_SCRIPT_KEY/consentio.min.js" async></script>

  <!-- Google tagy a ostatní skripty až za kódem Consentio -->
  <script>/* Google Analytics atd. */</script>
</head>
<body>
  ...
</body>
</html>

Když kód nemůže být první

Skripty, které označíte, lišta zadrží při jakémkoli umístění kódu. U Google tagů to neplatí: tag, který se načte nad kódem, začne měřit dřív, než si návštěvník vybere. Pokud kód nad Google tagy umístit nemůžete, označte je atributy type="text/plain" a data-category, aby čekaly na souhlas.

Ověření instalace

Po vložení kódu můžete instalaci ověřit několika způsoby:

1. Vizuální kontrola

Otevřete svůj web v anonymním okně prohlížeče. Měla by se zobrazit cookie lišta.

2. DevTools konzole

Otevřete Developer Tools (F12) a do konzole zadejte tento příkaz. Vrátí číslo verze widgetu, například 1.3.0:

Console
Consentio.version

3. Network tab

V Network tabu by měl být úspěšný požadavek na consentio.cz/widget/.../consentio.min.js se statusem 200.

4. Consentio dashboard

Jakmile v liště kliknete na některé tlačítko, vaše volba se objeví v sekci Moje weby → váš web → Evidence souhlasů.

Řešení problémů

Lišta se nezobrazuje

  • Zkontrolujte, zda je kód správně vložen (zobrazí se ve zdrojovém kódu stránky)
  • Ověřte, že SCRIPT_KEY v URL odpovídá vašemu webu v dashboardu
  • Podívejte se do konzole: varování Widget not authorized for this domain znamená, že stránka běží na jiné doméně, než jakou máte zadanou v dashboardu (subdomény projdou)
  • Pokud jste už na webu volbu udělali, lišta se znovu nezobrazí, jen plovoucí tlačítko. Zkuste anonymní okno
  • Prohlížeč, který posílá Global Privacy Control nebo Do Not Track, bereme jako odmítnutí: lišta se nezobrazí, jen plovoucí tlačítko

Chyba 403/404

Pokud se v konzoli objeví chyba při načítání widgetu, příčinu poznáte podle kódu:

  • 404: klíč v adrese skriptu neexistuje. Zkopírujte kód znovu ze záložky Instalace (po vygenerování nového klíče přestává starý platit)
  • 403: web není ve vašem účtu Consentio aktivní
  • Při obou chybách se lišta nenačte; označené skripty zůstanou zablokované a Google tagy ve stavu „zamítnuto“
Tip: Pokud máte stále problémy, kontaktujte naši podporu na info@consentio.cz.
Rychlý startWordPress