Guia de Solução de Problemas

Soluções para problemas comuns do CookieBeam. Se você não encontrar sua resposta, envie um e-mail para support@cookiebeam.com

Acesso Rápido:

Problemas de Exibição do Banner Problemas com o Google Tag Manager Problemas com o Consent Mode v2 Problemas com Varredura de Cookies Problemas de Desempenho

Problemas de Exibição do Banner

O banner não aparece no meu site

Verifique se o script foi carregado

1. Abra seu site no Chrome
2. Pressione F12 para abrir as Ferramentas de Desenvolvedor
3. Vá para a aba "Rede"
4. Atualize a página
5. Pesquise por "cookiebeam" no filtro
6. Se você vir um status 200, o script foi carregado com sucesso

Verifique o ID do Banner

1. Vá para o painel do CookieBeam
2. Clique no seu banner → aba Instalação
3. Copie o ID do seu Banner
4. Verifique se ele corresponde ao ID no código do seu site
5. Erro comum: Usar o ID errado ou deixar o placeholder "YOUR-BANNER-ID"

Verifique erros de JavaScript

1. Abra as Ferramentas de Desenvolvedor do Chrome (F12)
2. Vá para a aba "Console"
3. Procure por mensagens de erro em vermelho
4. Se você vir "CookieBeam is not defined" ou similar, o script não está carregando
5. Carregue o script do banner de forma síncrona como o primeiro elemento no head da página, sem async ou defer.

Limpar cache

1. Atualize forçadamente o navegador: Ctrl+Shift+R (Windows) ou Cmd+Shift+R (Mac)
2. Ou limpe completamente o cache do navegador
3. Tente no modo anônimo/privado para testar

O banner aparece no desktop, mas não no celular

Verifique as configurações responsivas

1. Vá para Designer de Banner → Layout
2. Certifique-se de que "Responsivo para Celular" está habilitado
3. Teste diferentes tamanhos de tela nas Ferramentas de Desenvolvedor (F12 → Barra de Dispositivos)
4. Verifique se há CSS conflitante no celular

O banner aparece, mas está quebrado/sem estilo

Conflito de CSS

1. O CSS do seu site pode estar sobrepondo os estilos do banner
2. Adicione prioridade !important no CSS personalizado do CookieBeam
3. Ou aumente a especificidade do CSS nas configurações do banner
4. Verifique o console do navegador para erros de CSS

O banner aparece toda vez que visito (não lembra da escolha)

Problemas de armazenamento de cookies

1. Verifique se seu navegador bloqueia cookies de terceiros
2. Verifique se o localStorage está habilitado (necessário para armazenamento de consentimento)
3. Verifique se você está no modo privado/anônimo (cookies não persistem)
4. Certifique-se de que o cookie de consentimento não está sendo excluído por outro script

Problemas com o Google Tag Manager

O banner não dispara no modo de visualização do GTM

Verifique a configuração da tag

1. Abra o modo de visualização do GTM
2. Procure a tag "CookieBeam Consent" na lista de tags
3. Verifique se mostra "Tags Disparadas" e não "Tags Não Disparadas"
4. Se não disparou, verifique a configuração do acionador
5. Use o acionador "Consent Initialization - All Pages"

Tag disparando, mas o banner não aparece

1. Abra o console do navegador (F12)
2. Procure o carregamento do script CookieBeam
3. Verifique se o ID do Banner está correto no código da tag GTM
4. Verifique se a URL do script é: https://cdn.cookiebeam.com/banner/...

Outras tags ainda disparam sem consentimento

Configure os requisitos de consentimento

1. Abra cada tag GA4/Google Ads no GTM
2. Vá para Configurações Avançadas → Configurações de Consentimento
3. Habilite "Exigir consentimento adicional para disparar a tag"
4. Para GA4: Selecione "Analytics Storage"
5. Para Google Ads: Selecione "Ad Storage" e "Analytics Storage"
6. Salve e publique

Certifique-se de que o CookieBeam carrega primeiro

1. A tag do CookieBeam deve usar o acionador "Consent Initialization"
2. Isso dispara ANTES de todas as outras tags
3. Outras tags de marketing devem ter requisitos de consentimento

Problemas de Desempenho

Banner carregando lentamente

Otimizar carregamento

1. Mantenha o loader síncrono e em primeiro lugar no head da página; exclua-o de otimizadores de atraso de scripts.
2. Use a versão CDN (cdn.cookiebeam.com) e não a auto-hospedada
3. Verifique a velocidade da sua conexão com a internet
4. O banner deve carregar em < 500ms com uma boa conexão

Banner bloqueando o carregamento da página

Loader síncrono

1. Não adicione async ou defer ao loader do banner.
2. Use o URL canônico do loader da aba de instalação do banner.
3. Carregue de forma síncrona como o primeiro elemento no head da página, antes dos rastreadores.

Depuração Avançada

Para desenvolvedores: Use estes comandos no console do navegador para depurar o CookieBeam

Verificar se o CookieBeam foi carregado:

window.CookieBeam !== undefined

Obter estado atual do consentimento:

CookieBeam.getConsent()

Verificar dataLayer (GTM):

window.dataLayer

Forçar exibição do banner (teste):

CookieBeam.show()

Redefinir consentimento (teste):

CookieBeam.reset()

Ainda Precisa de Ajuda?

Se você não encontrou uma solução aqui, estamos aqui para ajudar!

✉️ Suporte por E-mail

support@cookiebeam.com

Resposta em até 24 horas

❓ FAQ

Perguntas frequentes

Respostas rápidas

📚 Centro de Aprendizado

Guias e tutoriais

Documentação detalhada

📊 Ao relatar problemas: Inclua o ID do seu Navegador (encontrado no painel do CookieBeam), versão do navegador e passos para reproduzir o problema. Capturas de tela também ajudam!