Compatibilidade de eventos de e-commerce e referência de conversão (gtag.js)

Neste documento, descrevemos a compatibilidade e a conversão de eventos de e-commerce entre o Universal Analytics (UA) e o Google Analytics 4 (GA4).

Contexto

Os eventos de e-commerce do GA4 são convertidos automaticamente em eventos equivalentes do UA quando enviados para uma propriedade do UA. A conversão também ocorre ao enviar eventos de e-commerce do UA a uma propriedade do GA4. Neste documento, explicamos como a conversão funciona, a compatibilidade dos eventos e as vantagens/desvantagens de usar a conversão automática.

Objetivo

Veja a seguir os benefícios da conversão entre os eventos de comércio eletrônico do UA e do GA4:

• Facilidade de implementação: adote o comércio eletrônico do GA4 usando a implementação atual do UA com uma pequena atualização na configuração.
• Elimina a necessidade de usar a inclusão dupla de tags: você pode enviar os mesmos eventos de e-commerce a uma propriedade do UA e do GA4. Assim, é possível fazer a transição para o GA4 e manter sua implementação de e-commerce do UA, sem precisar de uma configuração com duas tags.

Contrapartidas

A compatibilidade oferece flexibilidade para escolher um caminho de migração do GA4 mais adequado para atender aos seus requisitos de manutenção da implementação do UA de curto e longo prazo.

A maioria dos eventos/parâmetros de comércio eletrônico do GA4 é compatível com o UA e vice-versa. Para os casos raros em que há incompatibilidade, dependendo do tipo de migração que você faz, seus relatórios de comércio eletrônico do UA ou GA4 podem não ser totalmente preenchidos com dados.

É importante revisar cada opção de migração para saber mais sobre a compatibilidade e a configuração necessária.

Como funciona a conversão

• Quando um evento de comércio eletrônico do GA4 é enviado para uma propriedade do UA, ele é convertido no evento de comércio eletrônico do UA (gtag.js) equivalente.
  • Os parâmetros de evento do UA são preenchidos com valores dos parâmetros do GA4 comparáveis. Se um parâmetro do UA não puder ser preenchido usando um evento do GA4, ou seja, não houver equivalente, ele será omitido quando o evento for enviado à propriedade do UA.
• Quando um evento de comércio eletrônico do UA (gtag.js) é enviado para uma propriedade do GA4, ele é convertido no evento de comércio eletrônico do GA4 equivalente.
  • Os parâmetros de evento do GA4 são preenchidos com valores dos parâmetros do UA comparáveis. Se um parâmetro do GA4 não puder ser preenchido usando um evento do UA, ou seja, não houver equivalente, ele será omitido quando o evento for enviado à propriedade do GA4. Em alguns casos, se um parâmetro do UA não tiver um parâmetro do GA4 comparável, ele será enviado com o evento do GA4 como um parâmetro personalizado.
• Todas as conversões do GA4 para o UA e vice-versa são realizadas no lado do cliente.
• As conversões de eventos/parâmetros são ativadas por padrão. Nenhuma configuração do usuário é necessária, e esse recurso não pode ser desativado.

Parâmetros comparáveis do UA e do GA4

A tabela a seguir mostra parâmetros de comércio eletrônico comparáveis no Universal Analytics e no Google Analytics 4.

Observação: uma célula de tabela vazia indica que não há um parâmetro comparável.

Nome do parâmetro do Universal Analytics	Nome do parâmetro do Google Analytics 4	Observação
affiliation	affiliation
checkout_step
checkout_option
content_type
coupon	coupon
currency	currency	Ao enviar um evento do UA a uma propriedade do GA4, esse valor de moeda será usado para o parâmetro items[].currency do GA4.
	location_id
	payment_type
shipping	shipping
shipping_tier
tax	tax
transaction_id	transaction_id
value	value
items[]	items[]
items[].name	items[].item_name
items[].id	items[].item_id
	items[].affiliation
items[].brand	items[].item_brand
items[].category	items[].item_category items[].item_category2 items[].item_category3 items[].item_category4 items[].item_category5	Categoria do item. É possível especificar até cinco níveis de hierarquia. Consulte Conversão de parâmetros de categoria para ver detalhes sobre como funciona a conversão de categoria entre eventos do UA e GA4.
	items[].currency
items[].coupon	items[].coupon
	items[].discount
items[].list_name	items[].item_list_name
items[].list_position	items[].index
	items[].location_id
