Eventos recomendados

Google Analytics envía algunos tipos de eventos automáticamente. En esta página, se describen los eventos adicionales y opcionales que puedes configurar para medir más comportamientos y generar informes más útiles para tu empresa. Estos eventos adicionales requieren más esfuerzo de configuración antes de que puedas usarlos, por lo que Google Analytics 4 no puede enviarlos automáticamente. Para obtener instrucciones paso a paso sobre cómo configurar eventos recomendados y personalizados para tu sitio web o aplicación, consulta Cómo configurar eventos.

Para ver los detalles de cada evento que puedes usar, selecciona tu plataforma de administración de etiquetas:

add_payment_info

Este evento indica que un usuario envió su información de pago en un proceso de confirmación de compra de comercio electrónico.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras.

Las métricas de valor en el evento view_item no contribuyen a los ingresos

* Si estableces value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30.03 Es el valor monetario del evento.

* Establece value en la suma de (price * quantity) para todos los elementos de items. No incluyas shipping ni tax.
* Por lo general, se requiere value para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas value.
* currency es obligatorio si configuras value.
coupon string No SUMMER_FUN Indica el nombre o código del cupón asociado con el evento.

Los parámetros coupon a nivel del evento y del artículo son independientes.
payment_type string No Credit Card Es la forma de pago elegida.
items Array<Item> Sí Son los elementos del evento.

Parámetros de elementos

Nombre Tipo Obligatorio Valor de ejemplo Descripción
item_id string Sí* SKU_12345

Se trata del ID del artículo.

*Se requiere item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere item_id o item_name.

affiliation string No Google Store Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física.
Nota: `affiliation` solo está disponible a nivel del elemento.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Es el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Índice o posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o la taxonomía adicional del artículo.
item_category3 string No Camisas Es la tercera jerarquía de categorías o taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
item_category5 string No Manga corta Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
item_list_id string No related_products El ID de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_id a nivel del evento.
Si no se establece, se usa el item_list_id a nivel del evento, si está presente.
item_list_name string No Productos relacionados El nombre de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_name a nivel del evento.
Si no se establece, se usa el item_list_name a nivel del evento, si está presente.
item_variant string No verde Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place de San Francisco) Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: `location id` solo está disponible a nivel del elemento.
price number No 10.01 Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado.
Si se aplica un descuento al artículo, establece price en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro discount.
quantity number No 3

Cantidad de artículos.

Si no se establece, quantity se establece en 1.
Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: add_payment_info
  • Variables de capa de datos (nombre - nombre de la variable de capa de datos):
    • Artículos de comercio electrónico: ecommerce.items
    • Valor del comercio electrónico: ecommerce.value
    • Moneda de comercio electrónico: ecommerce.currency
    • Cupón de comercio electrónico: ecommerce.coupon
    • Tipo de pago de comercio electrónico: ecommerce.payment_type
  • Parámetros del evento (nombre del parámetro y valor):
    • items: &lbrace;&lbrace;Artículos de comercio electrónico&rbrace;&rbrace;
    • value: &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency: &lbrace;&lbrace;Moneda del comercio electrónico&rbrace;&rbrace;
    • coupon: &lbrace;&lbrace;Ecommerce Coupon&rbrace;&rbrace;
    • payment_type: &lbrace;&lbrace;Ecommerce Payment Type&rbrace;&rbrace;
  • Activador: El evento es igual a add_payment_info

Configuración del activador:

  • Tipo de activador: Evento personalizado
  • Nombre del evento: add_payment_info
  • Este activador se activa en todos los eventos personalizados.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_payment_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    payment_type: "Credit Card",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

Si necesitas configurar el array de elementos fuera del array de comercio electrónico, establece el parámetro currency a nivel del evento cuando envíes datos de value (ingresos).

add_shipping_info

Este evento indica que un usuario envió su información de envío en un proceso de confirmación de compra de comercio electrónico.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras.

Las métricas de valor en el evento view_item no contribuyen a los ingresos

* Si estableces value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30.03 Es el valor monetario del evento.

* Establece value en la suma de (price * quantity) para todos los elementos de items. No incluyas shipping ni tax.
* Por lo general, se requiere value para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas value.
* currency es obligatorio si configuras value.
coupon string No SUMMER_FUN Indica el nombre o código del cupón asociado con el evento.

Los parámetros coupon a nivel del evento y del artículo son independientes.
shipping_tier string No Suelo Indica el nivel de envío (p.ej., Ground, Air, Next-day) seleccionado para la entrega del artículo comprado.
items Array<Item> Sí Son los elementos del evento.

Parámetros de elementos

Nombre Tipo Obligatorio Valor de ejemplo Descripción
item_id string Sí* SKU_12345

Se trata del ID del artículo.

*Se requiere item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere item_id o item_name.

affiliation string No Google Store Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física.
Nota: `affiliation` solo está disponible a nivel del elemento.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Es el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Índice o posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o la taxonomía adicional del artículo.
item_category3 string No Camisas Es la tercera jerarquía de categorías o taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
item_category5 string No Manga corta Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
item_list_id string No related_products El ID de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_id a nivel del evento.
Si no se establece, se usa el item_list_id a nivel del evento, si está presente.
item_list_name string No Productos relacionados El nombre de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_name a nivel del evento.
Si no se establece, se usa el item_list_name a nivel del evento, si está presente.
item_variant string No verde Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place de San Francisco) Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: `location id` solo está disponible a nivel del elemento.
price number No 10.01 Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado.
Si se aplica un descuento al artículo, establece price en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro discount.
quantity number No 3

Cantidad de artículos.

Si no se establece, quantity se establece en 1.
Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: add_shipping_info
  • Variables de capa de datos (nombre - nombre de la variable de capa de datos):
    • Artículos de comercio electrónico: ecommerce.items
    • Valor del comercio electrónico: ecommerce.value
    • Moneda de comercio electrónico: ecommerce.currency
    • Cupón de comercio electrónico: ecommerce.coupon
    • Nivel de envío de comercio electrónico: ecommerce.shipping_tier
  • Parámetros del evento (nombre del parámetro y valor):
    • items: &lbrace;&lbrace;Artículos de comercio electrónico&rbrace;&rbrace;
    • value: &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency: &lbrace;&lbrace;Moneda del comercio electrónico&rbrace;&rbrace;
    • coupon: &lbrace;&lbrace;Ecommerce Coupon&rbrace;&rbrace;
    • shipping_tier: &lbrace;&lbrace;Ecommerce Shipping Tier&rbrace;&rbrace;
  • Activador: El evento es igual a add_shipping_info

