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.
Exemplo prático de leitura do resultado
Imagine um JSON com 3 tags, 4 acionadores e 6 variáveis. Depois da análise, o painel mostra 1 variável sem uso e 2 erros: uma tag sem acionador e uma referência quebrada. A conta da revisão fica clara: 6 variáveis menos 1 sem uso deixam 5 com alguma conexão; os dois erros continuam pendentes até você corrigir a configuração. Primeiro abra o item apontado na aba Erros e Avisos. Depois confira a aba Conexões para ver se a variável marcada como sem uso realmente não está ligada a nenhuma tag ou acionador. Esse exemplo ajuda a separar contagem de inventário de problema de disparo.
Como interpretar antes de publicar
Use a aba de erros como fila de correção, mas não trate a ausência de erros como prova de coleta correta. No GTM, o modo de visualização permite navegar no site e observar quais tags foram disparadas, em que ordem e quais dados foram processados. Teste pelo menos a página inicial, uma conversão e o fluxo que contém o evento que motivou a alteração. Se o evento depende de consentimento, repita o teste com a escolha de consentimento prevista para o visitante.
Erros comuns e como evitar
- Exportar a versão publicada quando a mudança ainda está no espaço de trabalho. Escolha a origem que corresponde ao que você quer revisar.
- Importar um modelo diretamente sobre um container em produção. Use um espaço de trabalho separado, selecione mesclar e leia a prévia de itens adicionados, modificados ou excluídos.
- Apagar uma variável só porque ela aparece sem uso. Abra Conexões e confira o número de dependências antes de remover.
- Corrigir o JSON e esquecer de exportar o arquivo ajustado. O conteúdo carregado fica na página; salve o JSON antes de fechar a aba.
Limites e quando não usar
Use o validador para revisar a configuração exportada, comparar componentes e encontrar referências ou sintaxe que possam ser verificadas no arquivo. Não use o resultado sozinho para concluir que um clique foi medido, que o valor de uma compra está correto ou que uma tag passou pelo consentimento. Essas respostas dependem do site, do navegador e dos serviços de destino. Faça a análise, corrija os apontamentos, teste os eventos no modo de visualização e só então revise as mudanças no GTM antes de publicar.
