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 eventos para o Google Analytics de duas formas:

• Eventos no navegador, enviados a partir do navegador do seu visitante enquanto navega na sua loja.
• Um evento no servidor, enviado diretamente dos servidores da Jumpseller utilizando o Measurement Protocol para confirmar a conversão de compra para o Google Ads quando uma encomenda é paga.

Para receber eventos do navegador, apenas necessita do seu ID de medição (Measurement ID). Para receber também o evento de conversão do lado do servidor, tem de criar adicionalmente um Segredo da API do Measurement Protocol (adicionado ao campo Google Analytics API Key no seu Painel de Administração Jumpseller) e preencher o seu Google Ads Conversion ID (ID de conversão) e o Google Ads Purchase Event Conversion label (Rótulo de conversão de evento de compra). Recomendamos vivamente que conclua todos estes passos.

Vantagens do evento de conversão do lado do servidor

Apenas com os eventos do navegador, podem falhar compras:

• Gateway de pagamento com a sua própria página de confirmação: com métodos de pagamento como o JumpPay, muitos clientes pagam a encomenda, veem o próprio ecrã de confirmação da passarela e fecham a janela sem nunca regressar à página de sucesso da sua loja. Nesse caso, um evento de compra do lado do navegador nunca é acionado. Com o evento do lado do servidor, a Jumpseller confirma a conversão assim que a encomenda é marcada como paga, quer o cliente regresse ou não à sua loja.
• Bloqueadores de anúncios e definições de privacidade: os visitantes que utilizam bloqueadores de anúncios, que bloqueiam cookies ou JavaScript não são registados pelo rastreio do navegador. O evento do lado do servidor é enviado a partir da nossa infraestrutura e não é afetado.
• Melhor otimização do Google Ads: um registo de conversão mais completo melhora os dados disponíveis para as suas campanhas associadas do Google Ads.

Para que o evento de conversão do lado do servidor seja enviado, é necessário configurar os seguintes quatro campos em Definições > Geral: o Google Analytics Tracker (ID de medição), a Google Analytics API Key (Segredo da API), o Google Ads Conversion ID e o Google Ads Purchase Event Conversion label. As secções abaixo explicam onde encontrar cada valor.

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 ativar os eventos do lado do 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

O evento de conversão do lado do servidor reporta as suas compras ao Google Ads, pelo que também necessita do ID e do rótulo da ação de conversão da sua conta do Google Ads:

1. Inicie sessão no Google Ads e clique no ícone Objetivos na barra lateral esquerda.

2. Em Conversões > Resumo, clique na ação de conversão de Compra que pretende monitorizar (se ainda não tiver uma, crie-a primeiro, consulte como ligar a sua loja com o Google Ads).

   

3. Na secção Configuração da etiqueta, selecione Utilizar o Gestor de Etiquetas do Google. Não necessita do próprio Gestor de Etiquetas, este separador apresenta simplesmente os dois valores.

   

4. Copie o ID de conversão (exclusivo para a sua conta do Google Ads) e o Rótulo de conversão (exclusivo para esta ação de conversão).

5. No seu Painel de Administração Jumpseller, vá a Definições > Geral e cole-os em ID de conversão do Google Ads e GEtiqueta de conversão de evento de compra do Google Ads, depois clique em Gravar.

O Google Ads pode apresentar o ID de conversão como um simples número (por exemplo 17464101497). Introduza-o na Jumpseller no formato AW- apresentado no texto de preenchimento (placeholder) do campo: AW-17464101497.

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 evento conversion é enviado dos nossos servidores apenas quando a Google Analytics API Key está configurada (em conjunto com o seu Google Ads Conversion ID e label). Se a API Key não estiver configurada, o evento é enviado a partir do navegador, na página de Sucesso, que é exatamente o que falha quando os clientes não regressam à sua loja após o pagamento.

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

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

Adicionalmente, para conversões melhoradas, o e-mail e telefone do cliente são enviados como user_data em hash (SHA-256).

conversion (servidor)

{
  client_id: 'o client id do GA capturado no navegador do comprador',
  events: [{
    name: 'conversion',
    params: {
      transaction_id: order.id,
      value: order.total,
      currency: 'order.currency',
      shipping: order.shipping_cost,
      items: [items]
    }
  }],
  send_to: 'GoogleAdsConversionID/ConversionLabel'
}

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 é que as minhas conversões de compra do Google Ads não aparecem, apesar de eu receber encomendas?

Se o seu gateway de pagamento apresentar a sua própria página de confirmação (por exemplo, Webpay), os clientes podem nunca regressar à página de sucesso da sua loja, logo, um evento de conversão do lado do navegador nunca é enviado. Certifique-se de que configurou a Chave de API do Google Analytics como descrito acima, juntamente com o seu ID de conversão de Google Ads e Eiqueta de conversão, a conversão será então enviada dos nossos servidores quando a encomenda for marcada como paga, independentemente do navegador do cliente. Note que as conversões só podem ser atribuídas a visitantes cujo navegador tenha carregado o Google Analytics durante a sua visita (os visitantes que bloqueiam todo o rastreio não podem ser atribuídos no Google Ads).

• 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.