Configuración del activador:

  • Tipo de activador: Evento personalizado
  • Nombre del evento: add_shipping_info
  • Este activador se activa en todos los eventos personalizados.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_shipping_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    shipping_tier: "Ground",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

add_to_cart

Este evento indica que se agregó un artículo al carrito para comprarlo.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras.

Las métricas de valor en el evento view_item no contribuyen a los ingresos

* Si estableces value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30.03 Es el valor monetario del evento.

* Establece value en la suma de (price * quantity) para todos los elementos de items. No incluyas shipping ni tax.
* Por lo general, se requiere value para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas value.
* currency es obligatorio si configuras value.
items Array<Item> Sí Son los elementos del evento.

Parámetros de elementos

Nombre Tipo Obligatorio Valor de ejemplo Descripción
item_id string Sí* SKU_12345

Se trata del ID del artículo.

*Se requiere item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere item_id o item_name.

affiliation string No Google Store Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física.
Nota: `affiliation` solo está disponible a nivel del elemento.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Es el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Índice o posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o la taxonomía adicional del artículo.
item_category3 string No Camisas Es la tercera jerarquía de categorías o taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
item_category5 string No Manga corta Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
item_list_id string No related_products El ID de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_id a nivel del evento.
Si no se establece, se usa el item_list_id a nivel del evento, si está presente.
item_list_name string No Productos relacionados El nombre de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_name a nivel del evento.
Si no se establece, se usa el item_list_name a nivel del evento, si está presente.
item_variant string No verde Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place de San Francisco) Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: `location id` solo está disponible a nivel del elemento.
price number No 10.01 Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado.
Si se aplica un descuento al artículo, establece price en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro discount.
quantity number No 3

Cantidad de artículos.

Si no se establece, quantity se establece en 1.
Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: add_to_cart
  • Variables de capa de datos (nombre - nombre de la variable de capa de datos):
    • Artículos de comercio electrónico: ecommerce.items
    • Valor del comercio electrónico: ecommerce.value
    • Moneda de comercio electrónico: ecommerce.currency
  • Parámetros del evento (nombre del parámetro y valor):
    • items: &lbrace;&lbrace;Artículos de comercio electrónico&rbrace;&rbrace;
    • value: &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency: &lbrace;&lbrace;Moneda del comercio electrónico&rbrace;&rbrace;
  • Activador: El evento es igual a add_to_cart

Configuración del activador:

  • Tipo de activador: Evento personalizado
  • Nombre del evento: add_to_cart
  • Este activador se activa en todos los eventos personalizados.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

add_to_wishlist

El evento indica que se agregó un elemento a una lista de deseos. Usa este evento para identificar los artículos de regalo populares en tu app.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras.

Las métricas de valor en el evento view_item no contribuyen a los ingresos

* Si estableces value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30.03 Es el valor monetario del evento.

* Establece value en la suma de (price * quantity) para todos los elementos de items. No incluyas shipping ni tax.
* Por lo general, se requiere value para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas value.
* currency es obligatorio si configuras value.
items Array<Item> Sí Son los elementos del evento.

Parámetros de elementos

Nombre Tipo Obligatorio Valor de ejemplo Descripción
item_id string Sí* SKU_12345

Se trata del ID del artículo.

*Se requiere item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere item_id o item_name.

affiliation string No Google Store Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física.
Nota: `affiliation` solo está disponible a nivel del elemento.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Es el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Índice o posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o la taxonomía adicional del artículo.
item_category3 string No Camisas Es la tercera jerarquía de categorías o taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
item_category5 string No Manga corta Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
item_list_id string No related_products El ID de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_id a nivel del evento.
Si no se establece, se usa el item_list_id a nivel del evento, si está presente.
item_list_name string No Productos relacionados El nombre de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_name a nivel del evento.
Si no se establece, se usa el item_list_name a nivel del evento, si está presente.
item_variant string No verde Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place de San Francisco) Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: `location id` solo está disponible a nivel del elemento.
price number No 10.01 Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado.
Si se aplica un descuento al artículo, establece price en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro discount.
quantity number No 3

Cantidad de artículos.

Si no se establece, quantity se establece en 1.
Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: add_to_wishlist
  • Variables de capa de datos (nombre - nombre de la variable de capa de datos):
    • Artículos de comercio electrónico: ecommerce.items
    • Valor del comercio electrónico: ecommerce.value
    • Moneda de comercio electrónico: ecommerce.currency
  • Parámetros del evento (nombre del parámetro y valor):
    • items: &lbrace;&lbrace;Artículos de comercio electrónico&rbrace;&rbrace;
    • value: &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency: &lbrace;&lbrace;Moneda del comercio electrónico&rbrace;&rbrace;
  • Activador: El evento es igual a add_to_wishlist

Configuración del activador:

  • Tipo de activador: Evento personalizado
  • Nombre del evento: add_to_wishlist
  • Este activador se activa en todos los eventos personalizados.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_wishlist",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

begin_checkout

Este evento indica que un usuario comenzó la confirmación de la compra.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras.

Las métricas de valor en el evento view_item no contribuyen a los ingresos

* Si estableces value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30.03 Es el valor monetario del evento.

* Establece value en la suma de (price * quantity) para todos los elementos de items. No incluyas shipping ni tax.
* Por lo general, se requiere value para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas value.
* currency es obligatorio si configuras value.
coupon string No SUMMER_FUN Indica el nombre o código del cupón asociado con el evento.

Los parámetros coupon a nivel del evento y del artículo son independientes.
items Array<Item> Sí Son los elementos del evento.

Parámetros de elementos

Nombre Tipo Obligatorio Valor de ejemplo Descripción
item_id string Sí* SKU_12345

Se trata del ID del artículo.

*Se requiere item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere item_id o item_name.

affiliation string No Google Store Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física.
Nota: `affiliation` solo está disponible a nivel del elemento.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Es el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Índice o posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o la taxonomía adicional del artículo.
item_category3 string No Camisas Es la tercera jerarquía de categorías o taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
item_category5 string No Manga corta Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
item_list_id string No related_products El ID de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_id a nivel del evento.
Si no se establece, se usa el item_list_id a nivel del evento, si está presente.
item_list_name string No Productos relacionados El nombre de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_name a nivel del evento.
Si no se establece, se usa el item_list_name a nivel del evento, si está presente.
item_variant string No verde Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place de San Francisco) Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: `location id` solo está disponible a nivel del elemento.
price number No 10.01 Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado.
Si se aplica un descuento al artículo, establece price en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro discount.
quantity number No 3

Cantidad de artículos.

