Compatibilidad de los eventos de comercio electrónico y referencia de traducción (gtag.js)

En este documento, se describe la compatibilidad y la traducción de los eventos de comercio electrónico entre Universal Analytics (UA) y Google Analytics 4 (GA4).

Información general

Los eventos de comercio electrónico de GA4 se traducen automáticamente a eventos de UA equivalentes cuando se envían a una propiedad UA. La traducción también se produce cuando se envían eventos de comercio electrónico de UA a una propiedad GA4. En este documento, se explica cómo funciona la traducción, la compatibilidad de los eventos y las concesiones que podrías tener si usas la traducción automática.

Objetivo

La traducción de los eventos de comercio electrónico de UA y GA4 es útil para lo siguiente:

• Facilidad de implementación: Adopta el comercio electrónico de GA4 con tu implementación de UA existente con una actualización menor de configuración.
• Elimina la necesidad de usar doble etiqueta: Puedes enviar los mismos eventos de comercio electrónico a una propiedad UA y GA4. Esto proporciona una opción para hacer la transición a GA4 y mantener tu implementación de comercio electrónico de UA, sin necesidad de mantener una configuración de doble etiqueta.

Concesiones

La compatibilidad proporciona flexibilidad para elegir la ruta de migración de GA4 más adecuada para cumplir con los requisitos a corto y largo plazo de mantener tu implementación de UA.

La mayoría de los eventos o parámetros de comercio electrónico de GA4 son compatibles con UA y viceversa. En la pequeña cantidad de casos en los que existen incompatibilidades, según la opción de migración que elijas, es posible que tus informes de comercio electrónico de UA o de GA4 no se propaguen por completo con datos.

Es importante que revises cada opción de migración para obtener detalles sobre la compatibilidad y la configuración requerida.

Cómo funciona la traducción

• Cuando se envía un evento de comercio electrónico de GA4 a una propiedad UA, el evento se traduce al evento de comercio electrónico de UA (gtag.js) equivalente.
  • Los parámetros de eventos de UA se propagan con valores de parámetros de GA4 comparables. Si un parámetro de UA no se puede propagar a partir de un evento de GA4 (es decir, no hay un parámetro comparable), el parámetro se omitirá cuando el evento se envíe a la propiedad UA.
• Cuando se envía un evento de comercio electrónico de UA (gtag.js) a una propiedad GA4, el evento se traduce al evento de comercio electrónico de GA4 equivalente.
  • Los parámetros de eventos de GA4 se propagan con valores de parámetros de UA comparables. Si un parámetro de GA4 no se puede propagar desde un evento de UA (es decir, no hay un parámetro equivalente), el parámetro se omitirá cuando el evento se envíe a la propiedad GA4. En algunos casos, si un parámetro de UA no tiene un parámetro de GA4 comparable, el parámetro se enviará con el evento de GA4 como parámetro personalizado.
• Todas las traducciones de GA4 a UA y viceversa se realizan del lado del cliente.
• Las traducciones de eventos o parámetros están habilitadas de forma predeterminada, no se requiere la configuración del usuario y no se puede inhabilitar.

Parámetros comparables para UA y GA4

En la siguiente tabla, se muestran los parámetros de comercio electrónico comparables para Universal Analytics y Google Analytics 4.

Nota: Una celda vacía de la tabla indica que no hay un parámetro comparable.

Nombre del parámetro de Universal Analytics	Nombre del parámetro de Google Analytics 4	Notas
affiliation	affiliation
checkout_step
checkout_option
content_type
coupon	coupon
currency	currency	Cuando se envíe un evento de UA a una propiedad GA4, este valor de moneda se utilizará para el parámetro items[].currency de 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	La categoría del artículo Se pueden especificar hasta 5 niveles de jerarquía. Consulta Traducción de parámetros de categorías para obtener detalles sobre cómo se maneja la traducción de categorías entre los eventos de UA y 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[]		En GA4, items[] se usa con parámetros específicos de la promoción, como items[].promotion_id.
promotions[].id	items[].promotion_id	Estos parámetros no se traducen cuando se envía un evento de UA a GA4 o viceversa.
promotions[].name	items[].promotion_name	Estos parámetros no se traducen cuando se envía un evento de UA a GA4 o viceversa.
promotions[].creative_name
promotions[].creative_slot	items[].creative_slot	Estos parámetros no se traducen cuando se envía un evento de UA a GA4 o viceversa.

