Comercio electrónico mejorado

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

name text *Sí

Es el nombre del producto (p.ej., Camiseta de Android).

* Se debe establecer id o name.

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.

name text *Sí

Es el nombre del producto (p.ej., Camiseta de Android).

* Se debe establecer uno de ID o name.

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

name text *Sí

Es el nombre de la promoción (p.ej., Oferta de verano).

* Se debe establecer id o name.

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

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:

  1. Agrega un código de medición para medir cada paso del proceso de confirmación de la compra.
  2. 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'
    }
  ]
});