Si no se establece, quantity se establece en 1.
Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: begin_checkout
  • Variables de capa de datos (nombre - nombre de la variable de capa de datos):
    • Artículos de comercio electrónico: ecommerce.items
    • Valor del comercio electrónico: ecommerce.value
    • Moneda de comercio electrónico: ecommerce.currency
    • Cupón de comercio electrónico: ecommerce.coupon
  • Parámetros del evento (nombre del parámetro y valor):
    • items: &lbrace;&lbrace;Artículos de comercio electrónico&rbrace;&rbrace;
    • value: &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency: &lbrace;&lbrace;Moneda del comercio electrónico&rbrace;&rbrace;
    • coupon: &lbrace;&lbrace;Ecommerce Coupon&rbrace;&rbrace;
  • Activador: El evento es igual a begin_checkout

Configuración del activador:

  • Tipo de activador: Evento personalizado
  • Nombre del evento: begin_checkout
  • Este activador se activa en todos los eventos personalizados.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "begin_checkout",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

close_convert_lead

Este evento mide cuando se convierte y cierra un cliente potencial (por ejemplo, a través de una compra).

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Moneda del value del evento, en formato ISO 4217 de 3 letras.

* Si estableces value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30.03 Es el valor monetario del evento.

* Por lo general, se requiere value para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas value.
* currency es obligatorio si configuras value.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: close_convert_lead
  • Parámetros del evento (nombre del parámetro y valor):
    • currency, USD
    • value - 30.03
  • Activa el evento cuando el usuario se convirtió en un cliente potencial que generó una conversión (un cliente)

close_unconvert_lead

Este evento mide cuando se marca a un usuario como que no se convertirá en un cliente potencial que generó conversiones, junto con el motivo.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Moneda del value del evento, en formato ISO 4217 de 3 letras.

* Si estableces value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30.03 Es el valor monetario del evento.

* Por lo general, se requiere value para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas value.
* currency es obligatorio si configuras value.
unconvert_lead_reason string No Nunca respondió Es el motivo por el que no se generó una conversión del cliente potencial.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: close_unconvert_lead
  • Parámetros del evento (nombre del parámetro y valor):
    • currency, USD
    • value - 30.03
  • Activa el evento cuando se marca a un usuario como un cliente potencial que no generó una conversión por uno de varios motivos.

disqualify_lead

Este evento mide cuando un usuario se marca como no calificado para convertirse en cliente potencial, junto con el motivo de la descalificación.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Moneda del value del evento, en formato ISO 4217 de 3 letras.

* Si estableces value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30.03 Es el valor monetario del evento.

* Por lo general, se requiere value para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas value.
* currency es obligatorio si configuras value.
disqualified_lead_reason string No No quiero comprar Es el motivo por el que un cliente potencial se marcó como descalificado.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: disqualify_lead
  • Parámetros del evento (nombre del parámetro y valor):
    • currency, USD
    • value - 30.03
    • disqualified_lead_reason: No quiero comprar
  • Activa el evento cuando se marca a un usuario como no calificado para convertirse en cliente potencial por uno de varios motivos.

earn_virtual_currency

Este evento mide cuando se le otorga moneda virtual a un usuario en un juego. Registra este evento junto con spend_virtual_currency para comprender mejor tu economía virtual.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
virtual_currency_name string No Gems Indica el nombre de la moneda virtual.
value number No 5 Es el valor de la moneda virtual.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: earn_virtual_currency
  • Parámetros del evento (nombre del parámetro y valor):
    • virtual_currency_name - Gems
    • value - 5
  • Activa el evento cuando se le otorga dinero virtual a alguien

generate_lead

Este evento mide cuando se generó un cliente potencial (por ejemplo, a través de un formulario). Registra esta información para comprender la efectividad de tus campañas de marketing y cuántos clientes vuelven a interactuar con tu empresa después de que se les muestra un remarketing.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Moneda del value del evento, en formato ISO 4217 de 3 letras.

* Si estableces value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30.03 Es el valor monetario del evento.

* Por lo general, se requiere value para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas value.
* currency es obligatorio si configuras value.
lead_source string No Feria comercial Es la fuente del cliente potencial.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: generate_lead
  • Parámetros del evento (nombre del parámetro y valor):
    • currency, USD
    • value - 30.03
    • lead_source: Feria comercial
  • Activa el evento cuando se genere un cliente potencial

join_group

Registra este evento cuando un usuario se une a un grupo, como un gremio, un equipo o una familia. Usa este evento para analizar la popularidad de ciertos grupos o funciones de redes sociales.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
group_id string No G_12345 Es el ID del grupo.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: join_group
  • Parámetros del evento (nombre del parámetro y valor):
    • group_id - G_12345
  • Activa el evento cuando un usuario se une a un grupo

level_end

Este evento indica que un jugador llegó al final de un nivel en un juego.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
level_name string No El viaje comienza… Es el nombre del nivel.
success boolean No verdadero Se establece en true si el nivel se completó correctamente.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: level_end
  • Parámetros del evento (nombre del parámetro y valor):
    • level_name: Comienza el viaje…
    • success: true
  • Se activa cuando un jugador llega al final de un nivel (p. ej., la página de confirmación del nivel).

level_start

Este evento indica que un jugador comenzó un nivel en un juego.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
level_name string No El viaje comienza… Es el nombre del nivel.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: level_start
  • Parámetros del evento (nombre del parámetro y valor):
    • level_name: Comienza el viaje…
  • Se activa cuando alguien comienza un nivel nuevo (p.ej., la página de inicio del nivel)

level_up

Este evento indica que un jugador subió de nivel en un juego. Úsala para medir la distribución de niveles de tu base de usuarios y, así, identificar los niveles que son difíciles de completar.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
level number No 5 Es el nivel del personaje.
character string No Jugador 1 Es el personaje que subió de nivel.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: level_up
  • Parámetros del evento (nombre del parámetro y valor):
    • level - 5
    • character: Jugador 1
  • Se activa cuando un jugador sube de nivel

login

Envía este evento para indicar que un usuario accedió a tu sitio web o aplicación.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
method string No Google Es el método que se usó para acceder.

Ejemplo

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: login
  • Parámetros del evento (nombre del parámetro y valor):
    • method: Google
  • Se activa cuando un usuario accede

post_score

Envía este evento cuando el usuario publique una puntuación. Usa este evento para comprender el rendimiento de los usuarios en tu juego y correlacionar las puntuaciones altas con los públicos o los comportamientos.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
score number Sí 10000 Es la puntuación que se publicará.
level number No 5 Es el nivel de la puntuación.
character string No Jugador 1 Es el personaje que obtuvo la puntuación.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: post_score
  • Parámetros del evento (nombre del parámetro y valor):
    • score - 10000
    • level - 5
    • character: Jugador 1
  • Se activa cuando el usuario publica una puntuación.

