Google Tag Assistant: como ver que etiquetas disparam e descobrir o que as partiu

O que é o Google Tag Assistant e o que mostra?

O Google Tag Assistant é uma ferramenta web, em tagassistant.google.com, que verifica e ajuda a resolver instalações da etiqueta Google (gtag.js) e do Google Tag Manager, incluindo as etiquetas do Google Analytics e do Google Ads. Substituiu o antigo modo de pré-visualização do Tag Manager, que dependia de cookies de terceiros, cada vez mais bloqueados pelos navegadores.

Numa única sessão de depuração é possível seguir o domínio inteiro, página a página, e ver:

• cada evento, numerado pela ordem em que disparou e agrupado pela página onde aconteceu;
• a chamada de API por trás de cada evento, seja gtag() ou dataLayer.push();
• os hits enviados, com destino, tipo e os parâmetros de cada um;
• os valores da camada de dados, os eventos de medição melhorada do Google Analytics e os erros.

Nos contentores do Tag Manager, o ecrã de depuração lista também que etiquetas 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. Esta informação só aparece na sua sessão, nunca aos visitantes normais.

O que o Tag Assistant não dá é histórico. Mostra como as etiquetas se comportam agora, no seu navegador. Se uma etiqueta deixou de disparar na terça-feira passada, continua a ser preciso descobrir o que mudou nessa terça-feira.

Como iniciar uma sessão de depuração no Tag Assistant?

Comece em tagassistant.google.com para qualquer site com a etiqueta Google, ou no botão Visualizar do Tag Manager quando quiser testar alterações da área de trabalho que ainda não foram publicadas.

A partir do Tag Assistant

1. Abra tagassistant.google.com e clique em "Add domain".
2. Introduza o URL do site, a começar por https:// ou http://.
3. Clique em "Connect". O site abre numa nova janela com o parâmetro de depuração _dbg no URL.
4. Percorra as páginas e as ações que quer testar. O Tag Assistant vai atualizando à medida que navega.

A partir do Google Tag Manager

1. Abra o contentor e, no separador "Espaço de trabalho", clique em "Visualizar". O Tag Assistant abre num novo separador.
2. Introduza o URL do site e clique em "Conectar". O site mostra "Conectado" no canto inferior direito.
3. Volte ao separador do Tag Assistant e clique em "Continuar" para abrir a interface de depuração.

Se o parâmetro de depuração estragar o site, desmarque "Incluir o sinal de depuração no URL" antes de ligar. A Google recomenda a extensão Tag Assistant para Chrome: permite depurar etiquetas dentro de iframes (só possível com a extensão), janelas pop-up, novos separadores e várias janelas em simultâneo. Para terminar, 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 ficam em inglês).

Como ler o que o Tag Assistant mostra?

Leia da esquerda para a direita: escolha um evento na cronologia e depois confirme o que enviou e que etiquetas acionou.

A sessão abre na vista "Summary". Se a página tiver várias etiquetas Google ou contentores, escolha um no topo e os hits passam a ser filtrados por esse ID. A coluna da esquerda é a cronologia de eventos; os eventos com o ícone <> são eventos automáticos que a etiqueta Google envia ao carregar.

Uma etiqueta em "Tags Fired" não encerra a verificação. Abra o hit e leia os parâmetros: uma etiqueta de compra que dispara com valor 0 ou sem moeda prejudica as licitações tanto como uma que nem dispara. O Tag Assistant também avisa quando um evento é enviado para um produto Google sem que a etiqueta Google correspondente tenha disparado antes.

Porque é que a etiqueta Google não está a disparar?

Na maioria dos casos, a etiqueta deixou de funcionar por causa de uma alteração: no site, no contentor, no consentimento ou no percurso das páginas. A tabela mostra as causas habituais e como cada uma aparece.

Alguns limites são da própria ferramenta: as páginas AMP não são suportadas, e as etiquetas dentro de iframes só podem ser depuradas com a extensão do Chrome. Se a etiqueta Google carregar depois de o Tag Assistant tentar ligar, clique em "Retry". As ferramentas de consentimento podem bloquear as etiquetas Google se não estiverem configuradas para funcionar com a API de consentimento da Google; esse caso tem um artigo próprio sobre como provar que o banner de consentimento fez cair as conversões.

Como isolar que alteração partiu a etiqueta?

O Tag Assistant diz que a etiqueta está avariada hoje. Para saber que alteração a partiu, encontre o último dia em que funcionou e alinhe tudo o que mudou nesse dia e imediatamente antes.

