Resolução de problemas
Resolva os problemas mais comuns: rastreamento antes do consentimento, atualizações do Consent Mode em falta no GTM, estilos do banner, cache e estatísticas vazias.
Teste sempre numa janela privada do navegador: uma escolha guardada numa visita anterior altera o que vê.
Um rastreador é executado antes do consentimento
- Verifique se o Bloqueio de código personalizado está ativado, no separador Bloqueio de scripts.
- Encontre o endereço do script nas ferramentas para programadores do navegador (separador Rede). Se o plugin não o reconhecer, adicione uma regra Bloquear por endereço com parte do endereço e a categoria correta.
- Se o script for adicionado pelo Google Tag Manager, atualize o plugin para a versão 1.8.10 ou superior: as versões anteriores não conseguiam ver as tags que o GTM adiciona.
- O rastreamento do lado do servidor não pode ser bloqueado a partir do navegador. Configure-o separadamente para respeitar o consentimento.
O Google Tag Manager não mostra as atualizações de consentimento
- Verifique se o Consent Mode v2 está ativado, no separador Integração.
- Teste numa sessão nova, sem o cookie
kncc_consent, e clique num botão do banner enquanto a pré-visualização está aberta. - Confirme que o GTM não é carregado duas vezes, por exemplo por um plugin e pelo tema.
O Meta Pixel é acionado com o consentimento analítico
Atualize para a versão 1.8.10 ou superior. A partir dessa versão, as tags de um contentor do GTM aguardam pela sua própria categoria. Veja o artigo do blog.
O banner fica com mau aspeto com o meu tema
Mude Geral → Estilo do texto e tipografia para Estilo do plugin. Se algo continuar a sobrepor-se ao banner, veja as dicas de CSS em Shortcodes, CSS e programadores.
O banner fica atrás de outro elemento
O z-index do banner é 999999. Aumente-o com CSS personalizado se a sobreposição do seu tema ficar por cima.
As páginas estão em cache
O plugin funciona com a cache de páginas: os scripts e os conteúdos incorporados bloqueados são iguais para todos os visitantes, e é o navegador do visitante que decide o que libertar. O WP Rocket, o LiteSpeed Cache e o Autoptimize são configurados automaticamente. Com outro plugin que atrase ou combine JavaScript, exclua dele kncc-consent e knccGuard.
As estatísticas estão vazias
As estatísticas começam a partir da primeira escolha que um visitante faz depois da instalação. Volte a consultá-las após algumas visitas.
wp_consent_statistics continua “deny” depois de Aceitar todos
Apague os cookies do site ou use uma janela privada, recarregue com Ctrl+Shift+R e confirme que o plugin WP Consent API está ativo.
A página da política avisa de traduções em falta
Crie a página da política traduzida em cada idioma e adicione-lhe o shortcode [kncc_cookie_policy].
Ainda tem problemas?
Pergunte no fórum de suporte no WordPress.org (abre num novo separador). Respondo eu próprio.
Atualizado em 28 de outubro de 2026
Algo errado ou em falta? Diga-me no fórum de suporte. (abre num novo separador)