purchase

Este evento indica cuándo un usuario compra uno o más artículos.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras.

Las métricas de valor en el evento view_item no contribuyen a los ingresos

* Si estableces value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30.03 Es el valor monetario del evento.

* Establece value en la suma de (price * quantity) para todos los elementos de items. No incluyas shipping ni tax.
* Por lo general, se requiere value para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas value.
* currency es obligatorio si configuras value.
customer_type string (new / returning) No nuevo ¿La conversión proviene de un cliente `nuevo` o `recurrente`?
  • new: Cliente nuevo que no realizó una compra en un período determinado (se recomienda establecer una ventana de 540 días y configurar este valor de parámetro como predeterminado, pero no es obligatorio)
  • returning: Un cliente recurrente que hizo una compra durante el período determinado.

No especifiques un valor si no hay certeza (por ejemplo, si el usuario completó la compra como invitado).
transaction_id string Sí T_12345 Es el identificador único de una transacción.

El parámetro transaction_id te ayuda a evitar recibir eventos duplicados por una compra.
coupon string No SUMMER_FUN Indica el nombre o código del cupón asociado con el evento.

Los parámetros coupon a nivel del evento y del artículo son independientes.
shipping number No 3.33 Es el costo de envío asociado a una transacción.
tax number No 1.11 Es el costo de impuestos asociado con una transacción.
items Array<Item> Sí Son los elementos del evento.

Parámetros de elementos

Nombre Tipo Obligatorio Valor de ejemplo Descripción
item_id string Sí* SKU_12345

Se trata del ID del artículo.

*Se requiere item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere item_id o item_name.

affiliation string No Google Store Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física.
Nota: `affiliation` solo está disponible a nivel del elemento.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Es el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Índice o posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o la taxonomía adicional del artículo.
item_category3 string No Camisas Es la tercera jerarquía de categorías o taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
item_category5 string No Manga corta Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
item_list_id string No related_products El ID de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_id a nivel del evento.
Si no se establece, se usa el item_list_id a nivel del evento, si está presente.
item_list_name string No Productos relacionados El nombre de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_name a nivel del evento.
Si no se establece, se usa el item_list_name a nivel del evento, si está presente.
item_variant string No verde Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place de San Francisco) Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: `location id` solo está disponible a nivel del elemento.
price number No 10.01 Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado.
Si se aplica un descuento al artículo, establece price en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro discount.
quantity number No 3

Cantidad de artículos.

Si no se establece, quantity se establece en 1.
Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: purchase
    • Artículos de comercio electrónico: ecommerce.items
    • ID de transacción de comercio electrónico: ecommerce.transaction_id
    • Valor del comercio electrónico: ecommerce.value
    • Impuestos de comercio electrónico: ecommerce.tax
    • Envío de comercio electrónico: ecommerce.shipping
    • Moneda de comercio electrónico: ecommerce.currency
    • Cupón de comercio electrónico: ecommerce.coupon
  • Parámetros del evento (nombre del parámetro y valor):
    • items: &lbrace;&lbrace;Artículos de comercio electrónico&rbrace;&rbrace;
    • transaction_id: &lbrace;&lbrace;ID de transacción de comercio electrónico&rbrace;&rbrace;
    • value: &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • tax: &lbrace;&lbrace;Ecommerce Tax&rbrace;&rbrace;
    • shipping: &lbrace;&lbrace;Ecommerce Shipping&rbrace;&rbrace;
    • currency: &lbrace;&lbrace;Moneda del comercio electrónico&rbrace;&rbrace;
    • coupon: &lbrace;&lbrace;Ecommerce Coupon&rbrace;&rbrace;
  • Activador: El evento es igual a compra

Configuración del activador:

  • Tipo de activador: Evento personalizado
  • Nombre del evento: purchase
  • Este activador se activa en todos los eventos personalizados.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "purchase",
  ecommerce: {
    transaction_id: "T_12345",
    // Sum of (price * quantity) for all items.
    value: 72.05,
    tax: 3.60,
    shipping: 5.99,
    currency: "USD",
    coupon: "SUMMER_SALE",
    customer_type: "new",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

qualify_lead

Este evento mide cuando se marca a un usuario como apto para convertirse en cliente potencial calificado.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Moneda del value del evento, en formato ISO 4217 de 3 letras.

* Si estableces value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30.03 Es el valor monetario del evento.

* Por lo general, se requiere value para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas value.
* currency es obligatorio si configuras value.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: qualify_lead
  • Parámetros del evento (nombre del parámetro y valor):
    • currency, USD
    • value - 30.03
  • Activa el evento cuando se marque a un usuario como apto para convertirse en cliente potencial calificado.

refund

Este evento indica cuándo se reembolsan uno o más artículos a un usuario.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras.

Las métricas de valor en el evento view_item no contribuyen a los ingresos

* Si estableces value, se requiere currency para que las métricas de ingresos se calculen con precisión.
transaction_id string Sí T_12345 Es el identificador único de una transacción.
value number Sí* 30.03 Es el valor monetario del evento.

* Establece value en la suma de (price * quantity) para todos los elementos de items. No incluyas shipping ni tax.
* Por lo general, se requiere value para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas value.
* currency es obligatorio si configuras value.
coupon string No SUMMER_FUN Indica el nombre o código del cupón asociado con el evento.

Los parámetros coupon a nivel del evento y del artículo son independientes.
shipping number No 3.33 Es el costo de envío asociado a una transacción.
tax number No 1.11 Es el costo de impuestos asociado con una transacción.
items Array<Item> No* Son los elementos del evento.

Parámetros de elementos

Nombre Tipo Obligatorio Valor de ejemplo Descripción
item_id string Sí* SKU_12345

Se trata del ID del artículo.

*Se requiere item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere item_id o item_name.

affiliation string No Google Store Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física.
Nota: `affiliation` solo está disponible a nivel del elemento.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Es el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Índice o posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o la taxonomía adicional del artículo.
item_category3 string No Camisas Es la tercera jerarquía de categorías o taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
item_category5 string No Manga corta Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
item_list_id string No related_products El ID de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_id a nivel del evento.
Si no se establece, se usa el item_list_id a nivel del evento, si está presente.
item_list_name string No Productos relacionados El nombre de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_name a nivel del evento.
Si no se establece, se usa el item_list_name a nivel del evento, si está presente.
item_variant string No verde Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place de San Francisco) Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: `location id` solo está disponible a nivel del elemento.
price number No 10.01 Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado.
Si se aplica un descuento al artículo, establece price en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro discount.
quantity number No 3

