Testando eventos do GA4 com GTM

Depois de cadastrar um Measurement ID de GA4 no TagServer e configurar a tag no GTM, confirme que o desvio server-side pelo subdomínio está funcionando: um evento disparado no site chega ao monitor de teste do TagServer e aparece no DebugView do GA4, em vez de ir direto para o Google.

Antes de começar

O subdomínio do TagServer está ativo e com SSL provisionado. O certificado é emitido automaticamente após o CNAME; sem SSL os eventos não chegam.
O Measurement ID (formato G-XXXXXXXXXX) e o API Secret estão cadastrados no TagServer. Os dois são resolvidos no recebimento do evento, então ambos precisam estar presentes. Veja Plataformas e credenciais.
A tag de GA4 está criada e publicada no GTM com o transport_url correto (veja o aviso abaixo).

Importante

O valor de transport_url é a origem do seu subdomínio seguida de /events/ga, por exemplo https://tracking.seusite.com.br/events/ga. O gtag anexa /g/collect a esse valor, e a requisição final cai em /events/ga/g/collect, que é onde o relay de GA4 do TagServer atende. Não use https://<subdomínio>/g/collect: esse valor aponta para uma rota que não existe na raiz do subdomínio e ainda duplica o /g/collect que o próprio gtag adiciona. Sem o transport_url, ou com ele errado, o gtag envia os eventos direto ao GA4 sem passar pelo TagServer. Onde configurar esse parâmetro na tag está em Configuração adicional.

Passo a passo

Abra o monitor de teste do pixel. No menu lateral, no grupo Rastreamento, clique em Pixels. Na tabela, localize a linha do seu pixel de GA4 (os Measurement IDs aparecem aqui junto com os demais pixels, com a plataforma "Google Analytics") e clique no botão Inspecionar na última coluna. O botão só aparece nas plataformas com monitor, e Google Analytics é uma delas. O modal de teste abre já conectado ao monitor daquele pixel.
Confirme que o monitor conectou. O cabeçalho do modal mostra o nome do pixel e, abaixo, uma linha com o ícone e o rótulo da plataforma e o ID da plataforma, separados por ·. A barra de status passa de Conectando... para Aguardando eventos · Abra seu site em uma nova aba. Enquanto nenhum evento chega, o corpo do modal exibe Aguardando eventos... com a instrução Navegue pelo seu site para gerar eventos. O monitor só mostra o que chega com o modal aberto e fecha a conexão quando você o fecha: deixe-o aberto sobre a página de Pixels e faça o disparo em outra aba.
Ative o DebugView no GA4. No GA4, acesse Administrador > Exibição de dados > DebugView, que mostra os eventos em tempo real enquanto o modo debug está ativo. Como o TagServer aceita eventos de Measurement Protocol com a flag de debug, os eventos do desvio server-side aparecem aqui.
Ative a visualização do GTM. Na guia Espaço de trabalho, clique em Visualizar para abrir o Tag Assistant, informe a URL do site e clique em Conectar. O site abre em uma nova janela; quando ele carregar, volte para a aba do Tag Assistant para continuar.
Dispare o evento e confira a tag. Navegue pelo site para acionar o evento desejado (por exemplo page_view ou purchase). No Tag Assistant, abra a tag de GA4 e confirme que o nome do evento (event_name) corresponde ao configurado e que o transport_url está presente e aponta para https://<subdomínio>/events/ga.
Confirme no monitor do TagServer. No modal ainda aberto, a barra de status passa a Recebendo eventos · N recebidos e cada evento aparece no inspetor abaixo, com o nome configurado, o que confirma que ele passou pelo TagServer. Se a barra mostrar Erro na conexão · Feche e tente novamente, feche o modal e abra de novo.
Confirme no GA4. No DebugView, o evento aparece na linha do tempo. Pode levar alguns instantes.

Solução de problemas

Para ver o histórico, use a seção de eventos abaixo da tabela na página de Pixels: o gráfico Monitoramento de eventos, com filtro de plataforma e seletor de período, e a tabela de erros, que pode ser baixada em CSV.

Sintoma	Possível causa
`transport_url` correto, mas nenhum evento aparece no monitor	Measurement ID divergente entre o GTM e o TagServer
A tag dispara, mas o evento não chega ao TagServer	`transport_url` ausente ou incorreto (apontando para a raiz em vez de `/events/ga`), ou subdomínio inativo ou sem SSL
Evento chega ao TagServer, mas não aparece no GA4	API Secret incorreto. A tabela de erros da página de Pixels mostra o erro devolvido pelo destino
Evento no GA4 sem os parâmetros esperados	Parâmetros obrigatórios não configurados na tag do GTM
Nenhum evento aparece no monitor	Filtre o gráfico Monitoramento de eventos em Google Analytics: ele mostra se houve eventos no período, inclusive os que chegaram e falharam no envio ao destino

Nota

A Visão geral do grupo Rastreamento serve para acompanhar a saúde do GA4 depois, não para o primeiro teste: um GA4 recém-configurado, sem histórico, aparece como Saudável mesmo sem nenhum evento.

Veja também

Testando eventos: visão geral do monitor de teste em tempo real.
Testando eventos do Facebook com GTM: o mesmo fluxo para eventos de Facebook.
Introdução a pixels: o conceito de pixel e destino no TagServer.