Google Analytics 4 e Eventos do Lado do Servidor

O Google Analytics 4 (GA4) fornece-lhe informações em tempo real sobre o tráfego da sua loja, canais de vendas e conversões, e é a base para medir as campanhas do Google Ads.

A Jumpseller envia o evento purchase ao Google Analytics 4 (GA4) pelo navegador e, em determinadas situações, pelo servidor. O envio pelo servidor utiliza o Measurement Protocol e também envia o evento purchase ao GA4. Esse fluxo é independente da configuração 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 nesse período, o navegador envia o evento purchase ao GA4 quando o consentimento para análise de dados e o rastreio do navegador estão ativos.
3. Se o comprador não chega à página nesse 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 ambos estão disponíveis, o servidor envia o evento purchase ao GA4 pelo Measurement Protocol. Se um deles não estiver disponível, o servidor não envia o evento.

O envio pelo servidor é a alternativa para os 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 Jumpseller. O Google Ads Conversion ID e o respetivo label são configurados separadamente e não fazem parte dos requisitos deste fluxo do GA4. Para configurar o Google Ads, consulte Ligue a sua loja ao Google Ads.

Configurar o Google Analytics 4

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

1. Inicie sessão no Google Analytics (crie primeiro uma conta se não tiver uma).

2. Clique em Administração (ícone de engrenagem no canto inferior esquerdo do ecrã).

   

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

4. Na coluna Propriedade, vá a Recolha e modificação de dados > Fluxos de dados e clique no seu fluxo web.

   

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

   

6. No seu Painel de Administração Jumpseller, vá a Definições > Geral, cole o ID de medição no campo Google Analytics Tracker e clique em Gravar.

   

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. Inicie sessão no Google Analytics e clique em Administração (ícone de engrenagem no canto inferior esquerdo do ecrã).

2. Na coluna Propriedade, vá a Recolha e modificação de dados > Fluxos de dados.

   

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

4. Desloque-se para baixo e clique em Segredos da API do Protocolo de Medição.
5. Clique em Criar, insira uma alcunha 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 seu Painel de Administração Jumpseller, vá a Definições > Geral, cole o segredo no campo Chave da API do Google Analytics e clique em Gravar.

Alguns nomes de menus podem variar ligeiramente se a sua conta do Google Analytics estiver configurada noutro idioma, mas as capturas de ecrã deverão ajudá-lo a localizar cada secçã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

Uma vez ligada, a Jumpseller envia automaticamente os eventos predefinidos do GA4 (como o 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 análise de dados e das permissões de rastreio do navegador.

Parâmetros dos Eventos

Nos payloads abaixo, cada entrada 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 predefinido do GA4. Sem parâmetros extra enviados.

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 mais informações sobre eventos e parâmetros, por favor reveja a documentação da Google:

• Eventos recomendados do GA4
• Measurement Protocol (GA4)

Verificar a sua configuração

• Abra a sua loja num novo separador e navegue por algumas páginas, depois verifique em Relatórios > Tempo real no Google Analytics. A sua visita deverá aparecer em poucos segundos.
• Os dados detalhados de eventos podem demorar entre 24 a 48 horas a aparecer nos relatórios padrão.
• Para depuração evento a evento, utilize o DebugView.

FAQs

• Porque é que os números no Google Analytics são diferentes dos do meu Painel Jumpseller?

O número de visitas no seu Painel Jumpseller será geralmente superior ao do Google Analytics. O nosso sistema interno contabiliza todas as sessões, enquanto o Google Analytics pode ser bloqueado por bloqueadores de anúncios, recusa de consentimento de cookies ou JavaScript desativado. Funcionalidades de privacidade como o App Tracking Transparency do iOS da Apple também reduzem os dados que o Google Analytics pode recolher. As definições também diferem: o Google Analytics contabiliza “utilizadores” e “sessões” usando as suas próprias regras, que não correspondem diretamente às nossas “visitas”.

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

  O evento enviado pelo navegador depende do comprador chegar à página de sucesso do Checkout nos 15 minutos seguintes ao pedido ser marcado como pago, com o consentimento para análise de dados e o rastreio do navegador ativos. Se o comprador não chegar à página nesse período, o envio pelo servidor requer a Google Analytics API Key configurada e o clientID disponível. Quando um desses requisitos não é atendido, o servidor não envia purchase. O Google Ads Conversion ID e o respetivo label não fazem parte dos requisitos deste fluxo do GA4.

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

Sim. O GA4 substituiu os “Objetivos” e a “Visualização de funil” do Universal Analytics por Explorações. Vá a Explorar > Exploração de funil e adicione passos utilizando os eventos listados acima (por exemplo view_item → add_to_cart → begin_checkout → purchase). Consulte o guia de explorações de funil do Google.

• Que produtos é que os meus clientes estão a pesquisar?

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

Outras ferramentas Google

O Google Analytics funciona melhor quando combinado com o resto do ecossistema Google:

• Ligue a sua loja com o Google Ads para medir as conversões de campanhas publicitárias.
• Google Tag Manager para gerir etiquetas adicionais sem editar código.
• Google Commerce para sincronizar os seus produtos com o Google Merchant Center e Google Shopping.
• Google Search Console para monitorizar a sua presença nos resultados da Pesquisa Google.
• Verifique um domínio para serviços Google.
• Google Workspace para e-mail corporativo no seu próprio domínio.

Se ainda tiver dúvidas, por favor contacte-nos e entraremos em contacto consigo o mais breve possível.