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

Neste guia, descrevemos como usar uma implementação de e-commerce da gtag.js do Universal Analytics para enviar eventos de e-commerce a uma propriedade 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ê usará sua implementação atual do Universal Analytics para preencher uma nova propriedade do Google Analytics 4. A implementação atual do Universal Analytics não será alterada. Os relatórios de comércio eletrônico do UA continuarão sendo preenchidos com dados, e você começará a receber dados na nova propriedade do Google Analytics 4.

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 sua implementação atual da gtag.js do Universal Analytics no Google Analytics 4.

  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 sua implementação atual de comércio eletrônico da gtag.js (Universal Analytics) com uma propriedade do Google Analytics 4.

Vantagens Desvantagens
  • É a opção mais fácil de implementar, já que você não altera suas tags de evento atuais de comércio eletrônico.
  • Permite que você veja os dados de comércio eletrônico nos seus relatórios do GA4 e do Universal Analytics.
  • Não há mudanças na forma como os dados de comércio eletrônico são coletados ou informados na sua propriedade do Universal Analytics.
  • Os eventos select_content, checkout_progress, set_checkout_option e view_refund não são reconhecidos no GA4 e não aparecerão nos relatórios de comércio eletrônico do GA4.
    • Os eventos acima e os parâmetros associados serão tratados como eventos e parâmetros personalizados no GA4. No entanto, os dados não serão enviados ao Google Analytics para o parâmetro items, porque ele não é compatível como parâmetro personalizado.
  • A etapa Adicionar informações de frete no Relatório de funil de detalhes do carrinho/fallout do GA4 estará vazia.
  • A etapa Cliques na lista no Relatório de funil da lista de mercadorias/produtos/itens do GA4 estará vazia.
  • O delimitador / da categoria não é reconhecido no GA4. O GA4 informará cat1/cat2/cat3 como uma única categoria em vez de três (ou seja, cat1, cat2 e cat3).

Implementação

Escolha uma das opções a seguir para usar uma implementação atual da gtag.js do Universal Analytics para enviar eventos de comércio eletrônico a uma 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 copiará algumas configurações básicas da sua propriedade do Universal Analytics.
  2. Encontre o ID de métricas da propriedade do Google Analytics 4.
  3. Adicione a propriedade do Google Analytics 4 ao seu snippet atual da gtag.js usando o comando config com o ID de métricas.

Veja 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>