En esta página, se describe cómo usar gtag.js para recopilar datos de comercio electrónico mejorado. Si configuraste Google Analytics en gtag.js y habilitaste el comercio electrónico mejorado en Google Analytics, puedes usar gtag.js para enviar datos de impresiones, datos de productos, datos de promociones y datos de acciones a Google Analytics.
Acciones y tipos de datos de comercio electrónico mejorado
Existen varios tipos de datos de comercio electrónico que puedes enviar:
Datos de impresiones
Representa información sobre un producto que se vio. Se denomina impressionFieldObject
y contiene los siguientes valores:
Clave | Value Type | Obligatorio | Descripción |
---|---|---|---|
id |
text | *Sí |
Es el ID o SKU del producto (p.ej., P67890).
* Se debe establecer |
name |
text | *Sí |
Es el nombre del producto (p.ej., Camiseta de Android).
* Se debe establecer |
list |
text | No | Es la lista o colección a la que pertenece el producto (p. ej., resultados de la búsqueda). |
list_name |
text | No | Es la lista o colección a la que pertenece el producto (p. ej., resultados de la búsqueda). |
brand |
text | No | Es la marca asociada con el producto (p.ej., Google). |
category |
text | No |
Es la categoría a la que pertenece el producto (p.ej., indumentaria). Usa / como delimitador para especificar hasta 5 niveles de jerarquía (p.ej., Indumentaria/Hombres/Camisetas).
|
variant |
text | No | Es la variante del producto (p.ej., negro). |
position |
integer | No | Es la posición del producto en una lista o colección (p.ej., 2). |
list_position |
integer | No | Es la posición del producto en una lista o colección (p.ej., 2). |
price |
número | No | Es el precio de un producto (p.ej., 29.20). |
Datos del producto
Los datos de productos representan productos individuales que se vieron, que se agregaron al carrito de compras, etc. Se los conoce como productFieldObject
y contienen los siguientes valores:
Clave | Value Type | Obligatorio | Descripción |
---|---|---|---|
id |
text | *Sí |
Es el ID o SKU del producto (p.ej., P67890).
* Se debe establecer uno de ID o |
name |
text | *Sí |
Es el nombre del producto (p.ej., Camiseta de Android).
* Se debe establecer uno de ID o |
brand |
text | No | Es la marca asociada con el producto (p.ej., Google). |
category |
text | No | Es la categoría a la que pertenece el producto (p.ej., indumentaria). Usa / como delimitador para especificar hasta 5 niveles de jerarquía (p.ej., Indumentaria/Hombres/Camisetas). |
variant |
text | No | Es la variante del producto (p.ej., negro). |
price |
número | No | Es el precio de un producto (p.ej., 29.20). |
quantity |
integer | No | Es la cantidad de un producto (p.ej., 2). |
coupon |
text | No | Es el código de cupón asociado a un producto (p.ej., OFERTA_DE_VERANO13). |
position |
integer | No | Es la posición del producto en una lista o colección (p.ej., 2). |
list_position |
integer | No | Es la posición del producto en una lista o colección (p.ej., 2). |
Datos de promoción
Representa información sobre una promoción que se vio. Se denomina promoFieldObject
y contiene los siguientes valores:
Clave | Value Type | Obligatorio | Descripción |
---|---|---|---|
id |
text | *Sí |
Es el ID de la promoción (p.ej., PROMO_1234).
* Se debe establecer |
name |
text | *Sí |
Es el nombre de la promoción (p.ej., Oferta de verano).
* Se debe establecer |
creative |
text | No | Es la creatividad asociada con la promoción (p.ej., banner_verano2). |
creative_name |
text | No | Es el nombre de la creatividad (p.ej., banner_verano2). |
position |
text | No | Es la posición de la creatividad (p.ej., banner_slot_1). |
creative_slot |
text | No | El nombre del espacio para creatividades (p.ej., banner_slot_1). |
Datos de acción
Representa información sobre una acción relacionada con el comercio electrónico que se llevó a cabo.
Se denomina actionFieldObject
y contiene los siguientes valores:
Clave | Value Type | Obligatorio | Descripción |
---|---|---|---|
id |
text | *Sí |
Es el ID de transacción (p.ej., T1234).
* Obligatorio si el tipo de acción es |
affiliation |
text | No | Es la tienda o afiliación en la que se realizó la transacción (p.ej., Google Store). |
revenue |
número | No |
Especifica los ingresos totales o el total general asociados con la transacción (p.ej., 11.99). Este valor puede incluir los costos de envío, los costos impositivos y otros ajustes a los ingresos totales que quieras incluir en tus cálculos de ingresos. |
value | número | No | Es el valor (es decir, los ingresos) asociado con el evento. |
tax |
número | No | Indica el impuesto total asociado con la transacción. |
shipping |
número | No | Indica el costo de envío asociado a la transacción. |
coupon |
text | No | Es el cupón de la transacción que se canjeó con la transacción. |
list |
text | No | Es la lista a la que pertenecen los productos asociados. Opcional. |
items |
arreglo | No | El array que contiene los productos asociados. |
step |
integer | No | Es un número que representa un paso en el proceso de confirmación de la compra. Opcional durante las acciones de “confirmación de la compra”. |
checkout_step |
integer | No | Es un número que representa un paso en el proceso de confirmación de la compra. |
option |
text | No |
Campo adicional para las acciones checkout y checkout_option que puede describir la información de las opciones en la página de confirmación de compras, como la forma de pago seleccionada.
|
checkout_option |
text | No | Opción de confirmación de la compra (es decir, forma de pago seleccionada). |
Clave | Value Type | Obligatorio | Descripción |
---|---|---|---|
coupon |
cadena | No | Es el código de cupón para un artículo que se puede comprar. |
Acciones de productos y promociones
Las acciones especifican cómo interpretar los datos de productos y promociones que envías a Google Analytics.
Acción | Evento | Descripción |
---|---|---|
click |
Un clic en un producto o vínculo de uno o más productos. | |
detail |
Una vista de los detalles del producto. | |
add |
Agregar uno o más productos a un carrito de compras | |
remove |
Quitar uno o más productos del carrito de compras | |
checkout |
Inicio del proceso de confirmación de la compra de uno o más productos. | |
checkout_option |
Envío del valor de la opción para un paso de confirmación de la compra determinado. | |
purchase |
Es la venta de uno o más productos. | |
refund |
Es el reembolso de uno o más productos. | |
promo_click |
Un clic en una promoción interna. | |
add_to_cart |
Un usuario agrega uno o más productos a un carrito de compras. | |
begin_checkout |
Un usuario inicia el proceso de confirmación de la compra de uno o más productos. | |
checkout_progress |
Un usuario completa los pasos de confirmación de la compra después del primer paso. | |
purchase |
Un usuario completa una compra. | |
refund |
Se emite un reembolso por uno o más productos a un usuario. | |
remove_from_cart |
Un usuario quita uno o más productos de un carrito de compras. | |
select_content |
Un usuario hace clic en un producto o vínculo de producto. | |
set_checkout_option |
El paso de confirmación de la compra que completa un usuario. | |
view_item |
Un usuario ve los detalles de un producto. | |
view_item_list |
Un usuario ve una lista de uno o más productos. | |
view_promotion |
Un usuario hace clic en una promoción interna. | |
view_refund |
Un usuario ve un reembolso por uno o más productos. |
Ejemplos
Cómo medir las impresiones de productos
Para medir las impresiones del producto, envía un view_item_list
con la información del producto:
gtag('event', 'view_item_list', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": 2
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": 3
}
]
});
Mida los clics en los productos
Para medir un clic en el producto, envía un evento select_content
, especifica product
como el content_type
y proporciona la información del producto:
gtag('event', 'select_content', {
"content_type": "product",
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": 2
}
]
});
Mide las vistas de detalles de productos
Después de hacer clic en una ficha de producto, el usuario podría ver la página de detalles del producto. Para
medir las vistas de detalles del producto, envía un evento view_item
con los detalles del producto:
gtag('event', 'view_item', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
Mide las incorporaciones y eliminaciones de los carritos de compras
Para medir la adición de un producto a un carrito de compras, envía un evento add_to_cart
con la información del producto:
gtag('event', 'add_to_cart', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
Para medir la eliminación de un producto de un carrito de compras, envía un evento remove_from_cart
con la información del producto:
gtag('event', 'remove_from_cart', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
Mide las confirmaciones de las compras
Para medir cada paso en un proceso de confirmación de la compra:
- Agrega un código de medición para medir cada paso del proceso de confirmación de la compra.
- Si corresponde, agrega un código de medición para registrar las opciones de confirmación de la compra.
1. Mide los pasos de confirmación de la compra
Para medir el primer paso de la confirmación de la compra, envía un evento begin_checkout
con los
elementos de confirmación de la compra:
gtag('event', 'begin_checkout', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
],
"coupon": ""
});
Para medir cada paso posterior de la confirmación de la compra, envía un evento checkout_progress
con los artículos de confirmación de la compra:
gtag('event', 'checkout_progress', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
],
"coupon": "SUMMER_DISCOUNT"
});
2. Mide las opciones de confirmación de la compra
Para medir una opción de confirmación de la compra, envía un evento set_checkout_option
con la
opción de confirmación de la compra:
gtag('event', 'set_checkout_option', {
"checkout_step": 1,
"checkout_option": "shipping method",
"value": 3
});
Mide las impresiones de la promoción
Para medir las impresiones de la promoción, envía un evento view_promotion
con información de la promoción:
gtag('event', 'view_promotion', {
"promotions": [
{
"id": "abc123",
"name": "summer_promo"
},
{
"id": "xyz987",
"name": "spring savings"
}
]
});
Mide los clics en promociones
Para medir un clic en una promoción, envía un evento select_content
y proporciona la
promoción:
gtag('event', 'select_content', {
"promotions": [
{
"id": "abc123",
"name": "summer_promo"
}
]
});
Mide las compras
Para medir una transacción, envía un evento purchase
con los elementos en la transacción:
gtag('event', 'purchase', {
"transaction_id": "24.031608523954162",
"affiliation": "Google online store",
"value": 23.07,
"currency": "USD",
"tax": 1.24,
"shipping": 0,
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": '3.0'
}
]
});
Mide los reembolsos
Para medir un reembolso total de una transacción, envía un evento refund
con el
ID de transacción:
gtag('event', 'refund', { "transaction_id": "T12345" })
Para medir un reembolso parcial, envía un evento refund
con el ID de transacción y los artículos que se reembolsarán:
gtag('event', 'refund', {
"transaction_id": "79.18502354114992",
"affiliation": "Google online store",
"value": 23.07,
"currency": "USD",
"tax": 1.24,
"shipping": 0,
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": '3.0'
}
]
});