Problém

  • Banner s informacemi o souborech cookie se při načtení stránky nezobrazuje.
  • Uživatelé nevidí žádost o souhlas.

Diagnostické kroky

Krok 1: Zkontrolujte, zda je načten modul TermsFeed Cookie Consent

// Open browser console and type:
console.log(typeof cookieconsent);

// Should output: "object"
// If "undefined", script didn't load

Krok 2: Zkontrolujte chyby JavaScriptu

  1. Otevřete DevTools (F12)
  2. Přejděte na kartu Console
  3. Vyhledejte chyby

Mezi běžné chyby patří:

  1. cookieconsent is not defined
  2. Uncaught ReferenceError
  3. Failed to load resource

Krok 3: Ověřte umístění skriptu TermsFeed Cookie Consent

Časté příčiny a řešení

Příčina 1: Uživatel již dal souhlas

// Check if user has cookie
console.log(document.cookie);
// Look for: cookie_consent_level=...

// To test banner, clear cookie:
document.cookie = 'cookie_consent_level=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/;';
// Then reload page

Příčina 2: Blokování reklam blokuje TermsFeed Cookie Consent

Řešením je integrace proxy serveru pro poskytování TermsFeed Cookie Consent.

Příčina 3: Zásady zabezpečení obsahu blokují načítání

Chyba v Nástrojích pro vývojáře > Konzola může být Refused to load the script ... violates the following Content Security Policy directive

Řešením je aktualizovat hlavičky CSP:

Content-Security-Policy: script-src 'self' www.termsfeed.com 'unsafe-inline'

Příčina 4: Nesprávná konfigurace

Časté chyby v konfiguraci:


// 1. Missing quotes
cookieconsent.run({
    consent_type: express  // ❌ Missing quotes
});

// 2. Trailing comma (IE issue)
cookieconsent.run({
    "consent_type": "express",  // ❌ Trailing comma
});

// 3. Missing DOMContentLoaded
cookieconsent.run({ / config / });  // ❌ Runs before DOM ready

// ✅ CORRECT:
document.addEventListener('DOMContentLoaded', function () {
    cookieconsent.run({
        "consent_type": "express",
        "website_name": "My Site",
        "language": "en"
    });
});

Příčina 5: Konflikt skriptů

Jiný skript může bránit zobrazení banneru TermsFeed Cookie Consent.

Řešením je zkontrolovat pořadí načítání skriptů.

// Test isolation
// Temporarily remove ALL other scripts
// Keep ONLY cookie consent
// If banner shows, you have a conflict

// Common conflicts:
// - Other cookie consent tools
// - Privacy plugins
// - Ad blockers (client-side)

Režim ladění

Zapněte ladicí protokolování:

cookieconsent.run({
    "consent_type": "express",
    "website_name": "My Site",
    "debug": true  // Enable debug logging
});

// Check console for debug messages:
// [CookieConsent] Banner initialized
// [CookieConsent] User has no consent
// [CookieConsent] Showing banner

Skripty nejsou blokovány

Problém

„Označil jsem svůj skript Google Analytics tagem data-cookie-consent='tracking', ale stále se spouští ještě předtím, než uživatel přijme soubory cookie!“

Diagnostické kroky

Krok 1: Ověřte označení skriptu

<!-- ❌ WRONG -->
<script type="text/javascript" data-cookie-consent="tracking">
  // GA code
</script>

<!-- ✅ CORRECT -->
<script type="text/plain" data-cookie-consent="tracking">
  // GA code
</script>

<!-- Key difference: type="text/plain" NOT type="text/javascript" -->

Krok 2: Zkontrolujte kartu Síť

  1. Otevřete DevTools → záložka Síť
  2. Vymažte soubory cookie
  3. Načtěte stránku znovu (před přijetím)
  4. Filtrujte podle svých sledovacích skriptů
  5. Skripty s tagy by se neměly zobrazovat na kartě Síť

Krok 3: Zkontrolujte, zda se ukládají soubory cookie

  1. DevTools → Aplikace → Soubory cookie
  2. Před přijetím: Žádné soubory cookie služby Google Analytics
  3. Po přijetí: Objeví se soubory cookie _ga, _gid

Časté příčiny a řešení

Příčina 1: Skript načten před souhlasem s cookies

<!-- ❌ WRONG ORDER -->
<script type="text/plain" data-cookie-consent="tracking">
  // GA code
</script>
<script src="//www.termsfeed.com/public/cookie-consent/4.2.0/cookie-consent.js"></script>

<!-- ✅ CORRECT ORDER -->
<script src="//www.termsfeed.com/public/cookie-consent/4.2.0/cookie-consent.js"></script>
<script>
document.addEventListener('DOMContentLoaded', function () {
    cookieconsent.run({ / config / });
});
</script>

