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
Etiqueta del evento de GA4
- Usar gtag es la forma recomendada de enviar eventos de comercio electrónico de GA4. Sin embargo, la etiqueta del evento de GA4 puede leer datos de comercio electrónico enviados a la capa de datos.
- Los parámetros de evento de GA4 que se configuran directamente en una etiqueta del evento de GA4 tendrán prioridad sobre cualquier dato proporcionado por la variable personalizada, la capa de datos o gtag.
- La etiqueta del evento de GA4 es retrocompatible con los datos de eventos de comercio electrónico que se usan
para Universal Analytics. El comportamiento de prioridad es el siguiente:
- Utiliza eventos de comercio electrónico de GA4.
- Si no se encuentran eventos de comercio electrónico de GA4, busca y utiliza los eventos de comercio electrónico de UA.
- Si un evento de comercio electrónico de UA se utiliza con una etiqueta del evento de GA4, el evento se traducirá primero al evento de comercio electrónico de GA4 equivalente antes de enviarse a la propiedad GA4. Esto se aplica si usas gtag, de una capa de datos o de un objeto personalizado.
Etiqueta de Universal Analytics
- La etiqueta de Universal Analytics admite la lectura de eventos de comercio electrónico de GA4 (incluidos los datos que se envían mediante gtag).
- Si la lectura de eventos de comercio electrónico de GA4 está habilitada en la etiqueta, el comportamiento de prioridad es el siguiente:
- Utiliza eventos de comercio electrónico de GA4.
- Si no se encuentran eventos de comercio electrónico de GA4, busca y utiliza los eventos de comercio electrónico de UA.
- Si un evento de comercio electrónico de GA4 se utiliza con una etiqueta de Universal Analytics, el evento se traducirá primero al evento de comercio electrónico de UA equivalente antes de enviarlo a la propiedad UA. Esto se aplica si usas gtag, de la capa de datos o de un objeto personalizado.
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.
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) |
---|---|---|---|---|
Impresiones del
producto (impressions )
|
|
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.
|
Clics en el
producto (click )
|
|
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 .
|
Clics en promociones (promoClick )
|
|
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 .
|
Vistas de detalles del producto (detail )
|
|
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.
|
|
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.
|
Agrega un producto a un carrito de compras (add )
|
|
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.
|
Cómo quitar un producto de un carrito de compras (remove )
|
|
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 |
|
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.
|
Pasos de confirmación de la compra (checkout , checkout_option )
|
|
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
|
|
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 |
|
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.
|
Pasos de confirmación de la compra (checkout , 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 |
Impresiones de promociones (promoView )
|
|
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.
|
Measurement
Purchases (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.
|
Medición de reembolsos (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.
|