Traducción de parámetros de categoría

La traducción del parámetro de categoría se maneja como un caso especial cuando se envían eventos de GA4 a UA o viceversa.

En el caso de Universal Analytics, cuando configuras el parámetro items[].category, debes usar / como delimitador para especificar hasta cinco niveles de jerarquía. En Google Analytics 4, usas los parámetros de categorías enumerados para especificar hasta cinco niveles de jerarquía: items[].item_category, items[].item_category2, items[].item_category3, items[].item_category4 y items[].item_category5.

El comportamiento de la traducción por categorías es el siguiente:

• En el caso de los eventos de GA4 traducidos a UA, las categorías enumeradas se combinarán en un solo parámetro category, con cada categoría delimitada por /.
• Para los eventos de UA traducidos a GA4, el valor del parámetro de categoría se dividirá para propagar las categorías enumeradas de GA4 correspondientes.
• Si deseas enviar eventos de GA4 a UA, te recomendamos que no uses el carácter / en los valores de categoría, ya que se interpretará como un delimitador de categoría cuando se traduzca a UA.
• Solo se utilizarán los primeros 5 niveles de categoría, independientemente de cuántos estén definidos.

Ejemplo de traducción de la categoría

En los siguientes ejemplos, se muestra un parámetro de categoría de UA traducido a GA4. El mismo principio se aplica cuando se traduce un evento de GA4 a UA.

Un evento de UA con una categoría que define 5 niveles de jerarquía:

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

El evento de UA traducido a un evento de GA4, con categorías enumeradas:

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

Compatibilidad entre los eventos de UA y de GA4

En la siguiente tabla, se muestran eventos de comercio electrónico comparables para Universal Analytics y Google Analytics 4, y el comportamiento de las traducciones cuando se envía un evento de UA a GA4 y viceversa.

Cada columna de la tabla proporciona la siguiente información:

• Las columnas Evento de UA y Evento de GA4 indican eventos comparables en función de lo que se pretenden medir.
• En Parámetros, se enumeran los parámetros sin equivalente entre los respectivos eventos de UA y GA4. Solo GA4 enumera los parámetros que solo se utilizan con el evento de GA4 y solo UA enumera los parámetros que solo se utilizan con el evento de UA.
• En Comportamiento de la traducción (envío de UA a GA4), se describe el comportamiento de la traducción cuando se envía un evento de UA a una propiedad GA4. Las notas proporcionan detalles sobre los datos enviados, las diferencias con el evento de GA4 y los efectos destacados en los informes de GA4.
• En Comportamiento de la traducción (envío de GA4 a UA) se describe el comportamiento de la traducción cuando se envía un evento de UA a una propiedad GA4. Las notas proporcionan detalles sobre los datos enviados, las diferencias con el evento de UA y los efectos notables en los informes de UA.