<!-- NOW tag scripts below -->
<script type="text/plain" data-cookie-consent="tracking">
  // GA code
</script>

Příčina 2: Externí skript není blokován

<!-- ❌ External scripts need different approach -->
<script src="https://www.googletagmanager.com/gtag/js?id=G-XXX" data-cookie-consent="tracking"></script>

<!-- ✅ CORRECT - wrap in type="text/plain" -->
<script type="text/plain" data-cookie-consent="tracking">
  var script = document.createElement('script');
  script.src = 'https://www.googletagmanager.com/gtag/js?id=G-XXX';
  script.async = true;
  document.head.appendChild(script);

  script.onload = function() {
    // Initialize GA
    window.dataLayer = window.dataLayer || [];
    function gtag(){dataLayer.push(arguments);}
    gtag('js', new Date());
    gtag('config', 'G-XXX');
  };
</script>

Příčina 3: Používání Google Tag Manageru

Častým problémem je, když se GTM načte před souhlasem.

Řešením je neoznačovat samotný kontejner GTM. Místo toho:

  1. Načtěte GTM normálně (bez označování)
  2. Nakonfigurujte tagy UVNITŘ GTM tak, aby se spouštěly pouze po udělení souhlasu
  3. Použijte vestavěný režim souhlasu nebo vlastní spouštěče
<!-- Don't tag the GTM container -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-XXXX');</script>

<!-- Instead, push consent state to dataLayer -->
<script>
document.addEventListener('DOMContentLoaded', function () {
    cookieconsent.run({
        // ... config ...
        "callbacks": {
            "scripts_specific_loaded": (level) => {
                // Push to dataLayer
                window.dataLayer = window.dataLayer || [];
                window.dataLayer.push({
                    'event': 'cookie_consent_update',
                    'consent_level': level
                });
            }
        }
    });
});
</script>

<!-- Then in GTM, create trigger:
   Event: cookie_consent_update
   Condition: consent_level equals tracking
-->

Příčina 4: Soubory cookie nastavuje server

Pokud backendový server nastaví soubory cookie před spuštěním JavaScriptu, řešením je naprogramovat více logiky na straně serveru.

<?php
// Check if user has consented (server-side)
$hasConsent = false;
if (isset($_COOKIE['cookie_consent_level'])) {
    $consentLevel = json_decode(urldecode($_COOKIE['cookie_consent_level']), true);
    $hasConsent = in_array('tracking', $consentLevel);
}

// Only set analytics cookies if user consented
if ($hasConsent) {
    setcookie('analytics_id', $user_id, time() + 86400, '/');
}
?>

Souhlas není trvalý

Problém

„Uživatel přijme soubory cookie, ale když přejde na jinou stránku nebo stránku obnoví, banner se znovu zobrazí!“

Diagnostické kroky

Krok 1: Zkontrolujte, zda se nastavuje cookie

// After accepting, open console and run:
console.log(document.cookie);

// Should see something like:
// cookie_consent_level=%5B%22strictly-necessary%22%2C%22tracking%22%5D

Krok 2: Zkontrolujte vlastnosti cookie

// DevTools → Application → Cookies
// Look for: cookie_consent_level

// Check:
// ✓ Domain: Should match your domain
// ✓ Path: Should be /
// ✓ Expires: Should be future date (1 year)
// ✓ HttpOnly: Should be unchecked (JavaScript needs access)
// ✓ Secure: Depends on your settings
// ✓ SameSite: Strict or Lax

Časté příčiny a řešení

Příčina 1: Neshoda cesty souboru cookie

Problém

Soubor cookie je nastaven pro /subdir, ale stránka je na adrese /

Řešení

Ujistěte se, že soubor cookie používá kořenovou cestu.

// Cookie should be set for path=/
// This happens automatically, but verify in DevTools

// If using cookie_domain parameter, DON'T include path:
cookieconsent.run({
    "cookie_domain": ".example.com",  // ✅ No path needed
    // Other config...
});

Příčina 2: Blokování souborů cookie prohlížečem

Problém

Nastavení ochrany soukromí prohlížeče brání ukládání souborů cookie.

Řešení

Uživatel musí upravit nastavení prohlížeče.

// Detect if cookies are blocked
function areCookiesEnabled() {
    try {
        document.cookie = 'test=test; SameSite=Strict';
        const enabled = document.cookie.indexOf('test=') !== -1;
        document.cookie = 'test=; expires=Thu, 01 Jan 1970 00:00:00 UTC';
        return enabled;
    } catch (e) {
        return false;
    }
}

