Comercio electrónico mejorado con gtag.js | Analytics para sitios web (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`	`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`	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`	`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`	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`	`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_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
    }
  ]
});

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_name": "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:

Añade código de seguimiento para medir cada paso del proceso de compra.
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 un 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'
    }
  ]
});