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 [email protected]

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. Tente adicionar o atributo defer: script src="..." 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. Certifique-se de que o script tem o atributo "defer"
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

Carregamento assíncrono

1. Sempre use o atributo defer ou async na tag script
2. Correto: script src="..." defer
3. Nunca carregue de forma síncrona no head

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

[email protected]

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!