Cantidad de artículos.

Si no se establece, quantity se establece en 1.
Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: refund
  • Variables de capa de datos (nombre - nombre de la variable de capa de datos):
    • Artículos de comercio electrónico: ecommerce.items
    • ID de transacción de comercio electrónico: ecommerce.transaction_id
    • Valor del comercio electrónico: ecommerce.value
    • Impuestos de comercio electrónico: ecommerce.tax
    • Envío de comercio electrónico: ecommerce.shipping
    • Moneda de comercio electrónico: ecommerce.currency
    • Cupón de comercio electrónico: ecommerce.coupon
  • Parámetros del evento (nombre del parámetro y valor):
    • items: &lbrace;&lbrace;Artículos de comercio electrónico&rbrace;&rbrace;
    • transaction_id: &lbrace;&lbrace;ID de transacción de comercio electrónico&rbrace;&rbrace;
    • value: &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • tax: &lbrace;&lbrace;Ecommerce Tax&rbrace;&rbrace;
    • shipping: &lbrace;&lbrace;Ecommerce Shipping&rbrace;&rbrace;
    • currency: &lbrace;&lbrace;Moneda del comercio electrónico&rbrace;&rbrace;
    • coupon: &lbrace;&lbrace;Ecommerce Coupon&rbrace;&rbrace;
  • Activador: El evento es igual a reembolso

Configuración del activador:

  • Tipo de activador: Evento personalizado
  • Nombre del evento: refund
  • Este activador se activa en todos los eventos personalizados.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "refund",
  ecommerce: {
    currency: "USD",
    transaction_id: "T_12345", // Transaction ID. Required for purchases and refunds.
    value: 30.03,
    coupon: "SUMMER_FUN",
    shipping: 3.33,
    tax: 1.11,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

remove_from_cart

Este evento indica que se quitó un artículo de un carrito.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras.

Las métricas de valor en el evento view_item no contribuyen a los ingresos

* Si estableces value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30.03 Es el valor monetario del evento.

* Establece value en la suma de (price * quantity) para todos los elementos de items. No incluyas shipping ni tax.
* Por lo general, se requiere value para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas value.
* currency es obligatorio si configuras value.
items Array<Item> Sí Son los elementos del evento.

Parámetros de elementos

Nombre Tipo Obligatorio Valor de ejemplo Descripción
item_id string Sí* SKU_12345

Se trata del ID del artículo.

*Se requiere item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere item_id o item_name.

affiliation string No Google Store Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física.
Nota: `affiliation` solo está disponible a nivel del elemento.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Es el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Índice o posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o la taxonomía adicional del artículo.
item_category3 string No Camisas Es la tercera jerarquía de categorías o taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
item_category5 string No Manga corta Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
item_list_id string No related_products El ID de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_id a nivel del evento.
Si no se establece, se usa el item_list_id a nivel del evento, si está presente.
item_list_name string No Productos relacionados El nombre de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_name a nivel del evento.
Si no se establece, se usa el item_list_name a nivel del evento, si está presente.
item_variant string No verde Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place de San Francisco) Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: `location id` solo está disponible a nivel del elemento.
price number No 10.01 Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado.
Si se aplica un descuento al artículo, establece price en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro discount.
quantity number No 3

Cantidad de artículos.

Si no se establece, quantity se establece en 1.
Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: remove_from_cart
  • Variables de capa de datos (nombre - nombre de la variable de capa de datos):
    • Artículos de comercio electrónico: ecommerce.items
    • Valor del comercio electrónico: ecommerce.value
    • Moneda de comercio electrónico: ecommerce.currency
  • Parámetros del evento (nombre del parámetro y valor):
    • items: &lbrace;&lbrace;Artículos de comercio electrónico&rbrace;&rbrace;
    • value: &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency: &lbrace;&lbrace;Moneda del comercio electrónico&rbrace;&rbrace;
  • Activador: El evento es igual a remove_from_cart

Configuración del activador:

  • Tipo de activador: Evento personalizado
  • Nombre del evento: remove_from_cart
  • Este activador se activa en todos los eventos personalizados.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "remove_from_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

Registra este evento para indicar cuándo el usuario realizó una búsqueda. Puedes usar este evento para identificar lo que los usuarios buscan en tu sitio web o aplicación. Por ejemplo, podrías enviar este evento cuando un usuario vea una página de resultados de búsqueda después de realizar una búsqueda.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
search_term string Sí Camisetas Indica el término que se buscó.

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: search
  • Parámetros del evento (nombre del parámetro y valor):
    • search_term, camisetas
  • Se activa cuando un usuario realiza una búsqueda en tu sitio web

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: search
  • Parámetros del evento (nombre del parámetro y valor):
    • search_term, camisetas
  • Se activa cuando un usuario realiza una búsqueda en tu sitio web

select_content

Este evento indica que un usuario seleccionó contenido de un tipo determinado. Este evento puede ayudarte a identificar el contenido y las categorías de contenido populares en tu sitio web o aplicación.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
content_type string No producto Es el tipo de contenido seleccionado.
content_id string No C_12345 Es un identificador del contenido que se seleccionó.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: select_content
  • Parámetros del evento (nombre del parámetro y valor):
    • content_type: Producto
    • content_id: C_12345
  • Activador: El evento es igual a select_content

select_item

Este evento indica que se seleccionó un elemento de una lista.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
item_list_id string No related_products El ID de la lista en la que se presentó el artículo al usuario

Se ignora si se establece a nivel del elemento.
item_list_name string No Productos relacionados El nombre de la lista en la que se presentó el artículo al usuario

Se ignora si se establece a nivel del elemento.
items Array<Item> Sí* Son los elementos del evento.

* Se espera que el array items tenga un solo elemento, que representa el elemento seleccionado. Si se proporcionan varios elementos, solo se usará el primer elemento de items.

Parámetros de elementos

Nombre Tipo Obligatorio Valor de ejemplo Descripción
item_id string Sí* SKU_12345

Se trata del ID del artículo.

*Se requiere item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere item_id o item_name.

affiliation string No Google Store Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física.
Nota: `affiliation` solo está disponible a nivel del elemento.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Es el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Índice o posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o la taxonomía adicional del artículo.
item_category3 string No Camisas Es la tercera jerarquía de categorías o taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
item_category5 string No Manga corta Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
item_list_id string No related_products El ID de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_id a nivel del evento.
Si no se establece, se usa el item_list_id a nivel del evento, si está presente.
item_list_name string No Productos relacionados El nombre de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_name a nivel del evento.
Si no se establece, se usa el item_list_name a nivel del evento, si está presente.
item_variant string No verde Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place de San Francisco) Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: `location id` solo está disponible a nivel del elemento.
price number No 10.01 Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado.
Si se aplica un descuento al artículo, establece price en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro discount.
quantity number No 3

