O Preview Mode do GTM (o Tag Assistant) existe para responder uma pergunta só: a tag está disparando agora, no navegador, com os dados certos? Ele conecta o container ao seu site em tempo real e mostra cada tag como Fired ou Not Fired a cada evento, além do estado do dataLayer e das variáveis naquele instante. Se você já viu conversão sumir do Gerenciador de Eventos e ficou olhando para o container tentando adivinhar o que quebrou, é aqui que o diagnóstico começa. Quando o "tag assistant gtm" não conecta ou some do ar, quase sempre é bloqueador, cookie de terceiro ou domínio errado, e eu passo por cada uma dessas causas mais abaixo.
Para o processo completo de leitura de um container, veja o guia de auditoria de container GTM. E se a sua tag simplesmente não dispara, o Preview costuma apontar o motivo dentro dos 7 erros mais comuns no Google Tag Manager.
O que o Preview Mode faz (e o que ele não resolve)
O Preview Mode roda o container em um modo de depuração que só você enxerga. Ele abre o seu site numa aba conectada ao Tag Assistant e monta uma linha do tempo de eventos: cada carregamento de página, cada clique, cada dataLayer.push vira um passo. Para cada passo, você vê quais tags dispararam, quais foram bloqueadas por trigger, e o valor de todas as variáveis naquele momento exato.
Isso muda o jogo porque tag configurada não é tag disparando. Você pode ter a tag do Meta Pixel escrita corretamente, publicada, e mesmo assim ela nunca disparar porque o trigger depende de um evento que o site não empurra para o dataLayer. No papel está tudo certo. No runtime, silêncio. O Preview é o único lugar que mostra essa diferença sem você ter que caçar request na aba Network.
O limite honesto: o Preview confirma o disparo da tag e o conteúdo do dataLayer, mas não garante que o evento chegou íntegro na plataforma. Tag Firing e evento aceito pelo GA4 ou pelo Meta são duas confirmações diferentes. Por isso o fluxo completo passa pela validação na ponta, no DebugView e no Gerenciador de Eventos, que eu descrevo daqui a pouco.
Como conectar o container e ler o painel Tags Fired
Conectar leva menos de um minuto quando o site coopera.
- No GTM, clique em Preview (canto superior direito do workspace)
- Cole a URL exata do site que você quer testar e confirme
- Uma nova aba abre o seu site com o selo de depuração; o Tag Assistant abre em paralelo mostrando "Connected"
- Navegue pelo site normalmente na aba de debug: home, página de produto, carrinho, checkout, confirmação de pedido
- No Tag Assistant, a coluna da esquerda lista os eventos em ordem; clique em cada um para ver Tags Fired e Tags Not Fired daquele evento
A leitura do painel é o que separa quem debuga de quem chuta. Em Tags Fired você confirma que a tag certa disparou no evento certo, uma vez só. Em Tags Not Fired está o ouro do diagnóstico: clique na tag que deveria ter disparado e o Tag Assistant mostra qual condição do trigger não foi satisfeita. É ali que você descobre que o trigger esperava a URL /obrigado e a página de confirmação real é /pedido-confirmado.
Antes de mexer no trigger, abra a aba Variables e a aba Data Layer daquele evento. Se a tag lê {{DL - transaction_id}} e a variável aparece como undefined, o problema não é a tag, é o dado que o site não empurrou para o dataLayer. Corrigir a tag aqui seria remendo. O conserto está no push do site.
Como validar o evento no GA4 e no Meta
Confirmado o disparo no Preview, você valida a chegada na plataforma. São dois destinos e cada um tem sua janela de verificação em tempo real.
DebugView do GA4
Com o Preview Mode ativo, o GTM já sinaliza debug_mode para o GA4, então o tráfego da sua sessão de debug cai no DebugView automaticamente.
- No GA4, abra Administrador → DebugView
- Navegue pelo site na aba de debug e observe os eventos chegando na linha do tempo
- Cada carregamento de página deve gerar um
page_view; cada compra, umpurchasecomtransaction_idpreenchido - Clique no evento para inspecionar os parâmetros:
value,currency,items. Parâmetro faltando aqui é parâmetro que o relatório do GA4 não vai ter depois
Test Events do Gerenciador de Eventos do Meta
Para o Meta, a aba Test Events dentro do Gerenciador de Eventos mostra os disparos da sua sessão em tempo real (com poucos segundos de atraso).
- No Gerenciador de Eventos, selecione o Pixel e abra Testar eventos
- Navegue pelo site na aba de debug e veja PageView, ViewContent, Purchase aparecerem conforme você interage
- Confira se o Purchase da página de confirmação chega uma vez só. Se chegar dobrado, você tem duplicação, e o caminho está nas tags duplicadas no GTM
- Se você usa o Pixel no navegador junto com a API de Conversões no servidor, confira que ambos carregam o mesmo
event_id. É oevent_ididêntico que faz a Meta deduplicar e contar o evento uma vez
Obs.: o Test Events também serve quando você não consegue instalar extensão no navegador do cliente. Você abre o Preview do lado do cliente, ele navega, e você acompanha os eventos chegando do seu lado. Já resolvi discrepância de conversão em call assim, sem tocar na máquina de ninguém.
Preview Mode não conecta: as três causas de sempre
Quando o Tag Assistant fica preso em "Trying to connect" ou volta para a tela inicial sem conectar, a causa quase sempre está numa destas três frentes.
Bloqueador de anúncio e extensões de privacidade
uBlock, AdBlock, Ghostery e o modo escudo do Brave bloqueiam o script do GTM e do Tag Assistant antes dele carregar. O sintoma é o container que "não instala" na aba de debug. Teste em uma janela anônima com todas as extensões desativadas, ou num perfil limpo do Chrome. Se conectar ali, o culpado era a extensão, não o container.
Cookies de terceiros bloqueados
O Tag Assistant depende de cookie de terceiro para manter a sessão de debug conectada. Navegador com cookies de terceiro bloqueados (padrão em várias configurações de privacidade e no Safari) derruba a conexão logo depois de estabelecer. Libere cookies de terceiro para tagassistant.google.com e para o domínio que você está testando, e tente de novo.
Domínio ou URL errados
Se você cola no Preview uma URL que não é onde o container está instalado, ele conecta e não vê tag nenhuma, ou nem conecta. Confirme que o GTM ID que você está editando é o mesmo que está no <head> daquele domínio (View Source, procure por GTM-). Ambiente de staging com container diferente do de produção é a pegadinha clássica: você debuga o container certo no site errado.
Obs.: se o container instalado no site for uma versão antiga, o Preview mostra o estado publicado, não o seu rascunho. Publique (ou peça publicação) antes de concluir que a correção não funcionou.
Tag "Not Fired": o problema é quase sempre o trigger
Quando a tag aparece em Tags Not Fired, siga esta ordem antes de suspeitar do resto. Primeiro, o trigger foi acionado? No painel de eventos, veja se o evento que deveria ativar a tag sequer apareceu na linha do tempo. Se o evento purchase não aparece, o site não empurrou esse push, e nenhuma tag amarrada a ele vai disparar.
Segundo, a condição do trigger bate com a realidade? Trigger de página de obrigado filtrando por uma URL que mudou, trigger de clique esperando uma classe de botão que o dev renomeou, trigger de formulário que dispara antes do envio completar. O Tag Assistant mostra o valor real da variável que o trigger avalia, então você compara a condição escrita com o valor que apareceu e a divergência fica óbvia.
Terceiro, existe um trigger de bloqueio (exception) barrando a tag? Uma exception mal escrita bloqueia a tag em páginas onde ela deveria disparar. O painel indica quando a tag foi impedida por um blocking trigger. Só depois de descartar essas três frentes é que faz sentido olhar para a configuração da tag em si.
Runtime e estrutura são dois exames diferentes
O Preview Mode é insubstituível para uma coisa: ver o comportamento ao vivo, com os dados reais que o site produz naquele carregamento. Ele mostra o disparo, o valor da variável, a sequência dos eventos. É o exame de runtime.
O que ele não faz é ler a estrutura inteira do container de uma vez e apontar o que está mal montado antes de você navegar página por página. Um container com oitenta tags acumuladas em três anos tem duplicação estrutural, trigger redundante, Meta Pixel via Custom HTML sem governança e evento de conversão faltando, e você não vê nada disso clicando evento a evento no Tag Assistant. Para esse exame de estrutura, você lê o JSON do container inteiro.
É a divisão de trabalho: o Preview valida o que está disparando; a auditoria de container mostra o que existe, o que falta e o que está duplicado na arquitetura. Um confirma o runtime, o outro mapeia a governança. Rodar os dois é o que fecha o diagnóstico com segurança antes de escalar mídia em cima daquele tracking.
FAQ
Qual a diferença entre Tag Assistant e Preview Mode?
Hoje são a mesma coisa na prática. O botão Preview dentro do GTM abre o Google Tag Assistant, que é a ferramenta que conecta o container ao seu site e mostra as tags disparando em tempo real. O nome antigo "Preview Mode" ficou, mas a interface que abre é o Tag Assistant. Não confunda com a extensão legada Tag Assistant Legacy do Chrome, que era outra ferramenta e foi descontinuada.
Por que a tag aparece como "Fired" no Preview mas não vejo o evento no GA4?
Porque Tag Firing confirma que a tag disparou no navegador, não que o evento foi aceito pela plataforma. O evento pode ter saído com parâmetro obrigatório faltando, com o Measurement ID errado, ou ter sido barrado por Consent Mode sem consentimento. Abra o DebugView do GA4 com o Preview ativo e a aba Network filtrada por google-analytics.com/g/collect para ver se a requisição saiu e com qual resposta.
Preciso publicar o container para o Preview funcionar?
Não para testar as suas edições. O Preview roda o seu workspace atual, incluindo mudanças em rascunho, então você valida a correção antes de publicar. O que você precisa é ter o container (mesmo que numa versão antiga) já instalado no site que está testando. A publicação só é necessária para levar a mudança validada para os usuários reais.
O Preview Mode funciona para container Server-Side (sGTM)?
Funciona, com uma interface própria. O container server-side tem o seu próprio Preview, que mostra as requisições chegando no servidor e as tags server-side disparando. Você pode conectar o Preview do container web e o do server ao mesmo tempo para seguir o evento do navegador até o servidor. É útil quando a conversão sai do site mas não chega no destino, e você precisa saber em qual das duas pontas ela se perdeu.
Depois de debugar no Preview, rode a auditoria
O Preview resolve o "esta tag está disparando com os dados certos". Ele não resolve o "este container inteiro está saudável". Depois de validar o runtime, cole o container no GTM Audit e rode a auditoria gratuita: ela lê o JSON completo e aponta o que o Preview não mostra navegando evento a evento, como duplicação estrutural, eventos de conversão ausentes, Custom HTML sem governança e triggers redundantes. Para fechar o setup do Meta com deduplicação correta, o checklist de configuração do Meta Pixel via GTM cobre o que precisa estar no lugar. Runtime e estrutura, os dois exames, e aí sim você escala mídia sem susto.