Como conferir a matriz items em eventos ecommerce do GA4

No GA4, items é um array dentro do evento: cada objeto representa uma linha de produto/serviço, incluindo variantes separadas quando o catálogo as trata como itens diferentes. Revise o payload contra o carrinho ou pedido de origem, não apenas se a chave existe.

Exemplo de pedido com dois itens

gtag('event', 'purchase', {
  transaction_id: 'PEDIDO-TESTE-1042',
  currency: 'BRL',
  value: 89.80,
  shipping: 12.00,
  tax: 0,
  items: [
    {
      item_id: 'CAMISETA-AZUL-P',
      item_name: 'Camiseta azul',
      item_variant: 'Azul / P',
      item_category: 'Vestuário',
      price: 29.90,
      quantity: 2,
      index: 0
    },
    {
      item_id: 'CANECA-INOX-500',
      item_name: 'Caneca inox',
      item_variant: '500 ml',
      item_category: 'Acessórios',
      price: 30.00,
      quantity: 1,
      index: 1
    }
  ]
});

value no exemplo é a soma de price × quantity (R$ 89,80); shipping e tax são enviados em parâmetros separados e não entram nessa soma. Mantenha código e nome estáveis entre view_item, carrinho e compra. A documentação atual exige ao menos item_id ou item_name por item; envie ambos se existem. Inclua currency no evento quando enviar value monetário.

Conferência passo a passo

1. Escolha um pedido de teste com dois SKUs/variantes e quantidades distintas; registre preço unitário, desconto, quantidade, moeda, frete e total confirmado.
2. No DebugView ou ferramenta de rede/data layer, abra view_item, add_to_cart e purchase; confirme que cada linha de items corresponde ao item selecionado e não à cesta inteira duplicada.
3. Confirme price como preço unitário conforme regra de preço/desconto implementada, quantity como quantidade, categoria em níveis coerentes e item_variant distinguindo cor/tamanho quando necessário.
4. Calcule de forma independente Σ(price × quantity) e compare com value esperado. Documente como a loja trata desconto, frete, imposto, cupom, cancelamento e reembolso.
5. Recarregue a página de confirmação: transaction_id precisa continuar representando a mesma transação e o site deve evitar mandar compra duplicada. Não use email, telefone ou nome pessoal em item_id, nome, categoria ou metadados.
6. Confira aba de itens no DebugView e relatório de compras depois do processamento. A sintaxe correta não prova que a fonte da loja tinha o valor comercial correto.

A documentação de ecommerce do GA4 descreve eventos, matriz e parâmetros; a referência de eventos define item_id/item_name e regras de value. Veja testar ecommerce no DebugView e o hub de métricas.