Cantidad de artículos.

Si no se establece, quantity se establece en 1.
Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: select_item
  • Variables de capa de datos (nombre - nombre de la variable de capa de datos):
    • Artículos de comercio electrónico: ecommerce.items
    • ID de la lista de artículos de comercio electrónico: ecommerce.item_list_id
    • Nombre de la lista de artículos de comercio electrónico: ecommerce.item_list_name
  • Parámetros del evento (nombre del parámetro y valor):
    • items: &lbrace;&lbrace;Artículos de comercio electrónico&rbrace;&rbrace;
    • item_list_id: &lbrace;&lbrace;ID de la lista de artículos de comercio electrónico&rbrace;&rbrace;
    • item_list_name: &lbrace;&lbrace;Nombre de la lista de artículos de comercio electrónico&rbrace;&rbrace;
  • Activador: El evento es igual a select_item

Configuración del activador:

  • Tipo de activador: Evento personalizado
  • Nombre del evento: select_item
  • Este activador se activa en todos los eventos personalizados.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_item",
  ecommerce: {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

select_promotion

Este evento indica que se seleccionó una promoción de una lista.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
creative_name string No summer_banner2 Es el nombre de la creatividad de promoción.

Se ignora si se establece a nivel del elemento.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad de promoción asociado al evento.

Se ignora si se establece a nivel del elemento.
promotion_id string No P_12345 Es el ID de la promoción asociada al evento.

Se ignora si se establece a nivel del elemento.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada al evento.

Se ignora si se establece a nivel del elemento.
items Array<Item> No Son los elementos del evento.

Parámetros de elementos

Nombre Tipo Obligatorio Valor de ejemplo Descripción
item_id string Sí* SKU_12345

Se trata del ID del artículo.

*Se requiere item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere item_id o item_name.

affiliation string No Google Store Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física.
Nota: `affiliation` solo está disponible a nivel del elemento.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
creative_name string No summer_banner2 Es el nombre de la creatividad de promoción.

Si se configura, se ignora el creative_name a nivel del evento.
Si no se establece, se usa el creative_name a nivel del evento, si está presente.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad de promoción asociado al elemento.

Si se configura, se ignora el creative_slot a nivel del evento.
Si no se establece, se usa el creative_slot a nivel del evento, si está presente.
discount number No 2.22 Es el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Índice o posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o la taxonomía adicional del artículo.
item_category3 string No Camisas Es la tercera jerarquía de categorías o taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
item_category5 string No Manga corta Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
item_list_id string No related_products El ID de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_id a nivel del evento.
Si no se establece, se usa el item_list_id a nivel del evento, si está presente.
item_list_name string No Productos relacionados El nombre de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_name a nivel del evento.
Si no se establece, se usa el item_list_name a nivel del evento, si está presente.
item_variant string No verde Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place de San Francisco) Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: `location id` solo está disponible a nivel del elemento.
price number No 10.01 Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado.
Si se aplica un descuento al artículo, establece price en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro discount.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

Si se configura, se ignora el promotion_id a nivel del evento.
Si no se establece, se usa el promotion_id a nivel del evento, si está presente.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada al artículo.

Si se configura, se ignora el promotion_name a nivel del evento.
Si no se establece, se usa el promotion_name a nivel del evento, si está presente.
quantity number No 3

Cantidad de artículos.

Si no se establece, quantity se establece en 1.
Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Variables de capa de datos (nombre - nombre de la variable de capa de datos):
    • Nombre de la creatividad de comercio electrónico: ecommerce.creative_name
    • Espacio creativo de comercio electrónico: ecommerce.creative_slot
    • ID de promoción de comercio electrónico: ecommerce.promotion_id
    • Nombre de la promoción de comercio electrónico: ecommerce.promotion_name
    • Artículos de comercio electrónico: ecommerce.items
  • Parámetros del evento (nombre del parámetro y valor):
    • creative_name: &lbrace;&lbrace;Nombre de la creatividad de comercio electrónico&rbrace;&rbrace;
    • creative_slot: &lbrace;&lbrace;Espacio para creatividad de comercio electrónico&rbrace;&rbrace;
    • promotion_id: &lbrace;&lbrace;ID de promoción de comercio electrónico&rbrace;&rbrace;
    • promotion_name: &lbrace;&lbrace;Nombre de la promoción de comercio electrónico&rbrace;&rbrace;
    • items: &lbrace;&lbrace;Artículos de comercio electrónico&rbrace;&rbrace;
  • Tipo de variable: Variable de capa de datos: "ecommerce.items"
  • Activador: El evento es igual a select_promotion

