Rastreamento de Ecommerce no GA4: Guia Completo de Configuração
Por Emily Redmond, Analista de Dados na Emilytics · Abril de 2026
TL;DR: O schema de eventos de ecommerce do GA4 rastreia produtos, carrinho, checkout e compras. Dispare os eventos corretos com detalhes de itens, e o GA4 calcula automaticamente métricas como receita, AOV e desempenho de produtos.
Se você está gerenciando uma loja de ecommerce, o rastreamento de ecommerce do GA4 foi feito para você. É padronizado (funciona em plataformas), rico em detalhes (captura informações de produtos) e poderoso (permite análise de ROI e construção de públicos). Este guia o conduzirá pela configuração.
Schema de Eventos de Ecommerce do GA4
O GA4 possui um conjunto padrão de eventos de ecommerce. Use-os em vez de eventos personalizados para melhores resultados.
| Evento | Quando Dispara |
|---|---|
| view_item | Usuário visualiza uma página de detalhe de produto |
| view_item_list | Usuário visualiza uma página de categoria/coleção |
| add_to_wishlist | Usuário adiciona produto à lista de desejos |
| add_to_cart | Usuário adiciona produto ao carrinho |
| remove_from_cart | Usuário remove produto do carrinho |
| view_cart | Usuário visualiza a página do carrinho |
| begin_checkout | Usuário inicia o processo de checkout |
| add_shipping_info | Usuário adiciona endereço/método de envio |
| add_payment_info | Usuário adiciona método de pagamento |
| purchase | Usuário completa a compra |
| refund | Usuário inicia reembolso/devolução |
Cada evento possui um parâmetro items contendo detalhes do produto (nome, preço, quantidade, categoria, etc.).
Etapa 1: Mapeie Seus Eventos
Antes de codificar, decida quais eventos de ecommerce se aplicam à sua loja.
Para Shopify, WooCommerce ou BigCommerce: A maioria das plataformas de ecommerce implementa automaticamente esses eventos se você ativar o GA4. Verifique a documentação de integração GA4 da sua plataforma.
Para código personalizado: Identifique cada ponto de contato:
- Página de produto →
view_item - Adicionar ao carrinho →
add_to_cart - Página do carrinho →
view_cart - Iniciar checkout →
begin_checkout - Informações de pagamento →
add_payment_info - Confirmação de pedido →
purchase
Etapa 2: Implemente Cada Evento
view_item (Usuário Visualiza um Produto)
Dispare este evento quando um usuário chegar em uma página de detalhe de produto.
gtag('event', 'view_item', {
items: [
{
item_id: 'product_12345',
item_name: 'Blue T-Shirt',
affiliation: 'Google Store',
coupon: 'SAVE10',
currency: 'USD',
discount: 5.00,
index: 0,
item_brand: 'My Brand',
item_category: 'Clothing',
item_category2: 'Shirts',
item_variant: 'Blue XL',
price: 49.99,
quantity: 1
}
]
});
Parâmetros-chave:
item_id: Seu SKU de produtoitem_name: Nome do produtoitem_category: Categoria (para segmentação)price: Preço do produtocurrency: Código de moeda (USD, EUR, etc.)
Opcional:
affiliation: Onde o produto é vendido (nome da sua loja)item_variant: Tamanho, cor, estiloitem_brand: Nome da marcacoupon: Qualquer cupom aplicadodiscount: Valor do desconto (se aplicável)
view_item_list (Usuário Visualiza uma Categoria)
Dispare quando um usuário visualiza uma página de coleção/categoria (todos os produtos em uma visualização).
gtag('event', 'view_item_list', {
items: [
{
item_id: 'product_12345',
item_name: 'Blue T-Shirt',
item_category: 'Clothing',
price: 49.99,
currency: 'USD'
},
{
item_id: 'product_67890',
item_name: 'Red T-Shirt',
item_category: 'Clothing',
price: 49.99,
currency: 'USD'
}
],
item_list_name: 'Best Sellers',
item_list_id: 'bestsellers'
});
Inclua todos os produtos mostrados na lista. Adicione item_list_name (como você chama a lista) para relatórios.
add_to_cart
Dispare quando um usuário adiciona um produto ao carrinho.
gtag('event', 'add_to_cart', {
items: [
{
item_id: 'product_12345',
item_name: 'Blue T-Shirt',
affiliation: 'Google Store',
currency: 'USD',
item_category: 'Clothing',
price: 49.99,
quantity: 2
}
],
value: 99.98,
currency: 'USD'
});
Chave: Inclua a quantidade (o usuário pode adicionar 2 do mesmo item). Defina value para o subtotal (preço × quantidade).
view_cart
Dispare quando um usuário visualiza seu carrinho.
gtag('event', 'view_cart', {
items: [
{
item_id: 'product_12345',
item_name: 'Blue T-Shirt',
currency: 'USD',
price: 49.99,
quantity: 2,
item_category: 'Clothing'
},
{
item_id: 'product_67890',
item_name: 'Red Shirt',
currency: 'USD',
price: 39.99,
quantity: 1,
item_category: 'Clothing'
}
],
value: 139.97,
currency: 'USD'
});
Inclua todos os itens atualmente no carrinho e o valor total do carrinho.
begin_checkout
Dispare quando um usuário inicia o processo de checkout (clica no botão "Ir para Checkout").
gtag('event', 'begin_checkout', {
items: [
{
item_id: 'product_12345',
item_name: 'Blue T-Shirt',
currency: 'USD',
price: 49.99,
quantity: 2,
item_category: 'Clothing'
}
],
value: 99.98,
currency: 'USD'
});
Mesmos detalhes de itens do carrinho, mas disparado no início do checkout.
add_shipping_info (Opcional)
Dispare se você quiser rastrear a etapa de envio separadamente.
gtag('event', 'add_shipping_info', {
items: [...],
value: 99.98,
currency: 'USD',
coupon: 'SAVE10',
shipping_tier: 'Ground'
});
add_payment_info (Opcional)
Dispare quando o usuário envia o método de pagamento.
gtag('event', 'add_payment_info', {
items: [...],
value: 99.98,
currency: 'USD',
coupon: 'SAVE10',
payment_type: 'credit_card'
});
purchase (O Mais Importante)
Dispare na página de confirmação de pedido (após o pagamento ser processado).
gtag('event', 'purchase', {
transaction_id: 'order_12345',
affiliation: 'My Store',
value: 129.97,
currency: 'USD',
coupon: 'SAVE10',
tax: 10.00,
shipping: 20.00,
items: [
{
item_id: 'product_12345',
item_name: 'Blue T-Shirt',
affiliation: 'My Store',
coupon: 'SAVE10',
currency: 'USD',
item_category: 'Clothing',
price: 49.99,
quantity: 2
},
{
item_id: 'product_67890',
item_name: 'Red Shirt',
affiliation: 'My Store',
coupon: 'SAVE10',
currency: 'USD',
item_category: 'Clothing',
price: 39.99,
quantity: 1
}
]
});
Parâmetros críticos:
transaction_id: ID de pedido único (não repita)value: Valor total do pedido (incluindo impostos e envio)currency: Código de moedaitems: Todos os produtos do pedidotax: Valor do impostoshipping: Custo de envio
💡 Emily's take: O erro mais comum que vejo é disparar um evento de compra com um formato de
transaction_idincorreto ou repetindo o mesmo ID para múltiplos pedidos. Sempre use um ID de pedido verdadeiramente único. O GA4 usa isso para evitar contagem duplicada.
Etapa 3: Marque Compra como Conversão
- Vá para GA4 → Admin → Events
- Encontre
purchasena lista - Ative Mark as conversion
- Salve
Agora o GA4 trata cada compra como uma conversão e a mostra em relatórios de conversão.
Etapa 4: Verifique a Implementação
Em Tempo Real
- Vá para GA4 → Real-time
- Adicione um produto ao carrinho no seu site
- Procure pelo evento
add_to_cartem tempo real - Continue até o checkout e conclua uma compra
- Procure pelo evento
purchase
Expanda o evento purchase para ver os itens, valor, moeda, etc. Se tudo parecer certo, você conseguiu.
Em Relatórios Padrão
- Vá para GA4 → Reports → Monetization (ou Conversion se ecommerce não estiver aparecendo)
- Você deve ver:
- Eventos de compra, receita, valor médio do pedido
- Produtos comprados
- Funis de conversão (carrinho → checkout → compra)
Relatórios de Ecommerce do GA4
Depois que os eventos estão disparando, o GA4 cria automaticamente relatórios de ecommerce:
Relatórios de Monetização
- Overview: Receita, transações, AOV
- Products: Quais produtos vendem mais, receita por produto
- Shopping behavior: Funil da visualização do carrinho → checkout → compra
Explorations Padrão
Crie relatórios personalizados. Exemplos:
| Pergunta | Exploration |
|---|---|
| Qual categoria de produto tem maior AOV? | Dimensão: item_category. Métrica: Receita por transação. |
| Clientes que usam cupons gastam mais? | Dimensão: coupon. Métrica: Receita por usuário. |
| Qual é a taxa de abandono de carrinho? | Funil: Adicionar ao carrinho → Iniciar checkout → Compra. Veja a queda. |
| Qual fonte de tráfego gera pedidos de maior valor? | Dimensão: Source/medium. Métrica: Receita por transação. |
Multi-Moeda e Internacional
Se você vende em múltiplas moedas:
- Sempre especifique
currencyem cada evento (não assuma) - O GA4 mostra toda a receita na moeda primária da sua propriedade
- As taxas de conversão são aplicadas automaticamente
Exemplo: Um usuário compra em EUR, mas sua propriedade GA4 usa USD. O GA4 converte e relata em USD.
Erros Comuns
Erro 1: Não Incluir Detalhes de Itens
Ruim:
gtag('event', 'purchase', {
value: 99.99,
currency: 'USD'
});
Bom:
gtag('event', 'purchase', {
value: 99.99,
currency: 'USD',
items: [{
item_id: 'prod_123',
item_name: 'Widget',
price: 99.99,
quantity: 1
}]
});
Sem detalhes de itens, você não consegue ver quais produtos estão vendendo. Sempre inclua-os.
Erro 2: Repetir IDs de Transação
Se o ID de pedido "12345" dispara duas vezes, o GA4 o conta duas vezes. Sempre use IDs únicos.
Erro 3: Moeda Incorreta
Especifique moeda por evento, não uma vez globalmente. Se você vende em múltiplas moedas, cada evento deve especificar sua moeda.
Erro 4: Faltam Envio/Imposto no Valor da Compra
O parâmetro value deve ser o valor final cobrado, incluindo impostos e envio.
Perguntas Frequentes
P: E se minha plataforma de ecommerce (Shopify, WooCommerce) já tem integração GA4? R: Ela provavelmente já dispara esses eventos. Verifique as configurações GA4 da sua plataforma para confirmar. Se os dados de ecommerce estão aparecendo em relatórios GA4, você terminou.
P: Posso rastrear reembolsos?
R: Sim, dispare um evento refund quando um usuário devolve um pedido. O GA4 ajustará os cálculos de receita automaticamente.
P: E se minha loja vende produtos digitais (apps, ebooks)? R: Use os mesmos eventos. O tipo de item não importa; o schema de eventos é o mesmo.
P: Posso importar vendas offline (em lojas físicas) para o rastreamento de ecommerce? R: Sim, via Measurement Protocol ou importação CSV. Veja The Complete Guide to Google Analytics 4 (2026).
P: Por que minha receita no GA4 difere de meu Shopify/processador de pagamentos? R: Possíveis causas: diferenças de fuso horário, reembolsos, pedidos de teste, timing de conversão de moeda. Normalmente a diferença é pequena. Investigue se for grande (>5%).
O Resultado Final
O rastreamento de ecommerce do GA4 é poderoso. Implemente os eventos principais (view, cart, purchase) e você terá visibilidade em toda a jornada do cliente. Adicione eventos opcionais (shipping, payment info) para insights ainda mais profundos.
Comece o básico. Deixe os dados fluindo. Depois refine.
Para analisar dados de ecommerce, veja GA4 Explorations: How to Use the Analysis Hub.
Emily Redmond é uma analista de dados na Emilytics — o agente de análise de IA que monitora seus dados do GA4, Google Search Console e Bing 24 horas por dia para que você nunca perca o que importa. 8 anos de experiência ajudando founders e equipes de crescimento transformar ruído de dados em decisões claras. Diga oi →