O Validador de Google Tag Manager lê o JSON exportado de um container e aponta erros em tags, acionadores e variáveis antes de você publicar. Funciona como o checklist do piloto antes da decolagem: o problema aparece no chão, não no ar. Entre os problemas que ele encontra estão tags sem acionador, que nunca disparam, referências a variáveis que não existem e nomes duplicados. Corrija na própria ferramenta ou no GTM, exporte de novo e só publique quando a aba de erros ficar vazia e o modo de visualização confirmar os disparos.
Como usar o Validador de Google Tag Manager
No GTM, vá em Admin, Exportar Container, e baixe o JSON. Arraste o arquivo para o Validador de Google Tag Manager ou cole o conteúdo e clique em Analisar GTM. O painel conta tags, acionadores, variáveis e erros e separa tudo em abas, incluindo pastas e conexões. Dá para pausar tags, limpar itens sem uso e exportar o JSON ajustado para importar de volta.
O que o validador confere além do básico
Além de tags sem acionador e referências quebradas, o Validador de Google Tag Manager revisa pontos que costumam passar despercebidos numa revisão manual:
- Formato dos IDs de GA4, Google Ads, Google Tag, Meta Pixel e TikTok Pixel.
- Parâmetros ausentes em eventos de e-commerce do GA4, da Meta e do TikTok.
- Erro de sintaxe em tags de HTML e JavaScript personalizados, e tag HTML com document.write habilitado.
- Acionadores e variáveis que nenhuma tag usa, e negação em condição que o GTM ignora.
- Tamanho do container: aviso a partir de 200 KB e erro a partir de 250 KB.
Cada item vem como erro ou aviso. Erro pede correção antes de publicar; aviso, como variável sem uso, pede uma decisão: apagar ou manter com o motivo registrado nas notas.
O que a análise do JSON não pega
O validador lê a configuração, não o site. Ele não sabe se o acionador de clique encontra o botão certo, se a camada de dados envia o valor esperado ou se a plataforma de consentimento bloqueia a tag. Antes de publicar, abra o modo de visualização e depuração do Tag Manager e percorra as páginas e os eventos principais. Se o container ainda não tem um plano de eventos por trás, comece pelo guia de event tracking na prática.
Container modelo para começar do zero
O botão Carregar Container Modelo abre um container pronto e pede, numa configuração inicial, IDs como GA4, Google Ads, Meta Pixel, LinkedIn, TikTok, Microsoft Clarity, HubSpot e RD Station, além de AdOpt ou OneTrust para consentimento. Todos os campos são opcionais, e há a opção de excluir variáveis e tags que ficarem vazias. Use o modelo em container novo; num container em produção, importe o JSON ajustado num espaço de trabalho separado, escolha mesclar e revise as alterações antes de publicar.