Configuración del activador:

  • Tipo de activador: Evento personalizado
  • Nombre del evento: select_promotion
  • Este activador se activa en todos los eventos personalizados.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_promotion",
  ecommerce: {
    creative_name: "Summer Banner",
    creative_slot: "featured_app_1",
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

share

Usa este evento cuando un usuario haya compartido contenido.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
method string No Twitter Es el método con el que se comparte el contenido.
content_type string No imagen Es el tipo de contenido compartido.
item_id string No C_12345 Es el ID del contenido compartido.

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: share
  • Parámetros del evento (nombre del parámetro y valor):
    • method: Twitter
    • content_type: Imagen
    • item_id: C_12345
  • Se activa cuando un usuario comparte contenido

Ejemplo

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: share
  • Parámetros del evento (nombre del parámetro y valor):
    • method: Twitter
    • content_type: Imagen
    • item_id: C_12345
  • Se activa cuando un usuario comparte contenido

sign_up

Este evento indica que un usuario se registró para obtener una cuenta. Usa este evento para comprender los diferentes comportamientos de los usuarios que accedieron a una cuenta y los que salieron de ella.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
method string No Google Es el método que se usó para registrarse.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: sign_up
  • Parámetros del evento (nombre del parámetro y valor):
    • method: Google
  • Se activa cuando un usuario se registra para obtener una cuenta.

spend_virtual_currency

Este evento mide la venta de bienes virtuales en tu app y te ayuda a identificar cuáles son los más populares.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
value number Sí 5 Es el valor de la moneda virtual.
virtual_currency_name string Sí Gems Indica el nombre de la moneda virtual.
item_name string No Starter Boost Es el nombre del elemento para el que se usa la moneda virtual.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: spend_virtual_currency
  • Parámetros del evento (nombre del parámetro y valor):
    • value - 5
    • virtual_currency_name - Gems
    • item_name: Starter Boost
  • Se activa cuando alguien compra un artículo virtual

tutorial_begin

Este evento indica el inicio del proceso de incorporación. Úsalo en un embudo con tutorial_complete para comprender cuántos usuarios completan el instructivo.

Parámetros

No hay parámetros para este evento.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: tutorial_begin
  • Se activa cuando alguien comienza el proceso de integración

tutorial_complete

Este evento indica que el usuario completó tu proceso de incorporación. Úsalo en un embudo con tutorial_begin para comprender cuántos usuarios completan el instructivo.

Parámetros

No se sugieren parámetros para este evento.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: tutorial_complete
  • Se activa cuando alguien completa el proceso de integración

unlock_achievement

Registra este evento cuando el usuario desbloqueó un logro. Este evento puede ayudarte a comprender la experiencia de los usuarios con tu juego.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
achievement_id string Sí A_12345 Indica el ID del logro que se desbloqueó.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: unlock_achievement
  • Parámetros del evento (nombre del parámetro y valor):
    • achievement_id - A_12345
  • Se activa cuando un usuario desbloqueó un logro.

view_cart

Este evento indica que un usuario vio su carrito.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras.

Las métricas de valor en el evento view_item no contribuyen a los ingresos

* Si estableces value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30.03 Es el valor monetario del evento.

* Establece value en la suma de (price * quantity) para todos los elementos de items. No incluyas shipping ni tax.
* Por lo general, se requiere value para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas value.
* currency es obligatorio si configuras value.
items Array<Item> Sí Son los elementos del evento.

Parámetros de elementos

Nombre Tipo Obligatorio Valor de ejemplo Descripción
item_id string Sí* SKU_12345

Se trata del ID del artículo.

*Se requiere item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere item_id o item_name.

affiliation string No Google Store Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física.
Nota: `affiliation` solo está disponible a nivel del elemento.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Es el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Índice o posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o la taxonomía adicional del artículo.
item_category3 string No Camisas Es la tercera jerarquía de categorías o taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
item_category5 string No Manga corta Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
item_list_id string No related_products El ID de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_id a nivel del evento.
Si no se establece, se usa el item_list_id a nivel del evento, si está presente.
item_list_name string No Productos relacionados El nombre de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_name a nivel del evento.
Si no se establece, se usa el item_list_name a nivel del evento, si está presente.
item_variant string No verde Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place de San Francisco) Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: `location id` solo está disponible a nivel del elemento.
price number No 10.01 Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado.
Si se aplica un descuento al artículo, establece price en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro discount.
quantity number No 3

Cantidad de artículos.

Si no se establece, quantity se establece en 1.
Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: view_cart
  • Variables de capa de datos (nombre - nombre de la variable de capa de datos):
    • Artículos de comercio electrónico: ecommerce.items
    • Valor del comercio electrónico: ecommerce.value
    • Moneda de comercio electrónico: ecommerce.currency
  • Parámetros del evento (nombre del parámetro y valor):
    • items: &lbrace;&lbrace;Artículos de comercio electrónico&rbrace;&rbrace;
    • value: &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency: &lbrace;&lbrace;Moneda del comercio electrónico&rbrace;&rbrace;
  • Activador: El evento es igual a view_cart

Configuración del activador:

  • Tipo de activador: Evento personalizado
  • Nombre del evento: view_cart
  • Este activador se activa en todos los eventos personalizados.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

view_item

Este evento indica que se mostró contenido al usuario. Usa este evento para descubrir los artículos más populares que se vieron.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras.

Las métricas de valor en el evento view_item no contribuyen a los ingresos

* Si estableces value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30.03 Es el valor monetario del evento.

* Establece value en la suma de (price * quantity) para todos los elementos de items. No incluyas shipping ni tax.
* Por lo general, se requiere value para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas value.
* currency es obligatorio si configuras value.
items Array<Item> Sí Son los elementos del evento.

Parámetros de elementos

Nombre Tipo Obligatorio Valor de ejemplo Descripción
item_id string Sí* SKU_12345

Se trata del ID del artículo.

*Se requiere item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere item_id o item_name.

affiliation string No Google Store Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física.
Nota: `affiliation` solo está disponible a nivel del elemento.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Es el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Índice o posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o la taxonomía adicional del artículo.
item_category3 string No Camisas Es la tercera jerarquía de categorías o taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
item_category5 string No Manga corta Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
item_list_id string No related_products El ID de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_id a nivel del evento.
Si no se establece, se usa el item_list_id a nivel del evento, si está presente.
item_list_name string No Productos relacionados El nombre de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_name a nivel del evento.
Si no se establece, se usa el item_list_name a nivel del evento, si está presente.
item_variant string No verde Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place de San Francisco) Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: `location id` solo está disponible a nivel del elemento.
price number No 10.01 Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado.
Si se aplica un descuento al artículo, establece price en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro discount.
quantity number No 3

Cantidad de artículos.

Si no se establece, quantity se establece en 1.
Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: view_item
  • Variables de capa de datos (nombre - nombre de la variable de capa de datos):
    • Artículos de comercio electrónico: ecommerce.items
    • Valor del comercio electrónico: ecommerce.value
    • Moneda de comercio electrónico: ecommerce.currency
  • Parámetros del evento (nombre del parámetro y valor):
    • items: &lbrace;&lbrace;Artículos de comercio electrónico&rbrace;&rbrace;
    • value: &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency: &lbrace;&lbrace;Moneda del comercio electrónico&rbrace;&rbrace;
  • Activador: El evento es igual a view_item

Configuración del activador:

  • Tipo de activador: Evento personalizado
  • Nombre del evento: view_item
  • Este activador se activa en todos los eventos personalizados.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

view_item_list

Registra este evento cuando se le haya presentado al usuario una lista de elementos de una categoría determinada.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras.

Las métricas de valor en el evento view_item no contribuyen a los ingresos

* Si estableces value, se requiere currency para que las métricas de ingresos se calculen con precisión.
item_list_id string No related_products El ID de la lista en la que se presentó el artículo al usuario

Se ignora si se establece a nivel del elemento.
item_list_name string No Productos relacionados El nombre de la lista en la que se presentó el artículo al usuario

Se ignora si se establece a nivel del elemento.
items Array<Item> Sí Son los elementos del evento.

Parámetros de elementos

Nombre Tipo Obligatorio Valor de ejemplo Descripción
item_id string Sí* SKU_12345

Se trata del ID del artículo.

*Se requiere item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere item_id o item_name.