Evento de UA	Evento de GA4	Parámetros	Comportamiento de la traducción (envío de UA a GA4)	Comportamiento de la traducción (envío de GA4 a UA)
view_item_list	view_item_list	Solo GA4: item_list_id item_list_name items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatible. Todos los parámetros de UA se traducen a equivalentes de GA4 y se envían. Los informes de GA4 que requieran algún parámetro de solo GA4 estarán incompletos.	Compatible. Los parámetros de GA4 con un parámetro de UA equivalente se traducen y envían. No se envían los parámetros solo GA4. Se ignora el parámetro item_list_name a nivel del evento; solo se enviará el item_list_name a nivel del elemento. Los informes de UA propagados con datos del evento de GA4 estarán completos o sin cambios.
select_content (items)	select_item	Solo GA4: item_list_id item_list_name items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id Solo para UA: content_type	No compatible. Se envían un evento personalizado select_content y un parámetro personalizado content_type. No se envían datos de items.	No compatible. Un hito del evento de UA se envía con general como event_category y select_item como event_action. No se envían datos de items.
select_content (promotions)	select_promotion	Solo GA4: creative_name creative_slot location_id promotion_id promotion_name items Solo para UA: content_type promotions	No compatible. Se envía un evento personalizado select_content con content_type y promotions como parámetros personalizados. El parámetro personalizado promotions no contiene ningún dato útil.	No compatible. Un hito del evento de UA se envía con general como event_category y select_promotion como event_action. No se envían datos de promotions.
view_item	view_item	Solo GA4: currency value items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatible. Todos los parámetros de UA se traducen a equivalentes de GA4 y se envían. Los informes de GA4 que requieran algún parámetro de solo GA4 estarán incompletos.	Compatible. Los parámetros de GA4 con un parámetro de UA equivalente se traducen y envían. La excepción es item_list_name, que no se envía. De los parámetros de solo GA4, currency y value se envían con el hit como moneda y ingresos por transacciones, respectivamente. event_value también se configura en el parámetro value, como un número entero. Ten en cuenta que la traducción de GA4 a UA incluye event_value, pero normalmente no se establece para hits de UA. Los informes de UA completados con datos de GA4 estarán casi completos o sin cambios. Faltará el nombre de la lista de artículos.
add_to_wishlist* *Los datos de items no se admiten para UA.	add_to_wishlist	Solo GA4: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatible. Todos los parámetros de UA se traducen a equivalentes de GA4 y se envían. Los informes de GA4 que requieran algún parámetro de solo GA4 estarán incompletos.	Compatible. Se envía un hit de evento equivalente con ecommerce como event_category, add_to_wishlist como event_action y el parámetro value como event_value. Los informes de UA propagados con datos del evento de GA4 estarán completos o sin cambios. Dado que este evento no se admite generalmente en los informes de comercio electrónico de UA, no tendrá ningún efecto notable.
add_to_cart	add_to_cart	Solo GA4: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatible. Todos los parámetros de UA se traducen a equivalentes de GA4 y se envían. Los informes de GA4 que requieran algún parámetro de solo GA4 estarán incompletos.	Compatible. Los parámetros de GA4 con un parámetro de UA equivalente se traducen y envían.* No se envían los parámetros solo GA4. *No se envía item_list_name, pero este comportamiento es coherente con gtag.js (UA), que no envía list_name. Los informes de UA propagados con datos del evento de GA4 estarán completos o sin cambios.
remove_from_cart	remove_from_cart	Solo GA4: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatible. Todos los parámetros de UA se traducen a equivalentes de GA4 y se envían. Los informes de GA4 que requieran algún parámetro de solo GA4 estarán incompletos.	Compatible. Los parámetros de GA4 con un parámetro de UA equivalente se traducen y envían.* No se envían los parámetros solo GA4. *No se envía item_list_name, pero este comportamiento es coherente con gtag.js (UA), que no envía list_name. Los informes de UA propagados con datos del evento de GA4 estarán completos o sin cambios.
N/A	view_cart	Solo se recomienda el evento para GA4.	No compatible*. *Es poco probable que tu implementación de UA envíe este evento, ya que no es un evento recomendado. Para asegurarte de que los informes de GA4 estén completos, puedes implementar este evento para UA con el formato de GA4. Si implementas el evento de GA4 para UA, aparecerá como un evento sin datos de items, lo que podría no ser muy útil. No afectará a los informes de comercio electrónico de UA.	No compatible. Se envía un hit de evento con general como event_category, view_cart como event_action y el parámetro value como event_value. No se envían los datos de items. Dado que este evento no se admite generalmente en los informes de comercio electrónico de UA, no tendrá ningún efecto notable.
begin_checkout	begin_checkout	Solo GA4: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatible. Todos los parámetros de UA se traducen a equivalentes de GA4 y se envían. Los informes de GA4 que requieran algún parámetro de solo GA4 estarán incompletos.	Compatible. Los parámetros de GA4 con un parámetro de UA equivalente se traducen y envían.* No se envían los parámetros solo GA4. *No se envía item_list_name, pero este comportamiento es coherente con gtag.js (UA), que no envía list_name. begin_checkout es efectivamente equivalente a enviar un evento checkout_progress con checkout_step establecido en 1. Los informes de UA propagados con datos del evento de GA4 estarán completos o sin cambios.
add_payment_info	add_payment_info	Solo GA4: currency value coupon payment_type items UA: N/A: No se admiten los parámetros.	No compatible*. *Dado que UA no admite parámetros para este evento, no se envía ninguno. Funcionará, pero es probable que no sea muy útil. Los informes de GA4 que requieran algún parámetro de evento estarán incompletos.	Compatible. Se envía una visita al evento equivalente con ecommerce como event_category, add_to_wishlist como event_action y el parámetro value (convertido a un número entero) como event_value. Ten en cuenta que la traducción de GA4 a UA incluye event_value, pero normalmente no se establece para hits de UA. Los informes de UA propagados con datos del evento de GA4 estarán completos o sin cambios. Dado que este evento no se admite generalmente en los informes de comercio electrónico de UA, no tendrá ningún efecto notable.
N/A	add_shipping_info	Solo se recomienda el evento para GA4.	No compatible*. *Es poco probable que tu implementación de UA envíe este evento, ya que no es un evento recomendado. Para asegurarte de que los informes de GA4 estén completos, puedes implementar este evento para UA con el formato de GA4. Si implementas el evento de GA4 para UA, aparecerá como un evento sin datos de items, lo que podría no ser muy útil. No afectará a los informes de comercio electrónico de UA.	No compatible*. Se envía una visita al evento con general como event_category, add_shipping_info como event_action y el parámetro value (convertido a un número entero) como event_value. El parámetro currency de GA4 se envía con el hit como moneda. Dado que este evento no se admite generalmente en los informes de comercio electrónico de UA, no tendrá ningún efecto notable.
checkout_progress set_checkout_option	N/A	Los eventos solo se recomiendan para UA.	El evento se tratará como un evento personalizado. Solo se enviarán parámetros a nivel del evento; no se enviarán datos de items. Dado que estos eventos, por lo general, no se admiten en los informes de comercio electrónico de GA4, no tendrán ningún efecto notable.	N/A
view_promotion	view_promotion	Solo GA4: creative_name creative_slot location_id promotion_id promotion_name items Solo para UA: promotions	No compatible. Se envía un evento personalizado view_promotion con promotions como parámetro personalizado. El parámetro personalizado promotions no contiene ningún dato útil.	No compatible. Se envía un hito del evento de UA con engagement como event_category y view_promotion como event_action. No se envían datos de promotions. El evento se marca como evento de no interacción.
purchase	purchase	Solo GA4: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatible. Todos los parámetros de UA se traducen a equivalentes de GA4 y se envían. Se usa currency a nivel del evento, ya que no se admite currency a nivel del artículo. Los informes de GA4 que requieran algún parámetro de solo GA4 estarán incompletos.	Compatible. Los parámetros de GA4 con un parámetro de UA equivalente se traducen y envían.* No se envían los parámetros solo GA4. *No se envía item_list_name, pero este comportamiento es coherente con gtag.js (UA), que no envía list_name. Los informes de UA propagados con datos del evento de GA4 estarán completos o sin cambios.
refund	refund	Solo GA4: affiliation items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatible. Todos los parámetros de UA se traducen a equivalentes de GA4 y se envían. Se usa currency a nivel del evento, ya que no se admite currency a nivel del artículo. Los informes de GA4 que requieran algún parámetro de solo GA4 estarán incompletos.	Compatible. Los parámetros de GA4 con un parámetro de UA equivalente se traducen y envían.* No se envían los parámetros solo GA4. *No se envía item_list_name, pero este comportamiento es coherente con gtag.js (UA), que no envía list_name. Los informes de UA propagados con datos del evento de GA4 estarán completos o sin cambios.