Neste guia, descrevemos como manter implementações diferentes de e-commerce da gtag.js do Universal Analytics e do Google Analytics 4.
Acesse a Central de migração do desenvolvedor para ver mais recursos e guias de upgrade.
Resultado
Após acompanhar este guia, você será capaz de implementar os eventos de e-commerce do Google Analytics 4 para uma nova propriedade do GA4 e manter sua implementação atual de e-commerce do Universal Analytics. Você vai enviar eventos diferentes de e-commerce para as propriedades do Universal Analytics e do Google Analytics 4.
Ao implementar o e-commerce para o UA e o GA4, a propriedade do Google Analytics 4 vai usar sua implementação de e-commerce do GA4.
Antes de começar
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
Consulte as opções de upgrade para implementações de e-commerce e saiba mais sobre as vantagens e desvantagens de cada opção. Confirme se você quer seguir este guia e ter duas implementações de análise: uma para as propriedades do Universal Analytics e outra para as do Google Analytics 4.
Vantagens, desvantagens e considerações
Analise as informações abaixo para entender completamente as implicações de ter duas implementações de e-commerce, uma para as propriedades do Universal Analytics e outra para as do Google Analytics 4.
Vantagens | Desvantagens |
---|---|
|
|
Implementação
1. Criar e configurar uma nova propriedade do GA4
Realize as etapas a seguir para criar e configurar sua nova propriedade do Google Analytics 4:
- Crie uma nova propriedade do Google Analytics 4.
- Use o Assistente de configuração do GA4 para criar automaticamente uma nova propriedade do GA4 e copie as seguintes configurações da sua propriedade do Universal Analytics: nome da propriedade, URL do site e configurações de fuso horário e moeda. No entanto, desmarque a opção Ativar a coleta de dados usando suas tags existentes para desabilitar o recurso da tag do site conectada. Como alternativa, se você não quiser copiar as configurações da sua propriedade do Universal Analytics, crie uma propriedade do Google Analytics 4 sem o Assistente de configuração do GA4.
- Encontre o ID da tag da propriedade do GA4. Você vai usar essa informação na próxima etapa para configurar sua propriedade do GA4.
- Adicione a propriedade do GA4.
- Para garantir que os eventos do Universal Analytics sejam enviados apenas à sua propriedade do UA e que os eventos do Google Analytics 4 sejam enviados apenas à sua propriedade do GA4, use o recurso de envio de dados fornecido pela gtag.js.
- Adicione a propriedade do Google Analytics 4 ao snippet atual da gtag.js.
Use o comando
config
e o parâmetrogroups
com o ID da tag para que os eventos possam ser enviados à propriedade do GA4 de modo separado da propriedade do Universal Analytics.
Confira a seguir um exemplo de snippet da gtag.js que configurou uma propriedade do Universal Analytics e uma do Google Analytics 4 atribuída ao grupo do GA4.
<!-- 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', { 'groups': 'GA4' }); // Google Analytics 4 property
</script>
2. Implementar eventos de comércio eletrônico do GA4 e enviá-los para sua propriedade do GA4
Depois de criar e configurar sua nova propriedade do Google Analytics 4, você poderá implementar os eventos de comércio eletrônico do GA4. Para correlacionar sua implementação do GA4 à do Universal Analytics, use os seguintes 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 tabelas Compatibilidade entre eventos do UA e do GA4 e Parâmetros comparáveis do UA e do GA4. Essas informações ajudam a mapear nomes e parâmetros de eventos de e-commerce do Universal Analytics para eventos e parâmetros equivalentes do Google Analytics 4.
- A ferramenta de ajuda de migração para e-commerce confirma se você adicionou eventos de e-commerce do GA4 que são corretos e comparáveis à sua implementação do Universal Analytics.
O exemplo a seguir mostra eventos diferentes de purchase
do Universal Analytics e do Google Analytics 4 que estão sendo enviados às respectivas propriedades usando o parâmetro send_to
para os eventos do GA4:
// Universal Analytics.
// The original UA implementation remains unchanged.
gtag('event', 'purchase', {
"transaction_id": "24.031608523954162",
"affiliation": "Google online store",
"currency": "USD",
"shipping": 7.50,
"tax": 1.80,
"value": 33.30,
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_name": "Search Results",
"list_position": 1,
"quantity": 2,
"price": 12.00
}
]
});
// The new Google Analytics 4 ecommerce implementation.
// Uses `send_to` to route data to the GA4 group defined in the tag config.
gtag('event', 'purchase', {
"send_to": "GA4",
"transaction_id": "24.031608523954162",
"affiliation": "Google online store",
"currency": "USD",
"shipping": 7.50,
"tax": 1.80,
"value": 33.30,
"items": [
{
"item_id": "P12345",
"item_name": "Android Warhol T-Shirt",
"item_brand": "Google",
"item_category": "Apparel/T-Shirts",
"item_variant": "Black",
"quantity": 2,
"price": 12.00
}
],
});