O DebugView mostra eventos de depuração recebidos e permite abrir seus parâmetros. Use ambiente de teste, produto fictício e sandbox do meio de pagamento para percorrer a jornada sem gerar cobrança real. O Google recomenda modo de depuração para conferir eventos ecommerce e itens.
Prepare a sessão de teste
- Confira se há apenas uma implementação de tag ou container, para evitar evento duplicado.
- Habilite
debug_modepara a sessão pelo modo Preview do GTM ou parâmetro de depuração da tag. Não ative depuração global para visitantes. - No GA4, abra Administrador → Exibição de dados → DebugView (os nomes podem mudar) e selecione o dispositivo/fluxo de teste correto. Se não aparecer, verifique consentimento, bloqueador, propriedade/ID e requisições de rede antes de reimplementar.
- Abra o site em janela de teste com console/rede disponíveis. Use uma sequência controlada:
| Ação | Evento esperado | O que conferir |
|---|---|---|
| Abrir detalhes de produto | view_item |
currency, value quando aplicável, item/variante exibidos |
| Adicionar ao carrinho | add_to_cart |
Produto, quantidade, preço unitário e subtotal correspondente |
| Iniciar checkout | begin_checkout |
Mesma cesta e valor, sem itens duplicados |
| Informar entrega/pagamento | add_shipping_info, add_payment_info |
Método realmente escolhido e itens que seguem no pedido |
| Finalizar pagamento sandbox | purchase |
transaction_id único, moeda, valor e itens conciliados |
| Estornar no ambiente de teste | refund |
Mesmo transaction_id e itens/quantidades devolvidos |
Os eventos são recomendados segundo a ação que ocorreu. Não dispare purchase em clique de botão de finalizar; dispare após confirmação confiável de pagamento/pedido, com idempotência para recarga/repetição.
Inspecione cada evento
No DebugView, selecione evento e confira parâmetros de evento e aba Items: item_id ou item_name, quantidade, variante, preço/moeda e categorias. Compare com a tela, payload enviado e status do pedido. Clique e recarregue a confirmação para verificar se purchase reaparece indevidamente.
Se evento não aparecer, verifique console, aba Network, consentimento/configuração do Google tag, debug_mode, propriedade correta e bloqueadores. Alguns processamentos/relatórios podem levar mais tempo; o DebugView e validação em tempo real servem para diagnóstico, não para comparar receita consolidada no mesmo instante.
Consulte Validar configuração ecommerce, medir ecommerce e eventos recomendados. Para outros procedimentos, veja métricas e analytics.
Serviços de tagueamento e métricas
Veja o escopo e os próximos passos do serviço relacionado a este tema.
Conteúdo da biblioteca de Diego Henrich. Confira as fontes citadas e valide orientações que dependem da versão de uma plataforma ou serviço.