Comercio electrónico mejorado con gtag.js

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

Para obtener una lista de eventos relacionados con el comercio electrónico, consulta la página de referencia sobre los eventos de gtag.js.

Datos de impresión

Los siguientes parámetros de artículo reflejan la información sobre un producto que se ha consultado:

Parámetro de artículo Tipo de datos Obligatorio Descripción
id string ID o SKU únicos del artículo
name string Nombre del artículo
list_name string No Lista en la que se ha mostrado el artículo al usuario
brand string No Marca del artículo
category string No Categoría del artículo
variant string No Variante del artículo
list_position integer No Posición del artículo en la lista
price currency No Precio de compra del artículo

* Se debe definir con un valor id o name.

Datos de producto

Los siguientes parámetros de artículo reflejan la información sobre un producto que se ha consultado, se ha añadido al carrito de la compra, etc.:

Parámetro de artículo Tipo de datos Obligatorio Descripción
id string ID o SKU únicos del artículo
name string Nombre del artículo
brand string No Marca del artículo
category string No Categoría del artículo
variant string No Variante del artículo
price currency No Precio de compra del artículo
quantity integer No Cantidad de artículos
coupon string No Código de cupón del artículo que está a la venta
list_position integer No Posición del artículo en la lista

* Se debe definir con un valor id o name.

Datos de promoción

Los siguientes parámetros de promoción reflejan la información sobre una promoción que se ha consultado:

Parámetro de promoción Tipo de datos Obligatorio Descripción
id string ID de la promoción
name string Nombre de la promoción
creative_name string No Nombre de la creatividad utilizada
creative_slot string No Nombre del espacio de la creatividad

* Se debe definir con un valor id o name.

Datos de acción

Los siguientes parámetros de evento y parámetro de artículo reflejan la información sobre una acción que se ha producido relacionada con el comercio electrónico:

Parámetro de evento Tipo de datos Obligatorio Descripción
transaction_id string ID único de la transacción
affiliation string No Tienda o afiliación en la que se ha producido la transacción
value number No Valor (es decir, ingresos) asociado al evento
tax currency No Importe de los impuestos
shipping currency No Coste del envío
items array No Matriz que contiene los productos asociados
checkout_step number No Paso (representado por un número) del proceso de tramitación de compra
checkout_option string No Opción de pago (es decir, método de pago seleccionado)

* Obligatorio en el caso de purchase o refund.

Parámetro de artículo Tipo de datos Obligatorio Descripción
coupon string No Código de cupón del artículo que está a la venta

Acciones de producto y promoción

Las siguientes acciones (eventos) especifican cómo interpretar los datos de producto y promoción que envías a Google Analytics:

Evento Descripción
select_content Clic en un producto o en un enlace de producto de uno o varios productos
view_item Visualización de los detalles de un producto
add_to_cart Agregar uno o varios productos al carrito de la compra
remove_from_cart Retirar uno o más productos del carrito de la compra
begin_checkout Iniciar el proceso de compra de uno o varios productos
set_checkout_option Envío del valor de opción de un paso de compra determinado
purchase Venta de uno o varios productos
refund Devolución de uno o varios productos
view_promotion Clic en una promoción interna

Hacer el seguimiento de impresiones de productos

Para supervisar las impresiones de producto, envía el evento view_item_list con la información de producto:

gtag('event', 'view_item_list', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": 3
    }
  ]
});

Hacer el seguimiento de clics de producto

Para supervisar los clics de producto, envía el evento select_content, especifica product en content_type y proporciona la información de producto:

gtag('event', 'select_content', {
  "content_type": "product",
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    }
  ]
});

Hacer el seguimiento de las consultas de los detalles de producto

Después de que los usuarios hagan clic en una ficha de producto, es posible que consulten la página de detalles. Para supervisar estas consultas, envía el evento view_item con los detalles de 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'
    }
  ]
});

Hacer un seguimiento de los productos que se añaden y se retiran en el carrito de la compra

Para supervisar los productos que se añaden al carrito de la compra, envía el evento add_to_cart con la información de 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 supervisar los productos que se retiran del carrito de la compra, envía el evento remove_from_cart con la información de 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'
    }
  ]
});

Hacer el seguimiento de las impresiones de promoción

Para supervisar las impresiones de promoción, envía un evento view_promotion con la información de producto:

gtag('event', 'view_promotion', {
  "promotions": [
    {
      "id": "abc123",
      "name": "summer_promo"
    },
    {
      "id": "xyz987",
      "name": "spring savings"
    }
  ]
});

Hacer el seguimiento de los clics de promoción

Para supervisar los clics de promoción, envía el evento select_content con la promoción:

gtag('event', 'select_content', {
  "promotions": [
    {
      "id": "abc123",
      "name": "summer_promo"
    }
  ]
});

Hacer el seguimiento de las tramitaciones de compra

Para supervisar cada paso del proceso de tramitación de compra:

  1. Añade código de seguimiento para medir cada paso del proceso de compra.
  2. Si es posible, agrega código de seguimiento para medir las opciones de pago.

1. Hacer el seguimiento de los pasos de tramitación de compra

Para supervisar el primer paso de las tramitaciones de compra, 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 hacer el seguimiento de los pasos subsiguientes en las tramitaciones de compra, 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. Hacer el seguimiento de las opciones de pago

Para supervisar 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": "USPS"
});

Hacer el seguimiento de las compras

Para supervisar las transacciones, envía un evento purchase con los artículos de la compra:

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

Hacer el seguimiento de los reembolsos

Para supervisar los reembolsos completos de las transacciones, envía el evento refund con el ID de la transacción:

gtag('event', 'refund', { "transaction_id": "T12345" })

Para hacer el seguimiento de los reembolsos parciales, envía el evento refund con el ID de la 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'
    }
  ]
});