Biblioteca·SOP·Analytics
Envie compras com itens, valores, moeda e ID único ao GA4, validando status elegíveis, consentimento e proteção contra duplicidade.
Última revisão: · Revisão editorial
Clareza, estrutura e referências revisadas nesta versão. Não equivale a um teste em uma conta real.
Envie ao Google Analytics 4 (GA4) os itens, valor, moeda e número único do pedido WooCommerce quando o navegador do comprador chegar à confirmação enquanto o pedido estiver em um status contado pela loja como compra. O GTM4WP adiciona os dados ao data layer e uma tag de evento GTM os envia. Uma alteração posterior de status no WordPress, sozinha, não envia este evento do navegador.
Este SOP abrange:
Não abrange:
O GTM4WP verifica o status, mas esta configuração envia o evento pelo navegador do comprador. Ele precisa chegar à confirmação enquanto o status escolhido estiver ativo. Alterar o status no WordPress depois, por si só, não envia o evento.
Crie a nota Compras WooCommerce no GA4, com títulos Site, Propriedade GA4, Measurement ID do fluxo, ID do contêiner e carregador, Regra e status de compra, Checkout de teste, Preview e Live.
No topo, adicione endereço do site e nome da propriedade. Não registre nomes de clientes, e-mails, endereços nem dados de pagamento. Pode registrar ID não pessoal e totais dos pedidos de teste necessários.
No Analytics, abra Admin > Data collection and modification > Data streams. Escolha Web e o fluxo da loja. Copie o Measurement ID, iniciado por G-, para Measurement ID do fluxo.
Pergunte ao proprietário quais pedidos contar e quando o comprador retorna à confirmação. Escolha status considerando os métodos de pagamento da loja.
Em um pedido comum de cartão, Processing geralmente indica pagamento recebido e atendimento pendente, podendo ser o status de compra no checkout. Completed geralmente indica atendimento concluído. Se a mudança para Completed ocorrer dias depois, ela não enviará o evento a menos que o comprador retorne à confirmação com Completed selecionado como elegível.
No pagamento na entrega, Processing pode ocorrer antes de o entregador receber. Pergunte se o negócio conta no checkout ou apenas após cobrar. Se o pagamento ocorrer depois e o comprador não voltar ao site, peça rastreamento server-side; este método de navegador não envia eventos por mudança posterior de status.
Em Regra e status de compra, registre a regra do proprietário, status selecionados e retorno ou não do comprador à confirmação. Exclua Pending payment, Failed e On hold desta configuração porque o pagamento falta ou não está confirmado.
Peça ao mantenedor o checkout de teste sem cobrança aprovado. Em Checkout de teste, registre onde começar, como criar dois pedidos Preview com itens ou totais diferentes e um pedido Live novo, e como retornar à confirmação em status selecionado.
Data layer é uma lista compartilhada de eventos e valores da página que o GTM consegue ler. O GTM4WP acrescenta compras WooCommerce a ela; a configuração separada de código do contêiner define se ele também carrega o GTM.
Localize o ID do contêiner existente e confirme qual componente único o carrega.
Abra o contêiner no GTM e copie o ID GTM- do topo para ID do contêiner e carregador. Se não souber, pergunte ao mantenedor se o carregamento é feito por Site Kit, GTM4WP ou outro snippet.
Abra o Google Tag Assistant e conecte à loja. Confirme que o mesmo ID aparece uma vez. Se faltar ou duplicar, peça correção do carregador antes de alterar plugins.
Abra o GTM4WP e ative seu data layer WooCommerce, preservando o carregador confirmado.
No WordPress, Plugins > Installed Plugins. Se GTM4WP estiver inativo, selecione Activate. Depois abra Settings > Google Tag Manager > WooCommerce. A página só está disponível com o plugin ativo.
Em General, ligue Track e-commerce, que permite inserir eventos WooCommerce no data layer.
Em Data layer content, mantenha Customer data in data layer e Order data in data layer desligados. O evento purchase usa dados de itens de comércio e não precisa de dados pessoais nem do registro completo do pedido.
Em Google Tag Manager > Container code placement, mantenha como único carregador o componente confirmado no passo 2.1. Se Site Kit ou outro snippet carregar, escolha no GTM4WP Off – container code turned off, data layer only. Se GTM4WP for o único confirmado, mantenha ativo e confira o ID salvo com a nota. Preserve dataLayer como nome, salvo confirmação do mantenedor de que o contêiner usa outro.
Configure o envio apenas de pedidos elegíveis e mantenha a proteção contra repetição.
Em WooCommerce > Purchase tracking, selecione apenas os status registrados. Deixe Pending payment, Failed e On hold desmarcados.
Ligue Exclude tax from revenue e Exclude shipping from revenue. Deixe Do not flag orders as being tracked desmarcado, impedindo reenvio ao recarregar a confirmação. Deixe Transaction ID prefix vazio, salvo convenção já existente na loja.
Selecione Save changes e registre status, opções de valor e proteção contra repetição em Regra e status de compra.
Use o evento purchase exato para que visualizações de produto, carrinho e início de checkout não contem como pedidos.
Confirme o destino da Google tag existente e a ausência de outra tag ou plugin enviando compras ao mesmo fluxo.
Abra a Google tag do contêiner identificado. Confira o destino com o Measurement ID da nota e mantenha essa tag. Se faltar ou apontar a outro fluxo, siga primeiro o guia relacionado.
Na lista Tags, abra as Google Analytics: GA4 Event existentes e verifique Event Name e Measurement ID, procurando purchase para o fluxo da nota. Confira também Plugins > Installed Plugins por outros plugins WooCommerce-GA4. Se outra fonte puder enviar ao mesmo Measurement ID, pergunte ao mantenedor qual remetente único manter antes de prosseguir.
Crie a tag GA4 Event GA4 - WooCommerce purchase para o fluxo desejado.
No mesmo contêiner, crie uma tag Google Analytics: GA4 Event e digite purchase em Event Name.
Insira o Measurement ID da nota no campo Measurement ID. Mantenha a Google tag existente como base.
Em More Settings > Ecommerce, ative Send Ecommerce data e escolha Data Layer. GTM4WP fornece itens, preços, quantidades, moeda, valor e ID atuais de cada pedido; não insira valores fixos.
Crie o acionador WooCommerce purchase event, tipo Custom Event, nome exato purchase, para todos os eventos personalizados desse nome. Vincule a GA4 - WooCommerce purchase, salve acionador e tag.
Na propriedade correspondente, Admin > Data display > Events, confira se purchase existente está marcado como principal. Se já estiver, mantenha. Se listado sem marcação, marque esse mesmo evento, sem criar outro. Registre o estado visível em Live.
Repita a verificação de sucesso pertinente com consentimento aceito e recusado e compare tags/requisições com a implementação aprovada. Registre ambos. Não force Granted nem contorne o banner para obter teste aprovado.
Use pedido novo em cada verificação distinta de sucesso Preview ou Live. Mantenha registro de IDs, valores esperados, ambiente e horário. Coordene com o proprietário para evitar atendimento real; registre o tratamento dos testes nos relatórios do negócio. Não desative proteção contra repetição para reutilizar pedido já rastreado.
Primeiro teste dois pedidos seguros sem cobrança no Preview. Depois publique e confira recebimento de detalhes e itens no GA4.
Conecte Tag Assistant pelo Preview e confirme que não há disparo antes de pedido elegível.
No workspace GTM, Preview, informe o checkout da nota e conecte.
Visite produto, carrinho e checkout sem concluir pedido. Confira a lista de eventos de cada página e confirme que GA4 - WooCommerce purchase não disparou.
Faça o primeiro pedido sem cobrança aprovado e inspecione seu evento purchase.
Use o checkout da nota. Garanta que o navegador retorne à confirmação enquanto o pedido tiver status selecionado.
No Tag Assistant, selecione purchase e confirme um disparo de GA4 - WooCommerce purchase. Abra os dados e confira transaction_id igual ao número do pedido, currency igual à moeda da loja, value igual ao total dos itens sem impostos/frete e items com ID ou nome, preço e quantidade do produto de teste.
Faça segundo pedido aprovado sem cobrança com item ou total diferente. No Tag Assistant, confirme ID de transação diferente e valores/itens correspondentes ao segundo pedido.
Confira exclusão de pedidos não confirmados e ausência de duplicidade ao recarregar.
Se o caminho sem cobrança permitir criar Pending payment, Failed ou On hold, abra sua confirmação e confirme ausência de disparo. Se não permitir criar um desses status com segurança, registre que não foi testado.
Recarregue a confirmação de pedido elegível e confira que a tag não dispara novamente para ele.
Revise alterações e publique tag e acionador no contêiner existente. Nomeie a versão WooCommerce GA4 purchase e registre seu número em Live.
Inicie nova verificação Live, faça pedido elegível novo e confirme evento e itens recebidos no GA4.
No Tag Assistant, abra detalhes do contêiner, Change container environment or version > Environment ID 1 / Live e seu link Debug. Quando atualizado para depuração, selecione Reload page. Confirme Container Version Live antes do teste.
Faça um novo pedido elegível no checkout sem cobrança aprovado e deixe o navegador chegar à confirmação. Confirme um sucesso da tag na sessão Live.
No Analytics, Admin > Data display > DebugView. Em Debug Device, escolha o navegador do teste Live e selecione o marcador purchase novo desse pedido.
Em Parameters, confira transaction_id com o número do pedido, value com o total segundo a regra de impostos/frete e currency com a loja.
Em Items, expanda o produto e confira ID ou nome e quantidade.
Compare o preço do item com o preço normal no evento purchase bem-sucedido do Tag Assistant. DebugView pode exibir preço multiplicado por 1.000.000, como 12.34 exibido como 12340000; não altere o preço da loja para corresponder a isso. Registre horário, ID do pedido, valor, moeda, ID ou nome do item, quantidade e comparação de preço em Live.