1. Encontrar o último dia em que funcionou
2. Alinhar as alterações anteriores
3. Testar o suspeito no Tag Assistant
4. Corrigir e registar a correção

Use os relatórios para encontrar a data da avaria: o dia em que os eventos do GA4 ou as conversões do Google Ads caíram para zero ou desceram de patamar. Depois reúna as alterações dessa janela: versões do contentor publicadas no Tag Manager (a lista de Versões mostra quando cada uma foi publicada e por quem), novas versões do site, atualizações do CMS ou do tema, alterações ao banner de consentimento e ao checkout ou aos formulários. Abra a versão publicada mais perto da avaria e veja que etiquetas, acionadores e variáveis alterou; o artigo sobre o histórico de versões do Google Tag Manager explica como.

Depois teste um suspeito de cada vez. Pré-visualize a versão anterior à avaria e a atual, repita o mesmo percurso (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 contentor. Se ambas falham, procure no site.

Com todas as alterações numa única cronologia, isto demora minutos e não uma tarde: veria que uma versão do contentor e uma nova versão do checkout entraram em produção na véspera da queda e testaria essas duas primeiro. No Changeline a equipa regista alterações ao site, às etiquetas e ao consentimento com data, responsável e motivo, e as alterações do Google Ads são importadas automaticamente através de uma ligação só de leitura, pelo que uma avaria de tracking e uma alteração de licitação da mesma semana aparecem lado a lado.

Exemplo: o cliente pergunta porque é que os leads do Google Ads caíram para zero na quinta-feira. O Tag Assistant mostra a etiqueta do formulário em "Tags Not Fired". Na cronologia de quarta-feira há duas entradas: uma versão do contentor que acrescentou um widget de chat e uma versão do site que mudou o nome do evento do formulário de form_submit para lead_submit. Ao pré-visualizar o contentor antigo no site atual, a etiqueta continua a falhar, por isso o contentor não é a causa: o acionador espera um evento que o site já não envia. Corrigir o acionador resolve, e a resposta ao cliente cabe numa frase com data. Nomes e números são ilustrativos.

Como partilhar uma sessão de depuração ou testar uma versão antiga do contentor?

Pode entregar a sessão de depuração a um colega ou a um programador, em vez de descrever o problema por e-mail.

• Partilhar a pré-visualização da área de trabalho: no Tag Assistant, clique em "Mais ações" e depois em "Compartilhar". Na caixa "Compartilhar a sessão de depuração", introduza o domínio do site, copie o URL de pré-visualização e envie-o.
• Pré-visualizar uma versão antiga: no Tag Manager, abra "Versões", abra "Mais ações" na versão e escolha "Visualizar", ou a opção de partilhar a pré-visualização para a enviar a outra pessoa.
• Exportar a sessão: o Tag Assistant permite exportar e importar sessões de depuração, para que o programador abra exatamente o que viu.

O modo de pré-visualização só funciona no navegador onde foi ativado ou para as pessoas com quem o partilhou. Testar a versão anterior à avaria no site atual é a forma mais rápida de distinguir um problema do contentor de um problema do site.

Como evitar que as etiquetas falhem sem ninguém dar por isso na próxima versão do site?

Trate o tracking como código: cada alteração tem nome, data e teste.

1. Dê nome a cada versão do contentor. O Tag Manager pede um nome e uma descrição da versão ao publicar, e o exemplo da própria Google é "GA page view tag - initial launch". Um nome claro é a primeira pista quando procurar uma avaria meses depois.
2. Corra o Tag Assistant depois de cada nova versão do site, e não só depois de alterações no Tag Manager. Muitas avarias vêm do lado do site: uma classe com outro nome, um modelo novo, um passo do checkout que mudou de sítio.
3. Teste de ponta a ponta os eventos que valem dinheiro, como compra, lead e registo, e abra os hits para confirmar valor, moeda e ID da transação.
4. Registe a alteração onde toda a equipa a vê, com o motivo e quem a fez, junto das alterações de campanhas e do site. Um modelo de registo de alterações de marketing chega para começar, e o guia do registo de alterações de marketing explica o que registar.
5. Assinale as correções de tracking nos relatórios. Quando as conversões regressarem depois de uma correção, deixe uma anotação para que ninguém a leia como ganho de desempenho; veja as anotações no GA4.

Se uma etiqueta avariada 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.