// Show warning if cookies disabled
if (!areCookiesEnabled()) {
    alert('Cookies are disabled in your browser. Please enable them to save your preferences.');
}

Příčina 3: Konflikt při mazání souborů cookie

Problém

Soubory cookie maže jiný skript nebo rozšíření prohlížeče.

Řešení

Zkontrolujte, co soubory cookie maže

// Check what's deleting cookies
// Add console log on page load:
console.log('Cookies on load:', document.cookie);

// If consent cookie is missing, something deleted it
// Common culprits:
// - Privacy extensions (Privacy Badger, uBlock)
// - Browser auto-delete (Firefox Enhanced Tracking Protection)
// - Another script calling document.cookie clear

Příčina 4: Problémy s subdoménami

Problém

Cookie nastavený na www.example.com nefunguje na example.com

Řešení

Použijte parametr cookie_domain.

cookieconsent.run({
    "cookie_domain": ".example.com",  // Note the leading dot!
    // This makes cookie valid for ALL subdomains
    // Other config...
});

Příčina 5: Nesoulad HTTPS/HTTP

Problém:

Cookie nastavený s příznakem Secure na HTTPS, ale web přepne na HTTP.

Řešení:

Zajistěte konzistentní protokol NEBO pro účely testování odstraňte příznak zabezpečení.

cookieconsent.run({
    "cookie_secure": false,  // Set to true ONLY if site is always HTTPS
    // Other config...
});

// For production HTTPS sites:
cookieconsent.run({
    "cookie_secure": true,  // ✅ Recommended for HTTPS
    // Other config...
});

Režim souhlasu Google nefunguje

Problém

„Implementoval jsem režim souhlasu Google V2, ale Google Analytics stále zobrazuje 0 událostí, i když uživatelé soubory cookie přijímají.“

Diagnostické kroky

Krok 1: Ověřte, zda existuje funkce gtag

// Open console:
console.log(typeof gtag);
// Should output: "function"

// If "undefined", gtag didn't load

Krok 2: Zkontrolujte dataLayer

// Check dataLayer contents:
console.log(window.dataLayer);

// Should see consent events:
// [{event: "consent", ...}, {event: "config", ...}]

Krok 3: Použijte Google Tag Assistant

  1. Instalace: Rozšíření Tag Assistant pro Chrome
  2. Povolte ladění
  3. Obnovte stránku
  4. Zkontrolujte události v režimu souhlasu

Časté příčiny a řešení

Příčina 1: Nesprávné pořadí implementace

<!-- ❌ WRONG ORDER -->
<script src="//www.termsfeed.com/public/cookie-consent/4.2.0/cookie-consent.js"></script>
<script>
gtag('consent', 'default', {'analytics_storage': 'denied'});
</script>

<!-- ✅ CORRECT ORDER -->
<!-- 1. Set default consent FIRST -->
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('consent', 'default', {
    'ad_storage': 'denied',
    'analytics_storage': 'denied'
});
</script>

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

<!-- 3. THEN Cookie Consent -->
<script src="//www.termsfeed.com/public/cookie-consent/4.2.0/cookie-consent.js"></script>
<script>
document.addEventListener('DOMContentLoaded', function () {
    cookieconsent.run({
        // ... config with callbacks ...
    });
});
</script>

Příčina 2: Chybějící parametr callbacks_force

// ❌ Without callbacks_force, callbacks won't fire for Consent Mode
cookieconsent.run({
    "callbacks": {
        "scripts_specific_loaded": (level) => {
            gtag('consent', 'update', {'analytics_storage': 'granted'});
        }
    }
    // Missing: "callbacks_force": true
});

// ✅ CORRECT
cookieconsent.run({
    "callbacks": {
        "scripts_specific_loaded": (level) => {
            gtag('consent', 'update', {'analytics_storage': 'granted'});
        }
    },
    "callbacks_force": true  // Required for Consent Mode!
});

Příčina 3: Překlep v typech souhlasu

// ❌ Common typos:
gtag('consent', 'update', {
    'analytic_storage': 'granted'  // ❌ Missing 's'
});

gtag('consent', 'update', {
    'ad_store': 'granted'  // ❌ Should be 'ad_storage'
});

// ✅ CORRECT spellings:
gtag('consent', 'update', {
    'analytics_storage': 'granted',  // ✅
    'ad_storage': 'granted',         // ✅
    'ad_user_data': 'granted',       // ✅
    'ad_personalization': 'granted'  // ✅
});

Příčina 4: Nesprávné přiřazení kategorií

