Resumen

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 de comercio electrónico mejorado en la plataforma, puedes usar gtag.js para enviar a Google Analytics datos de impresión, de producto, de promoción y de acción.

Para ver la lista de eventos relacionados con el comercio electrónico, consulta la referencia de eventos de gtag.js.

Acciones y tipos de datos 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 text * Sí

ID de producto o SKU (por ejemplo, P67890).

* Es obligatorio definir id o name.

name text * Sí

Nombre del producto (por ejemplo, Camiseta de Android).

* Es obligatorio definir id o name.

list text No Lista o colección a la que pertenece el producto (por ejemplo, Resultados de búsqueda).
list_name text No Lista o colección a la que pertenece el producto (por ejemplo, Resultados de búsqueda).
brand text No Marca asociada al producto (por ejemplo, Google).
category text 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 text No Variante del producto (por ejemplo, Negro).
position integer No Posición del producto en una lista o colección (por ejemplo, 2).
list_position integer No Posición del producto en una lista o colección (por ejemplo, 2).
price number No Precio de un producto (por ejemplo, 29,20).

Datos de producto

Los datos de producto representan los productos individuales 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 text * Sí

ID de producto o SKU (por ejemplo, P67890).

* Es obligatorio definir el campo id o name.

name text * Sí

Nombre del producto (por ejemplo, Camiseta de Android).

* Es obligatorio definir el campo id o name.

brand text No Marca asociada al producto (por ejemplo, Google).
category text 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 text No Variante del producto (por ejemplo, Negro).
price number No Precio de un producto (por ejemplo, 29,20).
quantity integer No Cantidad de un producto (por ejemplo, 2).
coupon text No Código de cupón asociado a un producto (por ejemplo, COMPRA_VERANO13).
position integer No Posición del producto en una lista o colección (por ejemplo, 2).
list_position integer 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 text * Sí

ID de promoción (por ejemplo, PROMO_1234).

* Es obligatorio definir el campo id o name.

name text * Sí

Nombre de la promoción (por ejemplo, Rebajas de verano).

* Es obligatorio definir el campo id o name.

creative text No Creatividad asociada a la promoción (por ejemplo, banner_verano2).
creative_name text No Nombre de la creatividad (por ejemplo, banner_verano2).
position text No Posición de la creatividad (por ejemplo, banner_espacio_1).
creative_slot text 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 text * Sí

ID de la transacción (por ejemplo, T1234).

* Es obligatorio si el tipo de acción es purchase o refund.

affiliation text No Tienda o afiliación donde se ha originado esta transacción (por ejemplo, Google Store).
revenue number 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 number No Valor (es decir, ingresos) asociado al evento.
tax number No Impuestos totales asociados a la transacción.
shipping number No Gastos de envío asociados a la transacción.
coupon text No Cupón canjeado con la transacción.
list text No Lista a la que pertenecen los productos asociados. Este campo es opcional.
items array No Matriz que contiene los productos asociados.
step integer No Número que representa un paso del proceso de pago. Es opcional en acciones del tipo "checkout".
checkout_step integer No Número que representa un paso del proceso de pago.
option text No Campo adicional para acciones de checkout y checkout_option que pueden describir información sobre opciones de la página de pago de la compra, como el método de pago seleccionado.
checkout_option text No Opción de pago (es decir, método de pago seleccionado).
Clave Tipo de valor Obligatorio Descripción
coupon string 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.
select_content Clic en un producto o enlace de uno o varios productos.
view_item Visualización de los detalles de un producto.
add_to_cart Acción de añadir uno o varios productos al carrito de la compra
remove_from_cart Acción de quitar uno o varios productos de un carrito de la compra.
begin_checkout Inicio del proceso de pago de uno o varios productos.
set_checkout_option Envío del valor de la opción de un paso de pago determinado.
refund Venta de uno o varios productos.
view_refund Devolución de uno o varios productos.
view_promotion Clic en una promoción interna.

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 por las que se añaden o se quitan productos del carrito de la compra

Para medir las acciones por 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 por 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:

  1. Añade código de medición para medir cada paso del proceso de pago.
  2. 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'
    }
  ]
});