items[].price	items[].price
items[].quantity	items[].quantity
items[].variant	items[].item_variant
promotions[]		Para o GA4, items[] é usado com parâmetros específicos para promoção, como items[].promotion_id.
promotions[].id	items[].promotion_id	Esses parâmetros não são convertidos ao enviar um evento do UA para GA4 ou vice-versa.
promotions[].name	items[].promotion_name	Esses parâmetros não são convertidos ao enviar um evento do UA para GA4 ou vice-versa.
promotions[].creative_name
promotions[].creative_slot	items[].creative_slot	Esses parâmetros não são convertidos ao enviar um evento do UA para GA4 ou vice-versa.

Conversão de parâmetros de categoria

A conversão de parâmetros da categoria é realizada como um caso especial ao enviar eventos do GA4 ao UA ou vice-versa.

Para o Universal Analytics, ao definir o parâmetro items[].category, use / como um delimitador para especificar até cinco níveis de hierarquia. No Google Analytics 4, utilize parâmetros de categoria enumerada para especificar até cinco níveis de hierarquia: items[].item_category .items[].item_category2 ,items[].item_category3 .items[].item_category4 e items[].item_category5.

A conversão de categoria acontece da seguinte forma:

• Para eventos do GA4 convertidos para o UA, as categorias enumeradas serão combinadas em um único parâmetro category, delimitadas por /.
• No caso de eventos do UA convertidos para o GA4, o valor do parâmetro de categoria será dividido para preencher as categorias enumeradas do GA4 correspondentes.
• Se você pretende enviar eventos do GA4 ao UA, não use o caractere / nos valores de categoria, porque ele será interpretado como delimitador.
• Somente os cinco primeiros níveis de categoria serão usados, não importa quantos tiverem sido definidos.

Exemplo de conversão de categoria

Os exemplos a seguir mostram um parâmetro de categoria do UA convertido para o GA4. O mesmo princípio se aplica ao converter um evento do GA4 para o UA.

Um evento do UA que tem uma categoria com cinco níveis de hierarquia:

gtag("event", "add_to_cart", {
  items: [{
    ...
    category: "Apparel/Adult/Shirts/Crew/Short sleeve",
    ...
  }]
});

O evento do UA convertido em um evento do GA4 com categorias enumeradas:

gtag("event", "add_to_cart", {
  items: [{
    ...
    item_category: "Apparel",
    item_category2: "Adult",
    item_category3: "Shirts",
    item_category4: "Crew",
    item_category5: "Short sleeve",
    ...
  }]
});

Compatibilidade entre eventos do UA e do GA4

A tabela abaixo mostra eventos de comércio eletrônico comparáveis do Universal Analytics e do Google Analytics 4 e o comportamento de conversão ao enviar um evento do UA para o GA4 e vice-versa.

As colunas em cada linha da tabela apresentam as seguintes informações:

• As colunas Evento do UA e Evento do GA4 indicam eventos comparáveis com base no que eles pretendem medir.
• Parâmetros mostra os parâmetros sem valor equivalente entre os respectivos eventos do UA e do GA4. Somente GA4 exibe os parâmetros que são usados apenas com o evento do GA4, e Somente UA indica os parâmetros que são usados apenas com o evento do UA.
• Comportamento de conversão (envio do UA para o GA4) descreve o comportamento de conversão ao transmitir um evento do UA para uma propriedade do GA4. As observações mostram detalhes sobre os dados enviados, as diferenças em relação ao evento do GA4 e os efeitos nos relatórios do GA4.
• Comportamento de conversão (envio do GA4 para o UA) descreve o comportamento de conversão ao transmitir um evento do UA para uma propriedade do GA4. As observações mostram detalhes sobre os dados enviados, as diferenças em relação ao evento do UA e efeitos nos relatórios do UA.

