Google Analytics 4 e eventos do lado do servidor

O Google Analytics 4 (GA4) oferece informações em tempo real sobre o tráfego da sua loja, os canais de venda e as conversões, além de ser a base para medir o desempenho das campanhas do Google Ads.

A Jumpseller envia o evento purchase ao Google Analytics 4 (GA4) pelo navegador e, em situações específicas, pelo servidor. O envio pelo servidor usa o Measurement Protocol e também envia o evento purchase ao GA4. Esse fluxo é independente do rastreamento de conversões do Google Ads.

Fluxo atual de purchase

1. Quando um pedido é marcado como pago, a Jumpseller verifica se o comprador chega à página de sucesso do Checkout nos 15 minutos seguintes.
2. Se o comprador chega à página dentro desse período, o navegador envia o evento purchase ao GA4 quando o consentimento para analytics e o rastreamento do navegador estão ativos.
3. Se o comprador não chega à página dentro desse período, a Jumpseller verifica os requisitos para o envio pelo servidor: a Google Analytics API Key precisa estar configurada e o clientID do GA4 precisa estar disponível. Quando os dois requisitos são atendidos, o servidor envia o evento purchase ao GA4 pelo Measurement Protocol. Se algum deles não for atendido, o servidor não envia o evento.

O envio pelo servidor é uma alternativa para pedidos em que o comprador não chega à página de sucesso do Checkout nos 15 minutos seguintes à confirmação do pagamento.

Para habilitar o envio pelo servidor, crie um segredo da API do Measurement Protocol e adicione-o ao campo Google Analytics API Key no painel de administração da Jumpseller. O Google Ads Conversion ID e o respectivo label são configurados separadamente e não fazem parte dos requisitos desse fluxo do GA4. Para configurar o Google Ads, consulte Conecte sua loja ao Google Ads.

Configurar o Google Analytics 4

Primeiro, conecte sua loja à sua conta do Google Analytics usando o ID de medição:

1. Acesse o Google Analytics (se ainda não tiver uma conta, crie uma).

2. Clique em Administrador (ícone de engrenagem no canto inferior esquerdo da tela).

   

3. Se ainda não tiver uma, crie uma propriedade do Google Analytics 4 para sua loja e, dentro dela, um fluxo de dados da Web com o URL da sua loja.

4. Na coluna Propriedade, acesse Coleta e modificação de dados > Fluxos de dados e clique no fluxo da Web.

   

5. Copie o ID de medição (começa com G-).

   

6. No painel de administração da Jumpseller, acesse Configurações > Geral, cole o ID de medição no campo Google Analytics Tracker e clique em Salvar.

   

Configurar a Google Analytics API Key

Para habilitar o envio do evento purchase pelo servidor, crie um segredo da API do Measurement Protocol no Google Analytics e adicione-o à sua loja:

1. Acesse o Google Analytics e clique em Administrador (ícone de engrenagem no canto inferior esquerdo da tela).

2. Na coluna Propriedade, acesse Coleta e modificação de dados > Fluxos de dados.

   

3. Clique no fluxo de dados da Web da sua loja.

4. Role a página para baixo e clique em Segredos da API do Measurement Protocol.
5. Clique em Criar, informe um apelido para a chave (o nome serve apenas para sua referência e não afeta a configuração) e clique em Criar novamente.
6. Copie o Valor do segredo.
7. No painel de administração da Jumpseller, acesse Configurações > Geral, cole o segredo no campo Google Analytics API Key e clique em Salvar.

Os nomes dos menus podem variar um pouco se sua conta do Google Analytics estiver configurada em outro idioma, mas as capturas de tela ajudam a localizar cada seção.

Configurar o Google Ads Conversion ID e Label

As instruções para configurar as conversões do Google Ads estão em Copiar o “ID de conversão” e a “Etiqueta de conversão” para o Jumpseller Analytics.

Eventos da Jumpseller

Depois de conectar sua loja, a Jumpseller envia automaticamente os eventos padrão do GA4 (como page_view) e os seguintes eventos de comércio eletrônico:

O servidor só envia purchase quando a Google Analytics API Key está configurada e o clientID está disponível. O evento enviado pelo navegador depende do consentimento para analytics e das permissões de rastreamento do navegador.

