O banner não aparece

Problema

  • O banner de cookies não aparece quando a página é carregada.
  • Os utilizadores não veem o pedido de consentimento.

Passos de diagnóstico

Passo 1: Verifique se o TermsFeed Cookie Consent está carregado

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

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

Passo 2: Verifique se há erros de JavaScript

  1. Abra o DevTools (F12)
  2. Vá para o separador Console
  3. Procure erros

Os erros comuns incluem:

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

Passo 3: Verifique a localização do script de consentimento de cookies do TermsFeed

<!-- ❌ WRONG - Script in <head> without async -->
<head>
    <script src="//www.termsfeed.com/public/cookie-consent/4.2.0/cookie-consent.js"></script>
    <script>
        cookieconsent.run({ / config / });
    </script>
</head>

<!-- ✅ CORRECT - Script before </body> with DOMContentLoaded -->
<body>
    <!-- content -->

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

Causas comuns e soluções

Causa 1: O utilizador já deu o seu consentimento

// 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

Causa 2: Um bloqueador de anúncios está a bloquear o TermsFeed Cookie Consent

A solução é integrar um servidor proxy para servir o TermsFeed Cookie Consent.

Causa 3: A Política de Segurança de Conteúdo bloqueia o carregamento

O erro em Ferramentas do Desenvolvedor > Console pode ser Refused to load the script ... violates the following Content Security Policy directive

A solução é atualizar os cabeçalhos CSP:

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

Causa 4: Configuração incorreta

Erros comuns na configuração:


// 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"
    });
});

Causa 5: Scripts em conflito

Outro script pode impedir que o banner do TermsFeed Cookie Consent seja exibido.

A solução é verificar a ordem de carregamento dos scripts.

// 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)

Modo de depuração

Ativar registo de depuração:

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

Os scripts não estão a ser bloqueados

Problema

«Marquei o meu script do Google Analytics com data-cookie-consent='tracking', mas continua a ser executado antes de o utilizador aceitar os cookies!»

Passos de diagnóstico

Passo 1: Verifique a marcação do script

<!-- ❌ 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" -->

Passo 2: Verifique o separador Rede

  1. Abra o DevTools → separador Rede
  2. Limpe os cookies
  3. Recarregue a página (antes de aceitar)
  4. Filtre os seus scripts de rastreamento
  5. Os scripts marcados NÃO devem aparecer no separador Rede

Passo 3: Verifique se os cookies estão a ser definidos

  1. DevTools → Aplicação → Cookies
  2. Antes de aceitar: Não há cookies do Google Analytics
  3. Após aceitar: aparecem os cookies _ga e _gid

Causas comuns e soluções

Causa 1: Script carregado antes do consentimento de 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>

Causa 2: Script externo não está bloqueado

<!-- ❌ 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>

Causa 3: Utilização do Google Tag Manager

O problema comum ocorre quando o GTM é carregado antes do consentimento.

A solução consiste em não marcar o próprio contentor do GTM. Em vez disso:

  1. Carregue o GTM normalmente (sem marcar)
  2. Configure as tags DENTRO do GTM para serem acionadas apenas com o consentimento
  3. Utilize o Modo de Consentimento integrado ou gatilhos personalizados
<!-- 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
-->

Causa 4: Os cookies são definidos pelo servidor

Se um servidor backend definir cookies antes da execução do JavaScript, a solução é codificar mais lógica do lado do servidor.

<?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, '/');
}
?>

O consentimento não está a ser mantido

Problema

«O utilizador aceita os cookies, mas quando navega para outra página ou atualiza a página, o banner aparece novamente!»

Passos de diagnóstico

Passo 1: Verifique se está a ser definido um 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

Passo 2: Verifique as propriedades do 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

Causas comuns e soluções

Causa 1: Incompatibilidade do caminho do cookie

Problema

O cookie foi definido para /subdir, mas a página está em /

Solução

Certifique-se de que o cookie utiliza o caminho raiz.

// 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...
});

Causa 2: Navegador a bloquear cookies

Problema

As definições de privacidade do navegador impedem o armazenamento de cookies.

Solução

O utilizador deve ajustar as definições do navegador.

// 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.');
}

Causa 3: Eliminação de cookies em conflito

Problema

Outro script ou extensão do navegador elimina os cookies.

Solução

Verifique o que está a eliminar os cookies

// 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

Causa 4: Problemas com subdomínios

Problema

O cookie definido em www.example.com não funciona em example.com

Solução

Utilize o parâmetro cookie_domain.

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

Causa 5: Incompatibilidade entre HTTPS e HTTP

Problema:

O cookie foi definido com o sinalizador Secure em HTTPS, mas o site muda para HTTP.

Solução:

Certifique-se de que o protocolo é consistente OU remova o sinalizador de segurança para efeitos de teste.

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...
});

O Modo de Consentimento do Google não está a funcionar

Problema

«Implementei o Modo de Consentimento do Google V2, mas o Google Analytics continua a mostrar 0 eventos, mesmo quando os utilizadores aceitam cookies.»

Passos de diagnóstico

Passo 1: Verifique se a função gtag existe

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

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

Passo 2: Verifique o dataLayer

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

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

Passo 3: Utilize o Google Tag Assistant

  1. Instalar: Extensão do Tag Assistant para o Chrome
  2. Ativar depuração
  3. Atualizar a página
  4. Verifique se há eventos no modo de consentimento

Causas comuns e soluções

Causa 1: Ordem de implementação incorreta

<!-- ❌ 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>

Causa 2: Falta do parâmetro 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!
});

Causa 3: Erro ortográfico nos tipos de consentimento

// ❌ 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'  // ✅
});

Causa 4: Mapeamento de categorias incorreto

// 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;
        }
    }
}

Testar o modo de consentimento

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

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

Problemas entre domínios

Problema

«Defini o cookie_domain como '.example.com', mas o banner continua a aparecer em todos os subdomínios. Os utilizadores estão irritados!»

Passos de diagnóstico

Passo 1: Verifique o domínio do 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

Passo 2: Verifique o cookie do subdomínio

// 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

Passo 3: Teste no modo de navegação anónima

  1. Abrir janela de navegação anónima
  2. Visite www.example.com
  3. Aceite os cookies
  4. Anote o valor do cookie
  5. Visite shop.example.com
  6. Verifique se existe o mesmo cookie

Causas comuns e soluções

Causa 1: Falta do ponto inicial

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

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

Causa 2: Configurações diferentes

Problema

O domínio principal e o subdomínio têm configurações diferentes.

// 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"
});

Solução

Utilize uma configuração IDÊNTICA em todos os domínios.

// ✅ 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);

Causa 3: Navegador a bloquear cookies de terceiros

Problema

O Safari, o Firefox e o Brave bloqueiam cookies entre sites por predefinição.

Solução

Isto afeta domínios DIFERENTES, não subdomínios.

  • Subdomínios (.example.com) = Cookies próprios ✅ Deve funcionar
  • TLDs diferentes (example.com vs example.co.uk) = Terceiros ❌ Não funcionará
// 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()
            })
        });
    }
}

Causa 4: Cookie não visível devido ao caminho

// 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';

Problemas de codificação de caracteres

Problema

«Os caracteres especiais no texto do meu banner aparecem como �� ou símbolos estranhos»

Solução

Certifique-se de que a codificação é 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>

Para texto personalizado:

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