Google Tag Assistant: como ver quais tags disparam e descobrir o que quebrou
O Google Tag Assistant é a ferramenta de depuração do Google para a tag do Google e o Google Tag Manager. Você conecta o site em tagassistant.google.com, navega em modo de depuração e vê cada evento, os hits enviados ao Google Analytics ou Google Ads, o data layer e os erros. Mostra a falha, não a mudança que a causou.
O que é o Google Tag Assistant e o que ele mostra?
O Google Tag Assistant é uma ferramenta web, em tagassistant.google.com, que verifica e ajuda a corrigir instalações da tag do Google (gtag.js) e do Google Tag Manager, incluindo as tags do Google Analytics e do Google Ads. Ele substituiu o antigo modo de visualização do Tag Manager, que dependia de cookies de terceiros, cada vez mais bloqueados pelos navegadores.
Em uma única sessão de depuração você acompanha o domínio inteiro, página por página, e vê:
- cada evento, numerado na ordem em que disparou e agrupado pela página onde aconteceu;
- a chamada de API por trás de cada evento, seja
gtag()oudataLayer.push(); - os hits enviados, com destino, tipo e os parâmetros de cada um;
- os valores do data layer, os eventos de medição otimizada do Google Analytics e os erros.
Em contêineres do Tag Manager, a tela de depuração também lista quais tags dispararam e quais não dispararam em cada evento, os valores das variáveis e o estado do consentimento quando o modo de consentimento está ativo. Essas informações só aparecem na sua sessão, nunca para os visitantes comuns.
O que o Tag Assistant não mostra é histórico. Ele mostra como as tags se comportam agora, no seu navegador. Se uma tag parou de disparar na terça passada, você ainda precisa descobrir o que mudou na terça passada.
Como iniciar uma sessão de depuração no Tag Assistant?
Comece por tagassistant.google.com para qualquer site com a tag do Google, ou pelo botão Visualizar do Tag Manager quando quiser testar mudanças do espaço de trabalho que ainda não foram publicadas.
Pelo Tag Assistant
- Acesse tagassistant.google.com e clique em "Add domain".
- Digite a URL do site, começando com https:// ou http://.
- Clique em "Connect". O site abre em uma nova janela com o parâmetro de depuração
_dbgna URL. - Navegue pelas páginas e ações que quer testar. O Tag Assistant atualiza conforme você navega.
Pelo Google Tag Manager
- Abra o contêiner e, na guia "Espaço de trabalho", clique em "Visualizar". O Tag Assistant abre em uma nova guia.
- Digite a URL do site e clique em "Conectar". O site mostra "Conectado" no canto inferior direito.
- Volte para a guia do Tag Assistant e clique em "Continuar" para abrir a interface de depuração.
Se o parâmetro de depuração quebrar o site, desmarque "Incluir o sinal de depuração no URL" antes de conectar. O Google recomenda a extensão Tag Assistant para Chrome: ela permite depurar tags dentro de iframes (só é possível com a extensão), pop-ups, novas guias e várias janelas ao mesmo tempo. Para encerrar, clique no X no canto superior esquerdo da interface ou em "Parar a depuração". Para retomar, escolha o domínio em "Active Domains" ou "History" na página inicial do Tag Assistant (a ajuda do Tag Assistant só existe em inglês, por isso alguns rótulos aparecem em inglês).
Leia também: Rastreamento de conversões no Google Ads: como configurar, validar e datar cada mudança · Log de alterações de marketing: o que é e como manter um
Como ler o que o Tag Assistant mostra?
Leia da esquerda para a direita: escolha um evento na linha do tempo e depois confira o que ele enviou e quais tags acionou.
A sessão abre na visão "Summary". Se houver várias tags do Google ou contêineres na página, escolha um no topo, e os hits passam a ser filtrados por esse ID. A coluna da esquerda é a linha do tempo de eventos; os eventos com o ícone <> são eventos automáticos que a tag do Google envia ao carregar.
| Onde | O que você vê | Serve para conferir |
|---|---|---|
| Output e "Hits Sent" | Cada hit com destino e tipo; clique para ver os parâmetros | Se o evento do GA4 ou a conversão do Google Ads saiu mesmo da página |
| Tags (Tag Manager) | "Tags Fired" e "Tags Not Fired" do evento selecionado | Se o acionador bateu; clique na tag para ver os acionadores |
| Variables | Valores das variáveis em cada evento | Valores indefinidos ou errados, como um ID de transação vazio |
| Data Layer | O que foi enviado ao dataLayer em cada evento | Se o site ainda envia os dados que as tags esperam |
| Consent | Estado de cada tipo de consentimento, como ad_storage e analytics_storage | Tags seguradas pelo banner de cookies |
| Errors | Erros de JavaScript e problemas de tag | Tags de HTML personalizado quebradas |
Uma tag em "Tags Fired" não encerra a checagem. Abra o hit e leia os parâmetros: uma tag de compra que dispara com valor 0 ou sem moeda atrapalha os lances tanto quanto uma tag que nem dispara. O Tag Assistant também avisa quando um evento é enviado a um produto do Google sem que a tag do Google correspondente tenha disparado antes.
Por que a minha tag do Google não está disparando?
Quase sempre a tag parou por causa de uma mudança: no site, no contêiner, no consentimento ou no fluxo das páginas. A tabela mostra as causas mais comuns e como cada uma aparece.
| Causa | O que aparece no Tag Assistant |
|---|---|
| Alguém editou um acionador, ou um deploy do site mudou o caminho da página, a classe do botão ou o ID do formulário | A tag aparece em "Tags Not Fired" no evento em que antes disparava |
| O desenvolvedor renomeou uma chave do data layer ou o nome de um evento | O evento some da linha do tempo, ou uma variável aparece como undefined |
| O banner de consentimento ou a configuração dele mudou | Consentimento negado; tags seguradas ou enviadas sem cookies |
| A tag do Google carrega tarde ou saiu de um template | O Tag Assistant não conecta, ou páginas aparecem sem tag no "Tag coverage summary" |
| Nova cadeia de redirecionamentos ou checkout em outro domínio | A janela de depuração não carrega, ou a sessão para depois do redirecionamento |
| Bloqueador de anúncios no navegador de teste | A tag do Google não roda, mas só na sua máquina |
Alguns limites são da própria ferramenta: páginas AMP não são compatíveis, e tags dentro de iframes só podem ser depuradas com a extensão do Chrome. Se a tag do Google carregar depois que o Tag Assistant tentar conectar, clique em "Retry". Ferramentas de consentimento podem bloquear as tags do Google se não estiverem configuradas para funcionar com a API de consentimento do Google; esse caso tem um post próprio sobre como provar que o banner de consentimento derrubou as conversões.
Como isolar qual mudança quebrou a tag?
O Tag Assistant diz que a tag está quebrada hoje. Para saber qual mudança causou isso, ache o último dia em que a tag funcionou e coloque lado a lado tudo o que mudou nesse dia e logo antes.
- Ache o último dia que funcionou
- Liste as mudanças antes dele
- Teste o suspeito no Tag Assistant
- Corrija e registre a correção
Use os relatórios para achar a data da quebra: o dia em que os eventos do GA4 ou as conversões do Google Ads zeraram ou caíram de patamar. Depois junte as mudanças dessa janela: versões do contêiner publicadas no Tag Manager (a lista de Versões mostra quando cada uma foi publicada e por quem), deploys do site, atualizações de CMS ou tema, mudanças no banner de consentimento e no checkout ou nos formulários. Abra a versão publicada mais perto da quebra e veja quais tags, acionadores e variáveis ela mexeu; o post sobre histórico de versões do Google Tag Manager mostra como.
Depois teste um suspeito por vez. Visualize a versão de antes da quebra e a atual, faça o mesmo fluxo (por exemplo, enviar um formulário de teste) e compare "Tags Fired" e os hits. Se a versão antiga dispara e a nova não, a causa está no contêiner. Se as duas falham, olhe para o site.
Com todas as mudanças numa única linha do tempo, isso leva minutos em vez de uma tarde: você veria que uma versão do contêiner e um deploy do checkout entraram no ar no dia anterior à queda e testaria esses dois primeiro. No Changeline o time registra mudanças de site, tags e consentimento com data, responsável e motivo, e as alterações do Google Ads são importadas automaticamente por uma conexão somente leitura, então uma quebra de tracking e uma mudança de lance da mesma semana aparecem lado a lado.
Exemplo: o cliente pergunta por que os leads do Google Ads zeraram na quinta. O Tag Assistant mostra a tag do formulário em "Tags Not Fired". Na linha do tempo de quarta há duas entradas: uma versão do contêiner que adicionou um widget de chat e um deploy do site que renomeou o evento do formulário de form_submit para lead_submit. Visualizando o contêiner antigo no site atual, a tag continua falhando, então o contêiner não é a causa: o acionador espera um evento que o site não envia mais. Ajustar o acionador resolve, e a resposta ao cliente cabe numa frase com data. Nomes e números são ilustrativos.
- QuaGTMVersão do contêiner com widget de chat
- QuaSiteEvento do formulário vira lead_submit
- QuiLeads do Google Ads zeram
Como compartilhar uma sessão de depuração ou testar uma versão antiga do contêiner?
Você pode passar a sessão de depuração para um colega ou desenvolvedor em vez de descrever o problema por e-mail.
- Compartilhar a visualização do espaço de trabalho: no Tag Assistant, clique em "Mais ações" e depois em "Compartilhar". Na caixa "Compartilhar a sessão de depuração", digite o domínio do site, copie a URL de visualização e envie.
- Visualizar uma versão antiga: no Tag Manager, vá em "Versões", abra "Mais ações" na versão e escolha "Visualizar", ou a opção de compartilhar a visualização para mandar a outra pessoa.
- Exportar a sessão: o Tag Assistant permite exportar e importar sessões de depuração, para que o desenvolvedor abra exatamente o que você viu.
O modo de visualização só funciona no navegador em que foi ativado ou para as pessoas com quem você compartilhou. Testar a versão de antes da quebra no site atual é o jeito mais rápido de separar um problema de contêiner de um problema de site.
Como evitar que as tags quebrem sem ninguém perceber no próximo deploy?
Trate o tracking como código: toda mudança ganha nome, data e teste.
- Dê nome a cada versão do contêiner. O Tag Manager pede nome e descrição da versão ao publicar, e o próprio exemplo do Google é "GA page view tag - initial launch". Um nome claro é a primeira pista quando você procurar uma quebra meses depois.
- Rode o Tag Assistant depois de todo deploy do site, não só depois de mudanças no Tag Manager. Muitas quebras vêm do lado do site: uma classe renomeada, um template novo, uma etapa do checkout que mudou de lugar.
- Teste de ponta a ponta os eventos que valem dinheiro, como compra, lead e cadastro, e abra os hits para conferir valor, moeda e ID da transação.
- Registre a mudança onde o time inteiro vê, com o motivo e quem fez, junto das mudanças de campanha e de site. Um modelo de registro de mudanças de marketing basta para começar, e o guia de registro de mudanças de marketing explica o que anotar.
- Marque as correções de tracking nos relatórios. Quando as conversões voltarem depois de uma correção, deixe uma anotação para ninguém ler isso como ganho de performance; veja anotações no GA4.
Se uma tag quebrada já custou uma semana de conversões, o guia para explicar uma queda de conversões ao cliente ajuda a apresentar a data, a causa e a correção.
Saiba qual mudança de tag quebrou suas conversões
O Changeline coloca as alterações do seu time, as alterações importadas do Google Ads e as edições de site, tracking e CRM em uma linha do tempo por cliente.
Plano Free: 1 projeto, 2 editores, 15 dias de histórico. Sem cartão.
Perguntas frequentes
Preciso da extensão Tag Assistant para Chrome?
Não, a versão web em tagassistant.google.com funciona sem ela. Mesmo assim o Google recomenda a extensão, porque ela permite depurar tags dentro de iframes, pop-ups, novas guias e várias janelas ao mesmo tempo. Tags carregadas em iframes só podem ser depuradas com a extensão instalada, e ela pede permissão para ler e alterar os dados dos sites que você testa.
O que aconteceu com o Tag Assistant Legacy e o Tag Assistant Companion?
O Google juntou os dois numa única extensão Tag Assistant. O Legacy é atualizado automaticamente para a nova extensão, e o Companion se desinstala sozinho depois dessa atualização. O Companion ainda funciona, mas o Google avisa que ele será descontinuado, então use a extensão unificada junto com tagassistant.google.com.
Os visitantes do site veem o painel de depuração do Tag Assistant?
Não. As informações de depuração só aparecem na sua sessão e para quem você compartilhar a sessão. O visitante comum vê o site normalmente. Durante a depuração o Tag Assistant adiciona o parâmetro _dbg à URL, que você pode desativar se ele atrapalhar o funcionamento da página.
Por que o Tag Assistant não conecta ao meu site?
Os motivos mais comuns são a tag do Google carregar depois da tentativa de conexão (clique em Retry), vários redirecionamentos seguidos, um bloqueador de anúncios ou uma ferramenta de consentimento que bloqueia as tags do Google. Páginas AMP não são compatíveis. Se o parâmetro de depuração quebrar a página, desmarque a opção de incluir o sinal de depuração no URL e conecte de novo.
O Tag Assistant mostra quando a tag parou de funcionar?
Não. Ele mostra como as tags se comportam na sua sessão agora. Para datar a quebra, ache o dia em que eventos ou conversões caíram no GA4 ou no Google Ads e confira quais versões do contêiner, deploys do site e mudanças de consentimento entraram no ar logo antes. A lista de Versões do Tag Manager mostra quando cada versão foi publicada.