--- title: "Guia de Solução de Problemas | CookieBeam" description: "Solucione problemas comuns do CookieBeam. Soluções para banner não aparecendo, problemas com consent mode, integração com GTM e mais." url: "https://cookiebeam.com/pt/troubleshooting" lang: "pt" image: "https://cookiebeam.com/opengraph-image.png?v=20261016" --- # 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](mailto: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. 1. Abra seu site no Chrome 2. 2. Pressione F12 para abrir as Ferramentas de Desenvolvedor 3. 3. Vá para a aba "Rede" 4. 4. Atualize a página 5. 5. Pesquise por "cookiebeam" no filtro 6. 6. Se você vir um status 200, o script foi carregado com sucesso #### Verifique o ID do Banner 1. 1. Vá para o painel do CookieBeam 2. 2. Clique no seu banner → aba Instalação 3. 3. Copie o ID do seu Banner 4. 4. Verifique se ele corresponde ao ID no código do seu site 5. 5. Erro comum: Usar o ID errado ou deixar o placeholder "YOUR-BANNER-ID" #### Verifique erros de JavaScript 1. 1. Abra as Ferramentas de Desenvolvedor do Chrome (F12) 2. 2. Vá para a aba "Console" 3. 3. Procure por mensagens de erro em vermelho 4. 4. Se você vir "CookieBeam is not defined" ou similar, o script não está carregando 5. 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. 1. Atualize forçadamente o navegador: Ctrl+Shift+R (Windows) ou Cmd+Shift+R (Mac) 2. 2. Ou limpe completamente o cache do navegador 3. 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. 1. Vá para Designer de Banner → Layout 2. 2. Certifique-se de que "Responsivo para Celular" está habilitado 3. 3. Teste diferentes tamanhos de tela nas Ferramentas de Desenvolvedor (F12 → Barra de Dispositivos) 4. 4. Verifique se há CSS conflitante no celular ### O banner aparece, mas está quebrado/sem estilo #### Conflito de CSS 1. 1. O CSS do seu site pode estar sobrepondo os estilos do banner 2. 2. Adicione prioridade !important no CSS personalizado do CookieBeam 3. 3. Ou aumente a especificidade do CSS nas configurações do banner 4. 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. 1. Verifique se seu navegador bloqueia cookies de terceiros 2. 2. Verifique se o localStorage está habilitado (necessário para armazenamento de consentimento) 3. 3. Verifique se você está no modo privado/anônimo (cookies não persistem) 4. 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. 1. Abra o modo de visualização do GTM 2. 2. Procure a tag "CookieBeam Consent" na lista de tags 3. 3. Verifique se mostra "Tags Disparadas" e não "Tags Não Disparadas" 4. 4. Se não disparou, verifique a configuração do acionador 5. 5. Use o acionador "Consent Initialization - All Pages" #### Tag disparando, mas o banner não aparece 1. 1. Abra o console do navegador (F12) 2. 2. Procure o carregamento do script CookieBeam 3. 3. Verifique se o ID do Banner está correto no código da tag GTM 4. 4. Verifique se a URL do script é: https://cdn.cookiebeam.com/banner/... ### Outras tags ainda disparam sem consentimento #### Configure os requisitos de consentimento 1. 1. Abra cada tag GA4/Google Ads no GTM 2. 2. Vá para Configurações Avançadas → Configurações de Consentimento 3. 3. Habilite "Exigir consentimento adicional para disparar a tag" 4. 4. Para GA4: Selecione "Analytics Storage" 5. 5. Para Google Ads: Selecione "Ad Storage" e "Analytics Storage" 6. 6. Salve e publique #### Certifique-se de que o CookieBeam carrega primeiro 1. 1. A tag do CookieBeam deve usar o acionador "Consent Initialization" 2. 2. Isso dispara ANTES de todas as outras tags 3. 3. Outras tags de marketing devem ter requisitos de consentimento ## Problemas com o Consent Mode v2 ### O Google Analytics não recebe sinais de consentimento #### Habilitar Consent Mode v2 1. 1. Vá para Painel do CookieBeam → Configurações do Banner 2. 2. Habilite "Google Consent Mode v2" 3. 3. Salve as alterações 4. 4. No GA4, verifique o relatório em Tempo Real para sinais de consentimento 5. 5. Deve aparecer "granted" ou "denied" para analytics_storage #### Verificar configuração do GA4 1. 1. No GTM, abra sua tag de Configuração do GA4 2. 2. Verifique se está configurado para usar o Consent Mode 3. 3. Em GA4 Admin → Coleta de Dados → O status do Consent Mode deve mostrar "Observed" ### Os sinais do Consent Mode não atualizam #### Verificar dataLayer 1. 1. Abra o console do navegador (F12) 2. 2. Digite: window.dataLayer 3. 3. Procure eventos de "consent" 4. 4. Deve aparecer eventos de atualização quando o usuário aceita/rejeita 5. 5. Formato: event "consent", consent_update ... ## Problemas com Varredura de Cookies ### O scanner de cookies não detecta todos os cookies #### Múltiplos métodos de varredura 1. 1. Tente os métodos de varredura automático e manual 2. 2. Varredura manual: Visite todas as páginas importantes antes de concluir a varredura 3. 3. Alguns cookies só aparecem após ações específicas (login, checkout, etc.) 4. 4. Cookies de terceiros podem exigir interação do usuário para aparecer ### Categorias de cookies incorretas #### Categorização manual 1. 1. Vá para Painel → Scanner de Cookies → Resultados 2. 2. Clique no cookie categorizado incorretamente 3. 3. Altere a categoria manualmente 4. 4. O CookieBeam aprende com suas correções ## Problemas de Desempenho ### Banner carregando lentamente #### Otimizar carregamento 1. 1. Mantenha o loader síncrono e em primeiro lugar no head da página; exclua-o de otimizadores de atraso de scripts. 2. 2. Use a versão CDN (cdn.cookiebeam.com) e não a auto-hospedada 3. 3. Verifique a velocidade da sua conexão com a internet 4. 4. O banner deve carregar em < 500ms com uma boa conexão ### Banner bloqueando o carregamento da página #### Loader síncrono 1. 1. Não adicione async ou defer ao loader do banner. 2. 2. Use o URL canônico do loader da aba de instalação do banner. 3. 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](mailto:support@cookiebeam.com) [❓ FAQ Perguntas frequentes Respostas rápidas](https://cookiebeam.com/guides) [📚 Centro de Aprendizado Guias e tutoriais Documentação detalhada](https://cookiebeam.com/guides) **📊 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!