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`	Sí*	ID o SKU únicos del artículo
`name`	`string`	Sí*	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`	`number`	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`	Sí*	ID o SKU únicos del artículo
`name`	`string`	Sí*	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`	`number`	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`	Sí*	ID de la promoción
`name`	`string`	Sí*	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`	Sí*	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`	`number`	No	Importe de los impuestos
`shipping`	`number`	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

Medir las impresiones de producto

Para medir 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_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 de producto

Para medir los clics de producto, envía el evento select_content, especifica product en 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
    }
  ]
});

Medir las vistas de 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 medir estas consultas, envía el 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 los productos que se añaden y se retiran en el carrito de la compra

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

Medir las impresiones de promoción

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

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

Medir los clics de promoción

Para medir los clics de promoción, envía el evento select_content y proporciona la promoción:

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

Medir las tramitaciones de compras

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

Añade código de medición para medir cada paso del proceso de tramitación de compra.
Si corresponde, añade código de medición para registrar las opciones de pago.

1. Medir los pasos de tramitación de compra

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

Medir las compras

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

Medir los reembolsos

Para medir 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 medir los reembolsos parciales, envía el 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'
    }
  ]
});