Como depurar o rastreamento do Google Analytics e do Tag Manager

Se as reservas feitas pelo widget de checkout não aparecem no Google Analytics, os registros de depuração integrados ao widget ajudam a descobrir em que ponto elas são interrompidas.

Nas configurações do widget, em Analytics, a opção Enviar eventos via determina como o rastreamento funciona. As duas opções têm comportamentos muito diferentes, o que altera o que você deve esperar ao fazer a depuração.

Google Analytics 4 — o widget envia cada evento de reserva diretamente para a sua propriedade do Analytics. Com Usar tag existente (a opção padrão), ele usa a tag do Google Analytics já presente na sua página; com Usar tag personalizada, ele carrega a própria tag usando o ID de medição que você informar. Em ambos os casos, é o widget que se comunica com o Google, portanto você pode ver os dados da reserva sendo enviados na aba Rede do navegador.

Google Tag Manager — o widget não envia nada para o Google Analytics. Ele encaminha cada evento para o seu contêiner do Tag Manager, e o contêiner decide o que fazer com ele. Com Usar contêiner existente (a opção padrão), ele usa o contêiner já presente na sua página; com Usar contêiner personalizado, ele carrega o ID do contêiner que você informar. Em ambos os casos, nada chega ao Google Analytics a menos que você tenha configurado uma tag dentro do Tag Manager para enviá-lo. Esse é o motivo mais comum para as reservas não aparecerem: o widget está funcionando perfeitamente, mas nenhuma tag está capturando os eventos. Consulte a seção 5.

Também existe uma opção geral, Ativar o Google Analytics, no início da mesma seção. Ela ativa ou desativa o rastreamento para ambas as opções — se estiver desativada, nada será rastreado, mesmo quando o Tag Manager estiver ativado.

2. Ative os registros de depuração

No painel do TicketingHub, abra as configurações do widget de checkout que você deseja testar.
Na seção Analytics, ative Ativar registros de depuração do Analytics e salve.

Enquanto estiver ativado, o widget escreverá uma linha no console do navegador do seu site para cada evento. Com Google Analytics 4 selecionado, isso também ativa o modo de depuração do Google para a tag. Com o Google Tag Manager, use a Visualização ou ative o modo de depuração na sua tag do GA4 para ver os eventos no DebugView. Os registros no console mostram apenas o lado do widget — ele não consegue ver o que o Google faz em seguida, portanto eles não substituem o GA4 DebugView nem a Visualização do GTM.

3. Abra o console do navegador no seu site

Abra no seu site a página em que o widget está incorporado (não o painel do TicketingHub).
Abra as ferramentas de desenvolvedor do navegador (F12 ou clique com o botão direito → Inspecionar) e acesse a aba Console.
Se o navegador mostrar um seletor de frames no console, certifique-se de que o frame superior esteja selecionado — o widget informa os eventos à sua página, não dentro do próprio frame.
Ative Preservar registro nas configurações do console — se o widget redirecionar para outra página após uma reserva, as mensagens sobre o evento final de compra serão gravadas imediatamente antes do redirecionamento e, caso contrário, serão apagadas antes que você possa lê-las.
Faça uma reserva de teste. Certifique-se de que o console esteja aberto antes de a página carregar (ou recarregue a página com ele aberto), para que você também veja as mensagens geradas durante a inicialização da página.

4. O que significam as mensagens do console

Mensagem	Significado
`Triggering GA event …` / `Triggering GTM event …`	O widget enviou o evento ao Google Analytics ou o encaminhou ao seu contêiner do Tag Manager.
`… event … processed`	O evento foi recebido e processado, e a mensagem normalmente identifica a tag ou o contêiner que o processou. Com o Tag Manager, isso significa que o seu contêiner recebeu o evento — não que algo foi enviado ao Google. Consulte a seção 5.
`… event … was not confirmed within …ms`	Nada informou ao widget que o evento foi processado dentro de alguns segundos. Isso não significa necessariamente que o evento foi perdido — verifique o GA4 DebugView para saber se ele chegou. As causas comuns estão na seção 6.
`… event … was still waiting for confirmation when the page navigated away`	O widget redirecionou para outra página antes que a verificação fosse concluída, o que é normal se você usar um redirecionamento pós-compra. Isso não significa que o evento falhou — confirme-o no GA4 DebugView.
`… failed to load …`	O script do Google não pôde ser carregado — normalmente porque foi bloqueado por um bloqueador de anúncios ou filtro de rede.
`… event … dropped …`	O evento não pôde ser enviado. A mensagem informa o motivo: não há Google Analytics ou Tag Manager disponível na página ou o Tag Manager está desativado nas configurações do widget.

O widget informa deliberadamente apenas aquilo de que pode ter certeza. Ele sabe se o script do Google foi carregado e se a sua tag confirmou o processamento de um evento — não consegue saber se o Google aceitou os dados, por isso direciona você ao DebugView em vez de fazer suposições.

