En esta página se explica cómo recoger datos de Comercio electrónico mejorado con gtag.js. Si has configurado Google Analytics en gtag.js y tienes habilitado el método Comercio electrónico mejorado, puedes usar gtag.js para enviar a Google Analytics datos de impresión, de producto, de promoción y de acción.
Tipos de datos y acciones de Comercio electrónico mejorado
Puedes enviar varios tipos de datos de comercio electrónico:
Datos de impresión
Representan la información sobre el producto que se ha visto. Se hace referencia a estos datos mediante impressionFieldObject
y contienen los siguientes valores:
Clave | Tipo de valor | Obligatorio | Descripción |
---|---|---|---|
id |
texto | * Sí |
ID de producto o SKU (por ejemplo, P67890).
* Es obligatorio dar un valor a |
name |
texto | * Sí |
Nombre del producto (por ejemplo, Camiseta de Android).
* Es obligatorio dar un valor a |
list |
texto | No | Lista o colección a la que pertenece el producto (por ejemplo, Resultados de búsqueda). |
list_name |
texto | No | Lista o colección a la que pertenece el producto (por ejemplo, Resultados de búsqueda). |
brand |
texto | No | Marca asociada al producto (por ejemplo, Google). |
category |
texto | No |
Categoría a la que pertenece el producto (por ejemplo, Ropa). Usa / como delimitador para especificar hasta cinco niveles de jerarquía (por ejemplo, Ropa/Hombres/Camisetas).
|
variant |
texto | No | Variante del producto (por ejemplo, Negro). |
position |
entero | No | Posición del producto en una lista o colección (por ejemplo, 2). |
list_position |
entero | No | Posición del producto en una lista o colección (por ejemplo, 2). |
price |
número | No | Precio de un producto (por ejemplo, 29,20). |
Datos de producto
Los datos de producto representan los productos específicos que se han visto, que se han añadido al carrito, etc. Se hace referencia a estos datos mediante productFieldObject
y contienen los siguientes valores:
Clave | Tipo de valor | Obligatorio | Descripción |
---|---|---|---|
id |
texto | * Sí |
ID de producto o SKU (por ejemplo, P67890).
* Es obligatorio dar un valor al campo id o |
name |
texto | * Sí |
Nombre del producto (por ejemplo, Camiseta de Android).
* Es obligatorio dar un valor al campo id o |
brand |
texto | No | Marca asociada al producto (por ejemplo, Google). |
category |
texto | No | Categoría a la que pertenece el producto (por ejemplo, Ropa). Usa / como delimitador para especificar hasta cinco niveles de jerarquía (por ejemplo, Ropa/Hombre/Camisetas). |
variant |
texto | No | Variante del producto (por ejemplo, Negro). |
price |
número | No | Precio de un producto (por ejemplo, 29,20). |
quantity |
entero | No | Cantidad de un producto (por ejemplo, 2). |
coupon |
texto | No | Código de cupón asociado a un producto (por ejemplo, COMPRA_VERANO13). |
position |
entero | No | Posición del producto en una lista o colección (por ejemplo, 2). |
list_position |
entero | No | Posición del producto en una lista o colección (por ejemplo, 2). |
Datos de promoción
Representan la información sobre una promoción que se ha visto. Se hace referencia a estos datos mediante el objeto promoFieldObject
y contienen los siguientes valores:
Clave | Tipo de valor | Obligatorio | Descripción |
---|---|---|---|
id |
texto | * Sí |
ID de promoción (por ejemplo, PROMO_1234).
* Es obligatorio dar un valor a |
name |
texto | * Sí |
Nombre de la promoción (por ejemplo, Rebajas de verano).
* Es obligatorio dar un valor a |
creative |
texto | No | Creatividad asociada a la promoción (por ejemplo, banner_verano2). |
creative_name |
texto | No | Nombre de la creatividad (por ejemplo, banner_verano2). |
position |
texto | No | Posición de la creatividad (por ejemplo, banner_espacio_1). |
creative_slot |
texto | No | Nombre del espacio de la creatividad (por ejemplo, banner_espacio_1). |
Datos de acción
Representan la información sobre una acción que se lleva a cabo relacionada con el comercio electrónico.
Se hace referencia a estos datos mediante actionFieldObject
y contienen los siguientes valores:
Clave | Tipo de valor | Obligatorio | Descripción |
---|---|---|---|
id |
texto | * Sí |
ID de la transacción (por ejemplo, T1234).
* Es obligatorio si el tipo de acción es |
affiliation |
texto | No | Tienda o afiliación donde se ha originado esta transacción (por ejemplo, Google Store). |
revenue |
número | No |
Especifica la suma total o los ingresos totales asociados a la transacción (por ejemplo, 11,99). Este valor puede incluir los gastos de envío, los impuestos u otros ajustes de los ingresos totales que quieras incluir para calcular tus ingresos. |
value | número | No | Valor (es decir, ingresos) asociado al evento. |
tax |
número | No | Impuestos totales asociados a la transacción. |
shipping |
número | No | Gastos de envío asociados a la transacción. |
coupon |
texto | No | Cupón canjeado con la transacción. |
list |
texto | No | Lista a la que pertenecen los productos asociados. Este campo es opcional. |
items |
array | No | Matriz que contiene los productos asociados. |
step |
entero | No | Número que representa un paso del proceso de pago. Es opcional en acciones del tipo "checkout". |
checkout_step |
entero | No | Número que representa un paso del proceso de pago. |
option |
texto | No |
Campo adicional para acciones de checkout y checkout_option que pueden describir la información de opción en la página de tramitación de la compra, como el método de pago seleccionado.
|
checkout_option |
texto | No | Opción de pago (es decir, método de pago seleccionado). |
Clave | Tipo de valor | Obligatorio | Descripción |
---|---|---|---|
coupon |
cadena | No | Código de cupón de un artículo que está a la venta. |
Acciones de producto y de promoción
Las acciones especifican cómo interpretar los datos de producto y de promoción que envías a Google Analytics.
Acción | Evento | Descripción |
---|---|---|
click |
Clic en un producto o enlace de uno o varios productos. | |
detail |
Visualización de los detalles de un producto. | |
add |
Acción de añadir uno o varios productos al carrito de la compra | |
remove |
Acción de quitar uno o varios productos de un carrito de la compra. | |
checkout |
Inicio del proceso de pago de uno o varios productos. | |
checkout_option |
Envío del valor de la opción de un paso de pago determinado. | |
purchase |
Venta de uno o varios productos. | |
refund |
Devolución de uno o varios productos. | |
promo_click |
Clic en una promoción interna. | |
add_to_cart |
Un usuario añade uno o varios productos al carrito de la compra. | |
begin_checkout |
Un usuario inicia el proceso de pago de uno o varios productos. | |
checkout_progress |
Un usuario completa los pasos de tramitación de la compra después del primer paso de tramitación de la compra. | |
purchase |
Un usuario completa una compra. | |
refund |
Un usuario recibe el reembolso de uno o varios productos. | |
remove_from_cart |
Un usuario quita uno o varios productos del carrito de la compra. | |
select_content |
Un usuario hace clic en un producto o en un enlace de producto. | |
set_checkout_option |
El paso de tramitación de la compra que está completando un usuario. | |
view_item |
Un usuario ve los detalles de un producto. | |
view_item_list |
Un usuario ve una lista con uno o varios productos. | |
view_promotion |
Un usuario hace clic en una promoción interna. | |
view_refund |
Un usuario ve el reembolso de uno o varios productos. |
Ejemplos
Medir las impresiones de producto
Para medir las impresiones de un producto determinado, envía un evento view_item_list
con la información de ese 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
}
]
});
Medir los clics en productos
Para medir un clic en un producto determinado, envía el evento select_content
, especifica product
en content_type
y proporciona la información de ese 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
}
]
});
Medir las visualizaciones de detalles de productos
Después de que el usuario haga clic en una ficha de producto, es posible que consulte la página de detalles. Para medir esa consulta, 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'
}
]
});
Medir las acciones en las que se añaden o quitan productos del carrito de la compra
Para medir las acciones en las que se añaden productos al carrito de la compra, envía un evento add_to_cart
con la información del producto correspondiente:
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 las acciones en las que se quitan productos del carrito de la compra, envía un evento remove_from_cart
con la información de producto correspondiente:
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'
}
]
});
Medir los procesos de pago
Para medir cada paso de un proceso de pago, haz lo siguiente:
- Añade código de medición para medir cada paso del proceso de pago.
- Si corresponde, añade código de medición para registrar las opciones de pago.
1. Medir los pasos del proceso de pago
Para medir el primer paso de un proceso de pago, envía el evento begin_checkout
con los artículos que se van a comprar:
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 los pasos posteriores del proceso de pago, envía el evento checkout_progress
con los artículos que se van a comprar:
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. Medir las opciones de pago
Para medir las opciones de pago, envía el evento set_checkout_option
con las opciones de pago:
gtag('event', 'set_checkout_option', {
"checkout_step": 1,
"checkout_option": "shipping method",
"value": 3
});
Medir las impresiones de promoción
Para medir las impresiones de una promoción determinada, envía un evento view_promotion
con la información de esa promoción:
gtag('event', 'view_promotion', {
"promotions": [
{
"id": "abc123",
"name": "summer_promo"
},
{
"id": "xyz987",
"name": "spring savings"
}
]
});
Medir los clics en promociones
Para medir los clics en una promoción determinada, envía un evento select_content
y proporciona esa promoción:
gtag('event', 'select_content', {
"promotions": [
{
"id": "abc123",
"name": "summer_promo"
}
]
});
Medir las compras
Para medir una transacción determinada, envía un evento purchase
con los artículos de esa 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'
}
]
});
Medir los reembolsos
Para medir un reembolso completo de una transacción, envía un evento refund
con el ID de esa 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 deben reembolsar:
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'
}
]
});