Rastreamento de Ecommerce no GA4: Guia Completo de Configuração

Emily RedmondAnalista de Dados, Emilytics18 de abril de 2026

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.

EventoQuando Dispara
view_itemUsuário visualiza uma página de detalhe de produto
view_item_listUsuário visualiza uma página de categoria/coleção
add_to_wishlistUsuário adiciona produto à lista de desejos
add_to_cartUsuário adiciona produto ao carrinho
remove_from_cartUsuário remove produto do carrinho
view_cartUsuário visualiza a página do carrinho
begin_checkoutUsuário inicia o processo de checkout
add_shipping_infoUsuário adiciona endereço/método de envio
add_payment_infoUsuário adiciona método de pagamento
purchaseUsuário completa a compra
refundUsuá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 produto
  • item_name: Nome do produto
  • item_category: Categoria (para segmentação)
  • price: Preço do produto
  • currency: Código de moeda (USD, EUR, etc.)

Opcional:

  • affiliation: Onde o produto é vendido (nome da sua loja)
  • item_variant: Tamanho, cor, estilo
  • item_brand: Nome da marca
  • coupon: Qualquer cupom aplicado
  • discount: 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 moeda
  • items: Todos os produtos do pedido
  • tax: Valor do imposto
  • shipping: Custo de envio

💡 Emily's take: O erro mais comum que vejo é disparar um evento de compra com um formato de transaction_id incorreto 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

  1. Vá para GA4 → AdminEvents
  2. Encontre purchase na lista
  3. Ative Mark as conversion
  4. 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

  1. Vá para GA4 → Real-time
  2. Adicione um produto ao carrinho no seu site
  3. Procure pelo evento add_to_cart em tempo real
  4. Continue até o checkout e conclua uma compra
  5. 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

  1. Vá para GA4 → ReportsMonetization (ou Conversion se ecommerce não estiver aparecendo)
  2. 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:

PerguntaExploration
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:

  1. Sempre especifique currency em cada evento (não assuma)
  2. O GA4 mostra toda a receita na moeda primária da sua propriedade
  3. 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 →