Comercio electrónico mejorado

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 id o name.

name texto * Sí

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

* Es obligatorio dar un valor a id o name.

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.

name texto * Sí

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

* Es obligatorio dar un valor al campo id o name.

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 id o name.

name texto * Sí

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

* Es obligatorio dar un valor a id o name.

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 purchase o refund.

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:

  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'
    }
  ]
});