Evento do UA	Evento do GA4	Parâmetros	Comportamento de conversão (envio do UA para o GA4)	Comportamento de conversão (envio do GA4 para o UA)
view_item_list	view_item_list	Somente GA4: item_list_id item_list_name items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatível. Todos os parâmetros do UA são convertidos em parâmetros equivalentes do GA4 e enviados. Os relatórios do GA4 que exigirem parâmetros Somente GA4 ficarão incompletos.	Compatível. Os parâmetros do GA4 com um parâmetro do UA equivalente são convertidos e enviados. Parâmetros Somente GA4 não são transmitidos. O parâmetro item_list_name no nível do evento é ignorado, e apenas o item_list_name no nível do item é enviado. Os relatórios do UA preenchidos com dados do evento do GA4 serão concluídos ou permanecerão inalterados.
select_content (items)	select_item	Somente GA4: item_list_id item_list_name items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id Somente UA: content_type	Não compatível. Um evento personalizado select_content e um parâmetro personalizado content_type são enviados. Os dados de items não são transmitidos.	Não compatível. Um hit de evento do UA é enviado com general como event_category e select_item como event_action. Os dados de items não são enviados.
select_content (promotions)	select_promotion	Somente GA4: creative_name creative_slot location_id promotion_id promotion_name items Somente UA: content_type promotions	Não é compatível. Um evento personalizado select_content é enviado com content_type e promotions como parâmetros personalizados. O parâmetro personalizado promotions não contém dados úteis.	Não compatível. Um hit de evento do UA é enviado com general como event_category e select_promotion como event_action. Os dados de promotions não são enviados.
view_item	view_item	Somente GA4: currency value items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatível. Todos os parâmetros do UA são convertidos em parâmetros equivalentes do GA4 e enviados. Os relatórios do GA4 que exigirem parâmetros Somente GA4 ficarão incompletos.	Compatível. Os parâmetros do GA4 com um parâmetro do UA equivalente são convertidos e enviados. A exceção é item_list_name, que não é enviado. Dos parâmetros somente GA4, currency e value são enviados com o hit como currency e Transaction revenue, respectivamente. event_value também é definido como o parâmetro value como número inteiro. A conversão do GA4 para o UA inclui event_value, mas isso normalmente não é definido para hits do UA. A maioria dos relatórios do UA preenchidos com dados do evento do GA4 serão concluídos ou permanecerão inalterados. Faltará o nome da lista de itens.
add_to_wishlist* *Os dados do items não são compatíveis com o UA.	add_to_wishlist	Somente GA4: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatível. Todos os parâmetros do UA são convertidos em parâmetros equivalentes do GA4 e enviados. Os relatórios do GA4 que exigirem parâmetros Somente GA4 ficarão incompletos.	Compatível. Um hit de evento equivalente é enviado com ecommerce como event_category, add_to_wishlist como event_action e o parâmetro value como event_value. Os relatórios do UA preenchidos com dados do evento do GA4 serão concluídos ou permanecerão inalterados. Como esse evento geralmente não é compatível com os relatórios de comércio eletrônico do UA, ele não terá nenhum efeito relevante.
add_to_cart	add_to_cart	Somente GA4: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatível. Todos os parâmetros do UA são convertidos em parâmetros equivalentes do GA4 e enviados. Os relatórios do GA4 que exigirem parâmetros Somente GA4 ficarão incompletos.	Compatível. Os parâmetros do GA4 com um parâmetro do UA equivalente são convertidos e enviados.* Parâmetros Somente GA4 não são transmitidos. *item_list_name não é transmitido, mas esse comportamento é consistente com a gtag.js (UA), que não envia list_name. Os relatórios do UA preenchidos com dados do evento do GA4 serão concluídos ou permanecerão inalterados.
remove_from_cart	remove_from_cart	Somente GA4: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatível. Todos os parâmetros do UA são convertidos em parâmetros equivalentes do GA4 e enviados. Os relatórios do GA4 que exigirem parâmetros Somente GA4 ficarão incompletos.	Compatível. Os parâmetros do GA4 com um parâmetro do UA equivalente são convertidos e enviados.* Parâmetros Somente GA4 não são transmitidos. *item_list_name não é transmitido, mas esse comportamento é consistente com a gtag.js (UA), que não envia list_name. Os relatórios do UA preenchidos com dados do evento do GA4 serão concluídos ou permanecerão inalterados.
N/A	view_cart	O evento só é recomendado para o GA4.	Não compatível*. *É improvável que sua implementação do UA envie esse evento, já que ele não é recomendado. Para garantir que os relatórios do GA4 sejam completos, implemente esse evento no UA usando o formato do GA4. Se você implementar o evento do GA4 para o UA, ele será exibido como um evento sem dados de items, o que não é muito útil. Isso não afetará os relatórios de comércio eletrônico do UA.	Não compatível. Um hit de evento é enviado com general como event_category, view_cart como event_action e o parâmetro value como event_value. Os dados de items não são enviados. Como esse evento geralmente não é compatível com os relatórios de comércio eletrônico do UA, ele não terá nenhum efeito relevante.
begin_checkout	begin_checkout	Somente GA4: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatível. Todos os parâmetros do UA são convertidos em parâmetros equivalentes do GA4 e enviados. Os relatórios do GA4 que exigirem parâmetros Somente GA4 ficarão incompletos.	Compatível. Os parâmetros do GA4 com um parâmetro do UA equivalente são convertidos e enviados.* Parâmetros Somente GA4 não são transmitidos. *item_list_name não é transmitido, mas esse comportamento é consistente com a gtag.js (UA), que não envia list_name. begin_checkout equivale a enviar um evento checkout_progress com checkout_step definido como 1. Os relatórios do UA preenchidos com dados do evento do GA4 serão concluídos ou permanecerão inalterados.
add_payment_info	add_payment_info	Somente GA4: currency value coupon payment_type items UA: N/D: os parâmetros não são compatíveis.	Não compatível*. *Como o UA não é compatível com parâmetros para esse evento, nenhum parâmetro é enviado. Isso funciona, mas provavelmente não será muito útil. Os relatórios do GA4 que exigirem quaisquer parâmetros de evento ficarão incompletos.	Compatível. Um hit de evento equivalente é enviado com ecommerce como event_category, add_to_wishlist como event_action e o parâmetro value (transmitido com número inteiro) como event_value. A conversão do GA4 para o UA inclui event_value, mas isso normalmente não é definido para hits do UA. Os relatórios do UA preenchidos com dados do evento do GA4 serão concluídos ou permanecerão inalterados. Como esse evento geralmente não é compatível com os relatórios de comércio eletrônico do UA, ele não terá nenhum efeito relevante.
N/D	add_shipping_info	O evento só é recomendado para o GA4.	Não compatível*. *É improvável que sua implementação do UA envie esse evento, já que ele não é recomendado. Para garantir que os relatórios do GA4 sejam completos, implemente esse evento no UA usando o formato do GA4. Se você implementar o evento do GA4 para o UA, ele será exibido como um evento sem dados de items, o que não é muito útil. Isso não afetará os relatórios de comércio eletrônico do UA.	Não compatível*. Um hit de evento é enviado com general como event_category, add_shipping_info como event_action e o parâmetro value (transmitido com número inteiro) como event_value. O parâmetro currency do GA4 é enviado com o hit como currency. Como esse evento geralmente não é compatível com os relatórios de comércio eletrônico do UA, ele não terá nenhum efeito relevante.
checkout_progress set_checkout_option	N/A	Eventos são recomendados apenas para o UA.	O evento será tratado como um evento personalizado. Apenas parâmetros no evento serão enviados. Os dados de items não serão transmitidos. Como esses eventos geralmente não são compatíveis com os relatórios de e-commerce do GA4, eles não terão efeito relevante.	N/A
view_promotion	view_promotion	Somente GA4: creative_name creative_slot location_id promotion_id promotion_name items Somente UA: promotions	Não compatível. Um evento personalizado view_promotion é enviado com promotions como parâmetro personalizado. O parâmetro personalizado promotions não contém dados úteis.	Não compatível. Um hit de evento do UA é enviado com engagement como event_category e view_promotion como event_action. Os dados de promotions não são enviados. O evento é marcado como sem interação.
purchase	purchase	Somente GA4: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatível. Todos os parâmetros do UA são convertidos em parâmetros equivalentes do GA4 e enviados. O currency no nível do evento é usado porque currency no nível do item não é compatível. Os relatórios do GA4 que exigirem parâmetros Somente GA4 ficarão incompletos.	Compatível. Os parâmetros do GA4 com um parâmetro do UA equivalente são convertidos e enviados.* Parâmetros Somente GA4 não são transmitidos. *item_list_name não é transmitido, mas esse comportamento é consistente com a gtag.js (UA), que não envia list_name. Os relatórios do UA preenchidos com dados do evento do GA4 serão concluídos ou permanecerão inalterados.
refund	refund	Somente GA4: affiliation items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatível. Todos os parâmetros do UA são convertidos em parâmetros equivalentes do GA4 e enviados. O currency no nível do evento é usado porque currency no nível do item não é compatível. Os relatórios do GA4 que exigirem parâmetros Somente GA4 ficarão incompletos.	Compatível. Os parâmetros do GA4 com um parâmetro do UA equivalente são convertidos e enviados.* Parâmetros Somente GA4 não são transmitidos. *item_list_name não é transmitido, mas esse comportamento é consistente com a gtag.js (UA), que não envia list_name. Os relatórios do UA preenchidos com dados do evento do GA4 serão concluídos ou permanecerão inalterados.