E-commerce do GA4 (gtag.js): enviar eventos do GA4

Neste guia, descrevemos como migrar uma implementação de e-commerce da gtag.js do Universal Analytics para usar eventos de e-commerce do Google Analytics 4.

Acesse a Central de migração do desenvolvedor para ver mais recursos e guias de migração.

Resultado

Ao acompanhar este guia, você implementará eventos de comércio eletrônico do Google Analytics 4 para uma nova propriedade do GA4 e usará esses eventos para preencher os relatórios do Universal Analytics. Sua implementação atual do Universal Analytics será alterada para receber dados de comércio eletrônico do GA4.

Atenção: embora os eventos de comércio eletrônico do Google Analytics 4 sejam convertidos automaticamente para serem compatíveis com o Universal Analytics, nem todos têm um evento equivalente no Universal Analytics. Os dados desses relatórios não serão exibidos nos relatórios de comércio eletrônico do Universal Analytics. Consulte Vantagens e desvantagens e considerações abaixo.

Antes de começar

1. Use a ferramenta de ajuda de migração de comércio eletrônico para confirmar se o seguinte se aplica à sua implementação atual:

   • Você usa uma propriedade do Universal Analytics.
   • Seu site utiliza a biblioteca da gtag.js para enviar eventos de comércio eletrônico

2. Consulte as opções de migração para implementações de comércio eletrônico e saiba mais sobre as vantagens e desvantagens de cada opção. Confirme se você realmente quer seguir este guia para usar os eventos de comércio eletrônico do Google Analytics 4 na sua implementação atual da gtag.js do Universal Analytics.

3. Leia a referência de compatibilidade de evento para saber como os eventos do UA são convertidos quando enviados para uma propriedade do GA4.

Vantagens e desvantagens e considerações

Leia as informações abaixo para entender completamente as implicações de usar os eventos de comércio eletrônico do Google Analytics 4 com sua implementação atual de comércio eletrônico da gtag.js (Universal Analytics).

Vantagens	Desvantagens
Permite que você confira os dados de e-commerce nos seus relatórios do GA4 e do Universal Analytics. Usar eventos e parâmetros do GA4 garante relatórios de comércio eletrônico do GA4 completos.	Exige que você mude os eventos de e-commerce. Nem todos os eventos e parâmetros do GA4 têm equivalentes no Universal Analytics. Os parâmetros shipping_tier, discount, currency, location_id, promotion_name e promotion_id não têm equivalentes do Universal Analytics e não serão exibidos nos seus relatórios correspondentes.

Implementação

1. Atualizar sua implementação de comércio eletrônico

Atualize a implementação atual de comércio eletrônico para migrar dos eventos de comércio eletrônico do Universal Analytics para os eventos do Google Analytics 4. Depois de concluir essa etapa, sua propriedade do Universal Analytics receberá eventos de comércio eletrônico do GA4. Revise a seção Vantagens e desvantagens e considerações para entender as implicações dessa atualização.

Se precisar de ajuda, use estes recursos:

• O guia de comércio eletrônico do Google Analytics 4 para saber como enviar eventos de comércio eletrônico do GA4.
• As informações disponíveis em Compatibilidade entre eventos do UA e do GA4 e Parâmetros comparáveis do UA e do GA4. Essas informações vão ajudar a mapear nomes e parâmetros de eventos de e-commerce do Universal Analytics para eventos e parâmetros equivalentes do GA4.
• Use a ferramenta ajuda de migração de e-commerce para confirmar se você atualizou corretamente seus eventos desse tipo.

2. Criar e configurar uma nova propriedade do GA4

Depois de atualizar sua implementação de e-commerce para enviar eventos de e-commerce do GA4, escolha uma das opções a seguir para começar a enviar dados a uma nova propriedade do Google Analytics 4.

Opção 1: usar o Assistente de configuração do GA4 e ativar as tags do site conectadas

O Assistente de configuração do GA4 criará automaticamente uma nova propriedade do GA4 e copiará as seguintes configurações da sua propriedade do Universal Analytics: nome da propriedade, URL do site, fuso horário e moeda. Também é possível ativar o recurso de tag do site conectada para reutilizar a implementação atual da gtag.js do Universal Analytics e carregar a nova propriedade do GA4.

Siga as etapas descritas no Assistente de configuração do GA4 para criar e configurar uma nova propriedade do Google Analytics 4. Marque a opção Ativar a coleta de dados usando suas tags existentes para usar o recurso de tag do site conectada.

Opção 2: atualizar seu snippet da gtag.js

1. Crie uma nova propriedade do Google Analytics 4.
   • Use o Assistente de configuração do GA4 para adicionar uma propriedade do Google Analytics 4. No entanto, desmarque a opção Ativar a coleta de dados usando suas tags existentes quando solicitado durante a configuração. Se preferir, crie uma propriedade do Google Analytics 4 sem o Assistente de configuração do GA4. A vantagem de usar o Assistente é que ele copia algumas configurações básicas da sua propriedade do Universal Analytics.
2. Encontre o ID da tag da propriedade do GA4.
3. Adicione a propriedade do Google Analytics 4 ao seu snippet atual da gtag.js usando o comando config com o ID da tag.

Confira a seguir um exemplo de snippet da gtag.js que configurou uma propriedade do Universal Analytics e do Google Analytics 4:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-XXXXX-Y"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'UA-XXXXX-Y');  // Universal Analytics property
  gtag('config', 'TAG_ID');  // Google Analytics 4 property
</script>