// Make sure you're mapping correct categories
"callbacks": {
    "scripts_specific_loaded": (level) => {
        switch (level) {
            case 'tracking':  // ✅ Analytics
                gtag('consent', 'update', {
                    'analytics_storage': 'granted'
                });
                break;
            case 'targeting':  // ✅ Advertising
                gtag('consent', 'update', {
                    'ad_storage': 'granted',
                    'ad_user_data': 'granted',
                    'ad_personalization': 'granted'
                });
                break;
        }
    }
}

Testování režimu souhlasu

// After accepting cookies, check consent state:
console.log(google_tag_manager['GTM-XXXX'].dataLayer.get('consent'));

// Should show:
// {
//   ad_storage: "granted",
//   analytics_storage: "granted",
//   ...
// }

Problémy s doménami

Problém

„Nastavil jsem cookie_domain na ‚.example.com‘, ale banner se stále zobrazuje na všech subdoménách. Uživatelé jsou tím otrávení!“

Diagnostické kroky

Krok 1: Ověřte doménu cookie

// DevTools → Application → Cookies
// Look for: cookie_consent_level
// Domain column should show: .example.com (with leading dot)

// If it shows: www.example.com (no dot)
// Then cookie_domain parameter isn't working

Krok 2: Zkontrolujte cookie z subdomény

// On www.example.com:
console.log(document.cookie);
// Should include: cookie_consent_level=...

// Then navigate to shop.example.com:
console.log(document.cookie);
// Should STILL include the same cookie

Krok 3: Otestujte v anonymním režimu

  1. Otevřete okno v anonymním režimu
  2. Navštivte www.example.com
  3. Přijměte soubory cookie
  4. Poznamenejte si hodnotu souboru cookie
  5. Navštivte shop.example.com
  6. Zkontrolujte, zda existuje stejný soubor cookie

Časté příčiny a řešení

Příčina 1: Chybějící úvodní tečka

// ❌ WRONG
"cookie_domain": "example.com"  // No leading dot

// ✅ CORRECT
"cookie_domain": ".example.com"  // With leading dot

Příčina 2: Odlišné konfigurace

Problém

Hlavní doména a subdoména mají odlišné konfigurace.

// www.example.com has:
cookieconsent.run({
    "website_name": "Main Site",
    "cookie_domain": ".example.com"
});

// shop.example.com has:
cookieconsent.run({
    "website_name": "Shop",  // ❌ Different config
    "cookie_domain": ".example.com"
});

Řešení

Použijte STEJNOU konfiguraci na všech doménách.

// ✅ SOLUTION: Use IDENTICAL configuration on all domains
const SHARED_CONFIG = {
    "notice_banner_type": "headline",
    "consent_type": "express",
    "website_name": "Example",  // Same everywhere
    "cookie_domain": ".example.com",
    // ... rest of config
};

// Use on ALL domains
cookieconsent.run(SHARED_CONFIG);

Příčina 3: Prohlížeč blokuje soubory cookie třetích stran

Problém

Safari, Firefox a Brave ve výchozím nastavení blokují soubory cookie mezi weby.

Řešení

Toto se týká RŮZNÝCH domén, nikoli subdomén.

  • Subdomény (.example.com) = Soubory cookie první strany ✅ Mělo by fungovat
  • Různé TLD (example.com vs example.co.uk) = Třetí strany ❌ Nebude fungovat
// For actual cross-domain (different TLDs), use backend sync:
"callbacks": {
    "user_consent_saved": () => {
        // Sync to backend
        fetch('https://api.example.com/sync-consent', {
            method: 'POST',
            body: JSON.stringify({
                consent: getConsentState(),
                user_id: getUserId()
            })
        });
    }
}

Příčina 4: Cookie není viditelný kvůli cestě

// Cookie might be set for specific path
// Check: DevTools → Application → Cookies → Path column

  // Should be: /
// If not, cookie won't work across site

// Force root path (this should be default):
// Note: TermsFeed Cookie Consent should handle this automatically
// But if you're manually setting cookies:
document.cookie = 'cookie_consent_level=...; path=/; domain=.example.com';

Problémy s kódováním znaků

Problém

„Zvláštní znaky v textu mého banneru se zobrazují jako �� nebo podivné symboly“

Řešení

Zajistěte kódování UTF-8.

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">  <!-- ✅ Must have this -->
    <title>My Site</title>
</head>
<body>
    <script src="//www.termsfeed.com/public/cookie-consent/4.2.0/cookie-consent.js" charset="UTF-8"></script>
    <!-- ✅ charset="UTF-8" in script tag -->
</body>
</html>

Pro vlastní text:

cookieconsent.run({
    "website_name": "Café Français",  // ✅ UTF-8 characters work
    "language": "fr"  // Use appropriate language
});