TecnologiaArtigo
Vendas no GA4: quais eventos de e-commerce enviar e como conferir se a receita bate com a da loja
Em resumo
O Google Analytics 4 (GA4), ferramenta do Google que mede as visitas de um site, não registra as vendas da loja virtual sozinho: a loja precisa enviar os eventos de e-commerce. O ConnectWeek mostra quais eventos enviar, o que o evento de compra precisa levar, como testar com um pedido e por que a receita do GA4 pode diferir da receita da plataforma da loja.
O Google Analytics 4 (GA4), a ferramenta do Google que mede as visitas de um site, não registra as vendas de uma loja virtual por conta própria. Para a receita aparecer nos relatórios, a loja precisa enviar ao GA4 os chamados eventos de e-commerce, que são avisos disparados quando o visitante vê um produto, põe um item no carrinho ou conclui o pedido. Este artigo mostra quais eventos enviar, o que o evento de compra precisa levar, como testar com um pedido e por que a receita do GA4 pode diferir da que a plataforma da loja mostra. As regras foram conferidas na Ajuda do Google Analytics e na documentação do Google para desenvolvedores em 8 de outubro de 2026.
O GA4 só mostra a venda que a loja envia
A página de ajuda do relatório “Compras de e-commerce” é direta: o Google Analytics não coleta os eventos de e-commerce automaticamente. O que o GA4 faz sozinho é reconhecer esses eventos quando chegam e preencher com eles as dimensões, as métricas e os relatórios de venda.
A mesma página traz um aviso que explica muito relatório vazio. Se o evento de e-commerce chega sem os parâmetros obrigatórios (parâmetros são os dados que acompanham o evento), ele é tratado como evento personalizado, fora do padrão de e-commerce, e não entra no relatório. A página registra ainda uma exceção: na loja montada na Shopify com o Google Analytics configurado, parte dos eventos, entre eles o de carrinho, o de início de pagamento e o de compra, já é coletada pela plataforma.
Nas demais plataformas, a pergunta a fazer ao fornecedor ou a quem cuida do site é objetiva: a integração com o GA4 envia quais eventos, com quais parâmetros? A resposta se confere com o teste descrito mais abaixo.
Quais eventos enviar, do produto visto ao pedido pago
A documentação Medir o e-commerce, do Google para desenvolvedores, descreve os eventos na ordem em que o cliente percorre a loja. Os nomes ficam em inglês porque é assim que o GA4 os reconhece. O quadro traz os que essa página lista para o caminho da compra:
| Momento na loja | Evento | O que ele registra |
|---|---|---|
| Lista de produtos ou resultado de busca | view_item_list e select_item | Os itens mostrados e o item em que o visitante clicou |
| Página do produto | view_item | Cada vez que os detalhes de um item são abertos |
| Carrinho | add_to_cart, view_cart e remove_from_cart | Item adicionado, carrinho visto e item retirado |
| Início do pagamento | begin_checkout | A primeira etapa da finalização da compra |
| Frete e forma de pagamento | add_shipping_info e add_payment_info | A opção de entrega e a forma de pagamento escolhidas |
| Pedido concluído | purchase | A compra, com os itens e o valor |
| Devolução do dinheiro | refund | O reembolso, ligado ao código do pedido |
A página de eventos recomendados da Ajuda do Google Analytics traz todos esses eventos na seção de vendas on-line e informa que o envio desses eventos é o que preenche o relatório de compras. Na avaliação do ConnectWeek, a loja pequena pode começar por quatro deles, que formam o caminho mínimo da venda: view_item, add_to_cart, begin_checkout e purchase. Com os quatro já é possível ver em que etapa o cliente desiste, assunto de conversão da loja caiu: roteiro para achar a causa.
O que o evento de compra precisa levar
O evento purchase é o que carrega a receita. A referência de eventos do GA4 lista os parâmetros dele e marca quais são obrigatórios:
- transaction_id (obrigatório): o identificador único do pedido. É ele que evita a contagem dobrada da mesma compra.
- items (obrigatório): a lista dos produtos comprados, cada um com seus dados, como código, nome, preço e quantidade.
- value (obrigatório, com ressalva): o valor da compra. A referência orienta a preencher com a soma de preço vezes quantidade de todos os itens e a não incluir frete nem tributos.
- currency (obrigatório quando há value): a moeda, no código de três letras da norma ISO 4217. Sem ela, as métricas de receita não são calculadas corretamente.
- shipping, tax e coupon (opcionais): o frete, os tributos e o cupom do pedido, cada um no seu campo.
Sobre a página em que o evento deve ser disparado, o tutorial Configurar um evento de compra dá como exemplo a página de confirmação, aquela que aparece quando a pessoa conclui o pedido. O mesmo tutorial lista o que é preciso ter antes: a conta e a propriedade criadas (a propriedade é o cadastro do site dentro do Google Analytics), o fluxo de dados da Web criado para o site, a tag do Google (o código de medição) instalada, acesso ao código-fonte e função de editor (o nível de permissão), ou superior, na conta. A página Medir o e-commerce traz as instruções para a Tag do Google e para o Gerenciador de tags, a ferramenta do Google para gerenciar tags.
O identificador do pedido merece o maior cuidado. A página Minimizar eventos principais duplicados com IDs da transação explica que o GA4 elimina a duplicação quando duas compras chegam com o mesmo identificador. Ela traz dois alertas. Não se deve enviar o campo vazio, porque o GA4 trata como repetidas todas as compras que chegam assim. E o identificador precisa ser diferente a cada pedido: se a tag envia o mesmo identificador para vendas diferentes, a contagem pode ficar muito menor do que a real. A página informa ainda que essa eliminação só funciona para dados de sites, e não de aplicativos.
Como testar com um pedido de teste
O GA4 tem uma tela própria para conferir a instalação, chamada DebugView. Segundo a página Monitorar eventos no DebugView, ela mostra os eventos no momento em que são coletados. Para usá-la, é preciso ativar o modo de depuração, a configuração que faz os eventos de um aparelho aparecerem nessa tela. O roteiro abaixo foi montado pelo ConnectWeek com os passos dessa página:
- Ativar o modo de depuração só no próprio aparelho, pelo Assistente de tags do Google (tagassistant.google.com). A página recomenda esse caminho para quem está conferindo a instalação.
- No Google Analytics, abrir “Administrador” e, em “Exibição de dados”, clicar em “DebugView”.
- Em outra aba, navegar pela loja como um cliente: abrir um produto, pôr no carrinho, iniciar o pagamento e concluir um pedido de teste.
- Conferir se os eventos aparecem na ordem esperada e clicar no evento purchase para ver os parâmetros.
- Comparar o identificador, o valor, a moeda e os itens com o pedido que a plataforma da loja registrou.
Dois avisos da mesma página evitam conclusões erradas. O primeiro: os eventos não aparecem no DebugView quando o visitante não autorizou os cookies do Google Analytics. Isso vale para o site que implementou controles de privacidade no lado do cliente, isto é, que rodam no navegador, e para o site que ativou o modo de consentimento, o recurso do Google que leva em conta a escolha do visitante sobre cookies. Por isso, o teste deve ser feito com os cookies aceitos. O texto do aviso de cookies é assunto de banner de cookies: o que a LGPD exige. O segundo: quem ativou o modo de depuração pelo código, para todos os visitantes, precisa apagar o parâmetro de depuração para desligar. Mudar o valor para “false” não desativa.
Por que a receita do GA4 não bate com a da plataforma?
Com tudo instalado, os dois números ainda podem diferir. As regras abaixo saem das páginas do Google indicadas em cada linha, entre elas a página Atualização de dados, de onde vem o prazo de tratamento. A leitura de que elas explicam a diferença e a coluna da conferência são do ConnectWeek.
| Causa | O que a página do Google informa | Como conferir |
|---|---|---|
| Frete e tributos | A referência de eventos orienta a não incluir frete nem tributos no value | Comparar o GA4 com a venda de produtos da plataforma, sem o frete |
| Identificador do pedido | Campo vazio ou repetido faz o GA4 juntar compras diferentes, segundo a página dos IDs da transação | Comparar primeiro a quantidade de pedidos, antes do valor |
| Dados ainda em tratamento | O tratamento pode levar de 24 a 48 horas, e nesse período os números podem mudar, segundo a página Atualização de dados | Comparar períodos fechados, e não o dia de hoje nem o de ontem |
| Moeda ausente | A receita não é calculada corretamente sem o currency, segundo a referência de eventos | Olhar o parâmetro no pedido de teste |
| Reembolsos | A documentação Medir o e-commerce orienta medir o reembolso enviando o evento refund com o identificador do pedido | Verificar se a plataforma envia esse evento e, se não envia, comparar a venda antes dos cancelamentos |
Há uma sexta causa que as páginas consultadas não tratam, e que o ConnectWeek registra como leitura própria. O visitante que recusa os cookies de medição pode comprar sem que o GA4 registre a venda. A plataforma da loja registra todos os pedidos, porque é ela que os recebe.
Um exemplo hipotético com frete
Considere uma loja inventada pelo ConnectWeek que recebe, em uma semana, 50 pedidos iguais: R$ 180 em produtos e R$ 20 de frete. A plataforma mostra R$ 200 por pedido e R$ 10.000 na semana (50 × 200). Se a integração segue a orientação da referência de eventos e envia no value só os produtos, o GA4 mostra R$ 180 por pedido e R$ 9.000 na semana (50 × 180). A diferença de R$ 1.000 é o frete, e não erro de medição.
Na avaliação do ConnectWeek, o que a loja deve vigiar não é a distância entre os dois sistemas, e sim a mudança dessa distância. Se a diferença era de cerca de 10% e passa a 30% sem mudança no frete, algo quebrou no envio dos eventos. É a mesma conferência do roteiro de queda de conversão citado acima. Os indicadores que dependem dessa receita estão em KPIs de e-commerce: os 12 indicadores e a fórmula de cada um. O evento que registra o que o cliente digita na busca da loja está em busca interna da loja.
Comece por aqui Novo no assunto? Leia primeiro o que é e-commerce, o texto-base desta cobertura.
Fonte: Google, documentação do Google Analytics para desenvolvedores, página Medir o e-commerce
Perguntas frequentes
O GA4 registra as vendas da loja virtual automaticamente?
Não. Segundo a Ajuda do Google Analytics, os eventos de e-commerce não são coletados de modo automático: a loja precisa enviá-los. A página do relatório Compras de e-commerce registra uma exceção para lojas na Shopify com o Google Analytics configurado, em que parte dos eventos, como o de compra, é coletada pela plataforma.
Quais parâmetros são obrigatórios no evento purchase do GA4?
A referência de eventos do GA4 marca como obrigatórios o identificador do pedido (transaction_id) e a lista de itens (items). O valor (value) e a moeda (currency) aparecem como obrigatórios com ressalva: a moeda é exigida sempre que o valor é enviado, e sem ela as métricas de receita não são calculadas corretamente.
O valor enviado no evento de compra do GA4 inclui o frete?
Pela orientação do Google, não. A referência de eventos do GA4 indica preencher o parâmetro value com a soma de preço vezes quantidade de todos os itens e não incluir frete nem tributos, que têm campos próprios (shipping e tax). Por isso a receita do GA4 pode ficar abaixo do total que a plataforma da loja mostra.
Por que a mesma compra aparece duas vezes no GA4?
A Ajuda do Google Analytics explica que o GA4 elimina a duplicação quando duas compras chegam com o mesmo identificador do pedido (transaction_id). Na leitura do ConnectWeek, a compra pode aparecer duas vezes quando o identificador enviado não é o número do pedido e muda a cada envio: a compra reenviada, por exemplo ao recarregar a página de confirmação, chega com outro identificador e pode ser contada de novo.