affiliation string No Google Store Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física.
Nota: `affiliation` solo está disponible a nivel del elemento.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Es el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Índice o posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o la taxonomía adicional del artículo.
item_category3 string No Camisas Es la tercera jerarquía de categorías o taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
item_category5 string No Manga corta Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
item_list_id string No related_products El ID de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_id a nivel del evento.
Si no se establece, se usa el item_list_id a nivel del evento, si está presente.
item_list_name string No Productos relacionados El nombre de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_name a nivel del evento.
Si no se establece, se usa el item_list_name a nivel del evento, si está presente.
item_variant string No verde Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place de San Francisco) Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: `location id` solo está disponible a nivel del elemento.
price number No 10.01 Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado.
Si se aplica un descuento al artículo, establece price en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro discount.
quantity number No 3

Cantidad de artículos.

Si no se establece, quantity se establece en 1.
Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: view_item_list
  • Variables de capa de datos (nombre - nombre de la variable de capa de datos):
    • Artículos de comercio electrónico: ecommerce.items
    • ID de la lista de artículos de comercio electrónico: ecommerce.item_list_id
    • Nombre de la lista de artículos de comercio electrónico: ecommerce.item_list_name
  • Parámetros del evento (nombre del parámetro y valor):
    • items: &lbrace;&lbrace;Artículos de comercio electrónico&rbrace;&rbrace;
    • item_list_id: &lbrace;&lbrace;ID de la lista de artículos de comercio electrónico&rbrace;&rbrace;
    • item_list_name: &lbrace;&lbrace;Nombre de la lista de artículos de comercio electrónico&rbrace;&rbrace;
  • Activador: El evento es igual a view_item_list

Configuración del activador:

  • Tipo de activador: Evento personalizado
  • Nombre del evento: view_item_list
  • Este activador se activa en todos los eventos personalizados.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item_list",
  ecommerce: {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
     {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.03,
      google_business_vertical: "retail",
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      google_business_vertical: "retail",
      quantity: 2
    }]
  }
});

view_promotion

Este evento indica que se vio una promoción desde una lista.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
creative_name string No summer_banner2 Es el nombre de la creatividad de promoción.

Se ignora si se establece a nivel del elemento.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad de promoción asociado al evento.

Se ignora si se establece a nivel del elemento.
promotion_id string No P_12345 Es el ID de la promoción asociada al evento.

Se ignora si se establece a nivel del elemento.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada al evento.

Se ignora si se establece a nivel del elemento.
items Array<Item> Sí* Son los elementos del evento.

* Se espera que el array items tenga un solo elemento, que representa el artículo asociado con la promoción. Si se proporcionan varios elementos, solo se usará el primer elemento de items.

Parámetros de elementos

Nombre Tipo Obligatorio Valor de ejemplo Descripción
item_id string Sí* SKU_12345

Se trata del ID del artículo.

*Se requiere item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere item_id o item_name.

affiliation string No Google Store Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física.
Nota: `affiliation` solo está disponible a nivel del elemento.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
creative_name string No summer_banner2 Es el nombre de la creatividad de promoción.

Si se configura, se ignora el creative_name a nivel del evento.
Si no se establece, se usa el creative_name a nivel del evento, si está presente.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad de promoción asociado al elemento.

Si se configura, se ignora el creative_slot a nivel del evento.
Si no se establece, se usa el creative_slot a nivel del evento, si está presente.
discount number No 2.22 Es el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Índice o posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o la taxonomía adicional del artículo.
item_category3 string No Camisas Es la tercera jerarquía de categorías o taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
item_category5 string No Manga corta Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
item_list_id string No related_products El ID de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_id a nivel del evento.
Si no se establece, se usa el item_list_id a nivel del evento, si está presente.
item_list_name string No Productos relacionados El nombre de la lista en la que se presentó el artículo al usuario

Si se configura, se ignora el item_list_name a nivel del evento.
Si no se establece, se usa el item_list_name a nivel del evento, si está presente.
item_variant string No verde Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place de San Francisco) Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: `location id` solo está disponible a nivel del elemento.
price number No 10.01 Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado.
Si se aplica un descuento al artículo, establece price en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro discount.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

Si se configura, se ignora el promotion_id a nivel del evento.
Si no se establece, se usa el promotion_id a nivel del evento, si está presente.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada al artículo.

Si se configura, se ignora el promotion_name a nivel del evento.
Si no se establece, se usa el promotion_name a nivel del evento, si está presente.
quantity number No 3

Cantidad de artículos.

Si no se establece, quantity se establece en 1.
Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: view_promotion
  • Variables de capa de datos (nombre - nombre de la variable de capa de datos):
    • Nombre de la creatividad de comercio electrónico: ecommerce.creative_name
    • Espacio creativo de comercio electrónico: ecommerce.creative_slot
    • ID de promoción de comercio electrónico: ecommerce.promotion_id
    • Nombre de la promoción de comercio electrónico: ecommerce.promotion_name
    • Artículos de comercio electrónico: ecommerce.items
  • Parámetros del evento (nombre del parámetro y valor):
    • creative_name: &lbrace;&lbrace;Nombre de la creatividad de comercio electrónico&rbrace;&rbrace;
    • creative_slot: &lbrace;&lbrace;Espacio para creatividad de comercio electrónico&rbrace;&rbrace;
    • promotion_id: &lbrace;&lbrace;ID de promoción de comercio electrónico&rbrace;&rbrace;
    • promotion_name: &lbrace;&lbrace;Nombre de la promoción de comercio electrónico&rbrace;&rbrace;
    • items: &lbrace;&lbrace;Artículos de comercio electrónico&rbrace;&rbrace;
  • Activador: El evento es igual a view_promotion

Configuración del activador:

  • Tipo de activador: Evento personalizado
  • Nombre del evento: view_promotion
  • Este activador se activa en todos los eventos personalizados.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_promotion",
  ecommerce: {
    creative_name: "Summer Banner",
    creative_slot: "featured_app_1",
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

working_lead

Este evento mide cuando un usuario se comunica con un representante o un representante se comunica con él.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Moneda del value del evento, en formato ISO 4217 de 3 letras.

* Si estableces value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30.03 Es el valor monetario del evento.

* Por lo general, se requiere value para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas value.
* currency es obligatorio si configuras value.
lead_status string No Conversaciones iniciadas Es el estado del cliente potencial.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: Evento de GA4
  • Nombre del evento: working_lead
  • Parámetros del evento (nombre del parámetro y valor):
    • currency, USD
    • value - 30.03
    • lead_status: Conversaciones iniciadas
  • Activa el evento cuando un usuario se comunica con un representante o un representante se comunica con él.