Parâmetros dos eventos

Nos payloads abaixo, cada item de items tem esta estrutura:

{
  item_id: 'product.sku (ou product id se não houver SKU)',
  item_name: 'product.name',
  discount: product.discount,
  item_brand: 'product.brand',
  item_variant: 'product.name_with_options',
  price: product.price,
  currency: 'order.currency',
  quantity: product.quantity
}

page_view

Comportamento padrão do GA4. Nenhum parâmetro extra é enviado.

view_item_list

{
  item_list_name: 'category.name'
}

view_item

{
  currency: 'store.currency',
  value: product.price,
  items: [{ item_id: 'product.sku', item_name: 'product.name', discount: product.discount, item_brand: 'product.brand', price: product.price, currency: 'store.currency' }]
}

search

{
  search_term: searchTerm
}

add_to_cart

{
  currency: 'store.currency',
  value: product.price,
  items: [items]
}

view_cart, begin_checkout, add_shipping_info, add_payment_info

{
  currency: 'store.currency',
  value: order.total,
  items: [items]
}

purchase (navegador)

{
  currency: 'store.currency',
  value: order.total,
  transaction_id: 'order.number',
  shipping: order.shipping,
  tax: order.tax,
  items: [items]
}

Para saber mais sobre eventos e parâmetros, consulte a documentação do Google:

• Eventos recomendados do GA4
• Measurement Protocol (GA4)

Verificar sua configuração

• Abra sua loja em uma nova aba e acesse algumas páginas. Depois, confira em Relatórios > Tempo real no Google Analytics. Sua visita deve aparecer em poucos segundos.
• Os dados detalhados dos eventos podem levar de 24 a 48 horas para aparecer nos relatórios padrão.
• Para depurar evento por evento, use o DebugView.

Perguntas frequentes

• Por que os números do Google Analytics são diferentes dos números do painel da Jumpseller?

O número de visitas no seu painel da Jumpseller geralmente será maior que o do Google Analytics. Nosso sistema interno contabiliza todas as sessões, enquanto o Google Analytics pode ser bloqueado por bloqueadores de anúncios, pela recusa do consentimento de cookies ou pelo JavaScript desativado. Recursos de privacidade, como a Transparência no Rastreamento de Apps (App Tracking Transparency) do iOS da Apple, também reduzem os dados que o Google Analytics pode coletar. As configurações também são diferentes: o Google Analytics contabiliza “usuários” e “sessões” com regras próprias, que não correspondem diretamente às nossas “visitas”.

• Por que não vejo um evento purchase no GA4 se o pedido está pago?

  O evento enviado pelo navegador depende de o comprador chegar à página de sucesso do Checkout nos 15 minutos seguintes à confirmação do pagamento, com o consentimento para analytics e o rastreamento do navegador ativos. Se o comprador não chegar à página dentro desse período, o envio pelo servidor exige que a Google Analytics API Key esteja configurada e que o clientID esteja disponível. Se algum desses requisitos não for atendido, o servidor não envia purchase. O Google Ads Conversion ID e o label não fazem parte dos requisitos desse fluxo do GA4.

• Posso criar um relatório de funil de vendas no GA4?

Sim. O GA4 substituiu as “Metas” e a “Visualização de funil” do Universal Analytics pelas Explorações. Acesse Explorar > Exploração de funil e adicione etapas usando os eventos listados acima (por exemplo, view_item → add_to_cart → begin_checkout → purchase). Consulte o guia de explorações de funil do Google.

• Quais produtos meus clientes estão pesquisando?

  Veja como criar um relatório de pesquisa no Google Analytics.

Outras ferramentas do Google

O Google Analytics funciona melhor quando combinado com as outras ferramentas do Google:

• Conecte sua loja ao Google Ads para medir as conversões das campanhas de anúncios.
• Google Tag Manager para gerenciar tags adicionais sem editar código.
• Google Commerce para sincronizar seus produtos com o Google Merchant Center e o Google Shopping.
• Google Search Console para acompanhar sua presença nos resultados da Pesquisa Google.
• Verifique um domínio para os serviços do Google.
• Google Workspace para ter e-mail corporativo no seu próprio domínio.

Se ainda tiver dúvidas, entre em contato e retornaremos o mais breve possível.