5. Se você usar o Google Tag Manager, configure suas tags

O Tag Manager é um contêiner, não uma ferramenta de rastreamento. Quando o widget encaminha um evento de reserva, o contêiner verifica os acionadores e executa as tags correspondentes. Se nenhuma tag corresponder, o evento simplesmente para ali — o console ainda exibirá processed, porque o seu contêiner recebeu o evento.

Um contêiner novo não capturará esses eventos por conta própria. A maioria das tags do Analytics está configurada para ser acionada em “Initialization” ou “All Pages”, que não correspondem aos eventos de reserva do widget.

Para enviar as reservas do widget ao Google Analytics, no seu contêiner do Tag Manager você precisa de:

Uma tag do Google (ou tag de configuração do GA4) que contenha o seu ID de medição (G-…).
Uma tag de evento do GA4 para cada evento de reserva relevante, usando um acionador de Evento personalizado cujo nome corresponda ao nome de um dos eventos do widget.

O widget envia estes nomes de eventos:

Evento	Quando ocorre
`page_view`	O visitante passa para outra etapa do widget
`select_item`	Um produto ou pacote é selecionado na lista de produtos/eventos
`add_to_cart`	Itens são adicionados à cesta
`view_cart`	O resumo do pedido é exibido
`begin_checkout`	A etapa de dados do cliente é exibida
`add_payment_info`	A etapa de pagamento é exibida, antes do envio dos dados
`purchase`	O pagamento é aprovado ou um pedido sem nenhum valor restante a pagar é confirmado

Para os eventos de comércio eletrônico, configure a tag para enviar dados de comércio eletrônico da Camada de dados. O widget envia os campos padrão de comércio eletrônico do Google Analytics — como moeda, valor, itens e ID da transação — no formato esperado pelo Google, portanto não é necessário fazer nenhum mapeamento personalizado.

Use a Visualização do GTM (Tag Assistant) para verificar o seu trabalho: ela mostra cada evento recebido do widget e exatamente quais tags foram ou não acionadas. Se um evento chegar, mas nenhuma tag for acionada, o acionador não corresponde; se uma tag for acionada, mas nada chegar ao Analytics, verifique o ID de medição da tag.

Uma observação importante: com o Tag Manager, você não verá os dados da reserva sendo enviados ao Google Analytics na aba Rede pelo próprio widget. O widget pode carregar o script do contêiner do Tag Manager, mas as solicitações que transportam os dados da reserva vêm das suas próprias tags, depois que elas são acionadas.

6. Causas e soluções comuns

Bloqueadores de anúncios e extensões de privacidade — eles bloqueiam os scripts de rastreamento do Google em praticamente todas as listas de bloqueio. Faça o teste em uma janela privada/anônima com as extensões desativadas ou em um perfil limpo do navegador. Lembre-se de que visitantes que usam bloqueadores de anúncios também não serão rastreados, portanto é normal que algumas reservas não apareçam.
Os eventos são processados, mas nada aparece no Analytics — com o Tag Manager, isso quase sempre significa que nenhuma tag está configurada para ser acionada pelos eventos do widget. Consulte a seção 5.
Não há absolutamente nada no console — o rastreamento pode estar completamente desativado. Verifique se Ativar o Google Analytics está ativado e lembre-se de que essa opção também controla o Tag Manager. Certifique-se ainda de que a página tenha sido carregada com o console já aberto.
Todos os eventos informam que foram descartados porque o Tag Manager está desativado — ative Ativar o Google Tag Manager nas configurações do widget. Tanto essa opção quanto Ativar o Google Analytics precisam estar ativadas para que a opção do Tag Manager funcione.
Não há mensagens do Tag Manager, apenas mensagens do Google Analytics — o widget está configurado para enviar eventos via Google Analytics 4, portanto as configurações do Tag Manager são ignoradas. Altere Enviar eventos via para Google Tag Manager. O widget usa um método ou outro, nunca ambos.
ID de medição ou ID do contêiner incorreto — verifique se o ID nas configurações do widget corresponde à sua propriedade do Analytics (G-…) ou ao contêiner do Tag Manager (GTM-…).
Banners de consentimento — se o visitante não tiver aceitado os cookies de analytics, o Modo de consentimento do Google poderá reter os eventos deliberadamente. Aceite o consentimento para analytics na página de teste antes de tirar conclusões.
Plugins de cache ou otimização — alguns plugins de cache ou otimização do WordPress interferem nos scripts de analytics. Tente desativá-los temporariamente ou adicione os scripts à lista de exclusões.

7. Confirme nas ferramentas do Google

O console informa que o widget fez a parte dele. Para confirmar que os dados chegaram:

O GA4 DebugView (Analytics → Administrador → DebugView) mostra, em tempo real, os eventos que chegam à sua propriedade.
A Visualização do GTM (Tag Assistant) mostra quais tags são acionadas para cada evento enviado pelo widget.

Relacionado

Você faz integração com o Google Analytics 4?