Eventos recomendados

Google Analytics envía algunos tipos de eventos automáticamente. En esta página, se describen los eventos opcionales y adicionales que puedes configurar para medir más comportamientos y generar informes más útiles para tu empresa. Estos eventos adicionales requieren más esfuerzo para configurarlos antes de que puedas usarlos, por lo que Google Analytics 4 no puede enviarlos automáticamente. Si deseas obtener instrucciones paso a paso para 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 la compra de comercio electrónico.

Parámetros

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

Métricas de valor en el evento view_item para que no contribuyan a los ingresos

* Si estableces value, debes establecer 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 un evento clave, te recomendamos que configures 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 La forma de pago elegida
items Array<Item> Sí Los artículos 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 una 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 en el alcance del artículo.
coupon string No SUMMER_FUN Indica 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o una taxonomía, esta será la primera categoría.
item_category2 string No Adultos La jerarquía de segunda categoría o la taxonomía adicional del artículo
item_category3 string No Camisas La jerarquía de tercera categoría o la taxonomía adicional del artículo
item_category4 string No Equipo de rodaje La jerarquía de cuarta categoría o la taxonomía adicional del artículo
item_category5 string No Manga corta La jerarquía de quinta categoría o la 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 establece, se ignora item_list_id a nivel del evento.
Si no se establece, se usa 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 establece, se ignora item_list_name a nivel del evento.
Si no se establece, se usa 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 Place de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de Place de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: "location id" solo está disponible en el alcance del artículo.
price number No 10.01 Es el precio de la unidad monetaria 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 la capa de datos (Nombre: nombre de la variable de capa de datos):
    • Elementos de comercio electrónico: ecommerce.items
    • Valor de 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 - valor):
    • items: &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • value: &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency: &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
    • coupon: &lbrace;&lbrace;Cupón de comercio electrónico&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,
      quantity: 3
    }
    ]
  }
});

add_shipping_info

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

Parámetros

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

Métricas de valor en el evento view_item para que no contribuyan a los ingresos

* Si estableces value, debes establecer 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 un evento clave, te recomendamos que configures 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í Los artículos 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 una 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 en el alcance del artículo.
coupon string No SUMMER_FUN Indica 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o una taxonomía, esta será la primera categoría.
item_category2 string No Adultos La jerarquía de segunda categoría o la taxonomía adicional del artículo
item_category3 string No Camisas La jerarquía de tercera categoría o la taxonomía adicional del artículo
item_category4 string No Equipo de rodaje La jerarquía de cuarta categoría o la taxonomía adicional del artículo
item_category5 string No Manga corta La jerarquía de quinta categoría o la 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 establece, se ignora item_list_id a nivel del evento.
Si no se establece, se usa 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 establece, se ignora item_list_name a nivel del evento.
Si no se establece, se usa 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 Place de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de Place de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: "location id" solo está disponible en el alcance del artículo.
price number No 10.01 Es el precio de la unidad monetaria 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 la capa de datos (Nombre: nombre de la variable de capa de datos):
    • Elementos de comercio electrónico: ecommerce.items
    • Valor de 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 - valor):
    • items: &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • value: &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency: &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
    • coupon: &lbrace;&lbrace;Cupón de comercio electrónico&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,
      quantity: 3
    }
    ]
  }
});

add_to_cart

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

Parámetros

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

Métricas de valor en el evento view_item para que no contribuyan a los ingresos

* Si estableces value, debes establecer 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 un evento clave, te recomendamos que configures value.
* currency es obligatorio si configuras value.
items Array<Item> Sí Los artículos 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 una 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 en el alcance del artículo.
coupon string No SUMMER_FUN Indica 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o una taxonomía, esta será la primera categoría.
item_category2 string No Adultos La jerarquía de segunda categoría o la taxonomía adicional del artículo
item_category3 string No Camisas La jerarquía de tercera categoría o la taxonomía adicional del artículo
item_category4 string No Equipo de rodaje La jerarquía de cuarta categoría o la taxonomía adicional del artículo
item_category5 string No Manga corta La jerarquía de quinta categoría o la 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 establece, se ignora item_list_id a nivel del evento.
Si no se establece, se usa 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 establece, se ignora item_list_name a nivel del evento.
Si no se establece, se usa 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 Place de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de Place de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: "location id" solo está disponible en el alcance del artículo.
price number No 10.01 Es el precio de la unidad monetaria 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 la capa de datos (Nombre: nombre de la variable de capa de datos):
    • Elementos de comercio electrónico: ecommerce.items
    • Valor de comercio electrónico: ecommerce.value
    • Moneda de comercio electrónico: ecommerce.currency
  • Parámetros del evento (nombre del parámetro - valor):
    • items: &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • value: &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency: &lbrace;&lbrace;Ecommerce Currency&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,
      quantity: 3
    }
    ]
  }
});

add_to_wishlist

El evento indica que se agregó un artículo 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 Es la moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras.

Métricas de valor en el evento view_item para que no contribuyan a los ingresos

* Si estableces value, debes establecer 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 un evento clave, te recomendamos que configures value.
* currency es obligatorio si configuras value.
items Array<Item> Sí Los artículos 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 una 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 en el alcance del artículo.
coupon string No SUMMER_FUN Indica 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o una taxonomía, esta será la primera categoría.
item_category2 string No Adultos La jerarquía de segunda categoría o la taxonomía adicional del artículo
item_category3 string No Camisas La jerarquía de tercera categoría o la taxonomía adicional del artículo
item_category4 string No Equipo de rodaje La jerarquía de cuarta categoría o la taxonomía adicional del artículo
item_category5 string No Manga corta La jerarquía de quinta categoría o la 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 establece, se ignora item_list_id a nivel del evento.
Si no se establece, se usa 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 establece, se ignora item_list_name a nivel del evento.
Si no se establece, se usa 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 Place de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de Place de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: "location id" solo está disponible en el alcance del artículo.
price number No 10.01 Es el precio de la unidad monetaria 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 la capa de datos (Nombre: nombre de la variable de capa de datos):
    • Elementos de comercio electrónico: ecommerce.items
    • Valor de comercio electrónico: ecommerce.value
    • Moneda de comercio electrónico: ecommerce.currency
  • Parámetros del evento (nombre del parámetro - valor):
    • items: &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • value: &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency: &lbrace;&lbrace;Ecommerce Currency&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,
      quantity: 3
    }
    ]
  }
});

begin_checkout

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

Parámetros

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

Métricas de valor en el evento view_item para que no contribuyan a los ingresos

* Si estableces value, debes establecer 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 un evento clave, te recomendamos que configures 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í Los artículos 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 una 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 en el alcance del artículo.
coupon string No SUMMER_FUN Indica 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o una taxonomía, esta será la primera categoría.
item_category2 string No Adultos La jerarquía de segunda categoría o la taxonomía adicional del artículo
item_category3 string No Camisas La jerarquía de tercera categoría o la taxonomía adicional del artículo
item_category4 string No Equipo de rodaje La jerarquía de cuarta categoría o la taxonomía adicional del artículo
item_category5 string No Manga corta La jerarquía de quinta categoría o la 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 establece, se ignora item_list_id a nivel del evento.
Si no se establece, se usa 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 establece, se ignora item_list_name a nivel del evento.
Si no se establece, se usa 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 Place de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de Place de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: "location id" solo está disponible en el alcance del artículo.
price number No 10.01 Es el precio de la unidad monetaria 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 la capa de datos (Nombre: nombre de la variable de capa de datos):
    • Elementos de comercio electrónico: ecommerce.items
    • Valor de 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 - valor):
    • items: &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • value: &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency: &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
    • coupon: &lbrace;&lbrace;Cupón de comercio electrónico&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,
      quantity: 3
    }
    ]
  }
});

close_convert_lead

Este evento mide cuándo se cerró 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 Es la moneda del value del evento, en formato ISO 4217 de 3 letras.

* Si estableces value, debes establecer 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 un evento clave, te recomendamos que configures 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 - valor):
    • currency: USD
    • value - 30.03
  • Activa el evento cuando el usuario se convierta en un cliente potencial (un cliente).

close_unconvert_lead

Este evento mide cuando un usuario se marca como no convertido en un cliente potencial, junto con el motivo.

Parámetros

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

* Si estableces value, debes establecer 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 un evento clave, te recomendamos que configures value.
* currency es obligatorio si configuras value.
unconvert_lead_reason string No Nunca respondió El motivo por el que no se generó una conversión a partir 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 - valor):
    • currency: USD
    • value - 30.03
  • Activa el evento cuando un usuario se marque como no convertido en un cliente potencial por uno de varios motivos.

disqualify_lead

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

Parámetros

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

* Si estableces value, debes establecer 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 un evento clave, te recomendamos que configures value.
* currency es obligatorio si configuras value.
disqualified_lead_reason string No No quiero comprar El motivo por el que se marcó un cliente potencial 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 - valor):
    • currency: USD
    • value - 30.03
    • disqualified_lead_reason: No busca comprar
  • Activa el evento cuando un usuario se marca como descalificado para convertirse en un 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 esta información 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 - valor):
    • virtual_currency_name: Gemas
    • value - 5
  • Activa el evento cuando se le otorga dinero virtual a alguien

generate_lead

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

Parámetros

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

* Si estableces value, debes establecer 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 un evento clave, te recomendamos que configures 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 - valor):
    • currency: USD
    • value - 30.03
    • lead_source: Feria comercial
  • Activa el evento cuando se genera 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 - 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 Comienza el viaje… 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 - valor):
    • level_name: Comienza el viaje…
    • success: verdadero
  • 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 Comienza el viaje… 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 - 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 para 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 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 - 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 usa 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 - valor):
    • method: Google
  • Activar 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 más altas con los públicos o los comportamientos.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
score number Sí 10000 La puntuación que se publicará.
level number No 5 Es el nivel de la puntuación.
character string No Jugador 1 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 - valor):
    • score: Entre 1,000 y 10,000
    • level - 5
    • character: Jugador 1
  • Se activa cuando el usuario publica una puntuación

purchase

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

Parámetros

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

Métricas de valor en el evento view_item para que no contribuyan a los ingresos

* Si estableces value, debes establecer 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 un evento clave, te recomendamos que configures value.
* currency es obligatorio si configuras value.
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 con una transacción.
tax number No 1.11 Es el costo de impuestos asociado con una transacción.
items Array<Item> Sí Los artículos 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 una 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 en el alcance del artículo.
coupon string No SUMMER_FUN Indica 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o una taxonomía, esta será la primera categoría.
item_category2 string No Adultos La jerarquía de segunda categoría o la taxonomía adicional del artículo
item_category3 string No Camisas La jerarquía de tercera categoría o la taxonomía adicional del artículo
item_category4 string No Equipo de rodaje La jerarquía de cuarta categoría o la taxonomía adicional del artículo
item_category5 string No Manga corta La jerarquía de quinta categoría o la 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 establece, se ignora item_list_id a nivel del evento.
Si no se establece, se usa 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 establece, se ignora item_list_name a nivel del evento.
Si no se establece, se usa 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 Place de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de Place de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: "location id" solo está disponible en el alcance del artículo.
price number No 10.01 Es el precio de la unidad monetaria 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
    • Elementos de comercio electrónico: ecommerce.items
    • ID de transacción de comercio electrónico: ecommerce.transaction_id
    • Valor de comercio electrónico: ecommerce.value
    • Impuesto 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 - valor):
    • items: &lbrace;&lbrace;Ecommerce Items&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;Impuesto de comercio electrónico&rbrace;&rbrace;
    • shipping: &lbrace;&lbrace;Ecommerce Shipping&rbrace;&rbrace;
    • currency: &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
    • coupon: &lbrace;&lbrace;Cupón de comercio electrónico&rbrace;&rbrace;
  • Activador: El evento es igual a purchase

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",
    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 un usuario se marca como que cumple con los criterios para convertirse en un cliente potencial calificado.

Parámetros

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

* Si estableces value, debes establecer 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 un evento clave, te recomendamos que configures 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 - valor):
    • currency: USD
    • value - 30.03
  • Activa el evento cuando un usuario se marque como que cumple con los criterios para convertirse en un cliente potencial calificado

refund

Este evento indica que se reembolsó uno o más artículos a un usuario.

Parámetros

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

Métricas de valor en el evento view_item para que no contribuyan a los ingresos

* Si estableces value, debes establecer 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 un evento clave, te recomendamos que configures 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 con una transacción.
tax number No 1.11 Es el costo de impuestos asociado con una transacción.
items Array<Item> No* Los artículos 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 una 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 en el alcance del artículo.
coupon string No SUMMER_FUN Indica 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o una taxonomía, esta será la primera categoría.
item_category2 string No Adultos La jerarquía de segunda categoría o la taxonomía adicional del artículo
item_category3 string No Camisas La jerarquía de tercera categoría o la taxonomía adicional del artículo
item_category4 string No Equipo de rodaje La jerarquía de cuarta categoría o la taxonomía adicional del artículo
item_category5 string No Manga corta La jerarquía de quinta categoría o la 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 establece, se ignora item_list_id a nivel del evento.
Si no se establece, se usa 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 establece, se ignora item_list_name a nivel del evento.
Si no se establece, se usa 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 Place de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de Place de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: "location id" solo está disponible en el alcance del artículo.
price number No 10.01 Es el precio de la unidad monetaria 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 la capa de datos (Nombre: nombre de la variable de capa de datos):
    • Elementos de comercio electrónico: ecommerce.items
    • ID de transacción de comercio electrónico: ecommerce.transaction_id
    • Valor de comercio electrónico: ecommerce.value
    • Impuesto 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 - valor):
    • items: &lbrace;&lbrace;Ecommerce Items&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;Impuesto de comercio electrónico&rbrace;&rbrace;
    • shipping: &lbrace;&lbrace;Ecommerce Shipping&rbrace;&rbrace;
    • currency: &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
    • coupon: &lbrace;&lbrace;Cupón de comercio electrónico&rbrace;&rbrace;
  • Activador: El evento es igual al 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,
      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 Es la moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras.

Métricas de valor en el evento view_item para que no contribuyan a los ingresos

* Si estableces value, debes establecer 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 un evento clave, te recomendamos que configures value.
* currency es obligatorio si configuras value.
items Array<Item> Sí Los artículos 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 una 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 en el alcance del artículo.
coupon string No SUMMER_FUN Indica 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o una taxonomía, esta será la primera categoría.
item_category2 string No Adultos La jerarquía de segunda categoría o la taxonomía adicional del artículo
item_category3 string No Camisas La jerarquía de tercera categoría o la taxonomía adicional del artículo
item_category4 string No Equipo de rodaje La jerarquía de cuarta categoría o la taxonomía adicional del artículo
item_category5 string No Manga corta La jerarquía de quinta categoría o la 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 establece, se ignora item_list_id a nivel del evento.
Si no se establece, se usa 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 establece, se ignora item_list_name a nivel del evento.
Si no se establece, se usa 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 Place de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de Place de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: "location id" solo está disponible en el alcance del artículo.
price number No 10.01 Es el precio de la unidad monetaria 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 la capa de datos (Nombre: nombre de la variable de capa de datos):
    • Elementos de comercio electrónico: ecommerce.items
    • Valor de comercio electrónico: ecommerce.value
    • Moneda de comercio electrónico: ecommerce.currency
  • Parámetros del evento (nombre del parámetro - valor):
    • items: &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • value: &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency: &lbrace;&lbrace;Ecommerce Currency&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,
      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, puedes enviar este evento cuando un usuario ve 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 - 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 - 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 - 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 artículo.
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 artículo.
items Array<Item> Sí* Los artículos del evento.

* Se espera que el array items tenga un solo elemento que represente el elemento seleccionado. Si se proporcionan varios elementos, solo se usará el primero en 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 una 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 en el alcance del artículo.
coupon string No SUMMER_FUN Indica 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o una taxonomía, esta será la primera categoría.
item_category2 string No Adultos La jerarquía de segunda categoría o la taxonomía adicional del artículo
item_category3 string No Camisas La jerarquía de tercera categoría o la taxonomía adicional del artículo
item_category4 string No Equipo de rodaje La jerarquía de cuarta categoría o la taxonomía adicional del artículo
item_category5 string No Manga corta La jerarquía de quinta categoría o la 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 establece, se ignora item_list_id a nivel del evento.
Si no se establece, se usa 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 establece, se ignora item_list_name a nivel del evento.
Si no se establece, se usa 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 Place de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de Place de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: "location id" solo está disponible en el alcance del artículo.
price number No 10.01 Es el precio de la unidad monetaria 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 la capa de datos (Nombre: nombre de la variable de capa de datos):
    • Elementos 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 - valor):
    • items: &lbrace;&lbrace;Ecommerce Items&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,
      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 artículo.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad de promoción asociado con el evento.

Se ignora si se establece a nivel del artículo.
promotion_id string No P_12345 Es el ID de la promoción asociada con el evento.

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

Se ignora si se establece a nivel del artículo.
items Array<Item> No Los artículos 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 una 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 en el alcance del artículo.
coupon string No SUMMER_FUN Indica 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 establece, se ignora creative_name a nivel del evento.
Si no se establece, se usa 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 con el artículo.

Si se establece, se ignora creative_slot a nivel del evento.
Si no se establece, se usa 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o una taxonomía, esta será la primera categoría.
item_category2 string No Adultos La jerarquía de segunda categoría o la taxonomía adicional del artículo
item_category3 string No Camisas La jerarquía de tercera categoría o la taxonomía adicional del artículo
item_category4 string No Equipo de rodaje La jerarquía de cuarta categoría o la taxonomía adicional del artículo
item_category5 string No Manga corta La jerarquía de quinta categoría o la 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 establece, se ignora item_list_id a nivel del evento.
Si no se establece, se usa 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 establece, se ignora item_list_name a nivel del evento.
Si no se establece, se usa 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 Place de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de Place de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: "location id" solo está disponible en el alcance del artículo.
price number No 10.01 Es el precio de la unidad monetaria 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 con el artículo.

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

Si se establece, se ignora promotion_name a nivel del evento.
Si no se establece, se usa 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 la capa de datos (Nombre: nombre de la variable de capa de datos):
    • Nombre de la creatividad de comercio electrónico: ecommerce.creative_name
    • Ranura de creatividad 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
    • Elementos de comercio electrónico: ecommerce.items
  • Parámetros del evento (nombre del parámetro - valor):
    • creative_name: &lbrace;&lbrace;Nombre de la creatividad de comercio electrónico&rbrace;&rbrace;
    • creative_slot: &lbrace;&lbrace;Ecommerce Creative Slot&rbrace;&rbrace;
    • promotion_id: &lbrace;&lbrace;Ecommerce Promotion ID&rbrace;&rbrace;
    • promotion_name: &lbrace;&lbrace;Nombre de la promoción de comercio electrónico&rbrace;&rbrace;
    • items: &lbrace;&lbrace;Ecommerce Items&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,
      quantity: 3
    }
    ]
  }
});

share

Usa este evento cuando un usuario comparte 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 - 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 - 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 usa para registrarse.

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 - valor):
    • method: Google
  • Se activa cuando un usuario se registra para obtener una cuenta.

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 - 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 - valor):
    • value - 5
    • virtual_currency_name: Gemas
    • item_name: Activador de inicio
  • Se activa cuando alguien compra un bien virtual

tutorial_begin

Este evento indica el inicio del proceso de integració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ó el proceso de integració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 desbloquee un logro. Este evento puede ayudarte a comprender cómo experimentan tu juego los usuarios.

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 - valor):
    • achievement_id: A_12345
  • Se activa cuando un usuario desbloquea 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 Es la moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras.

Métricas de valor en el evento view_item para que no contribuyan a los ingresos

* Si estableces value, debes establecer 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 un evento clave, te recomendamos que configures value.
* currency es obligatorio si configuras value.
items Array<Item> Sí Los artículos 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 una 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 en el alcance del artículo.
coupon string No SUMMER_FUN Indica 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o una taxonomía, esta será la primera categoría.
item_category2 string No Adultos La jerarquía de segunda categoría o la taxonomía adicional del artículo
item_category3 string No Camisas La jerarquía de tercera categoría o la taxonomía adicional del artículo
item_category4 string No Equipo de rodaje La jerarquía de cuarta categoría o la taxonomía adicional del artículo
item_category5 string No Manga corta La jerarquía de quinta categoría o la 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 establece, se ignora item_list_id a nivel del evento.
Si no se establece, se usa 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 establece, se ignora item_list_name a nivel del evento.
Si no se establece, se usa 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 Place de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de Place de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: "location id" solo está disponible en el alcance del artículo.
price number No 10.01 Es el precio de la unidad monetaria 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 la capa de datos (Nombre: nombre de la variable de capa de datos):
    • Elementos de comercio electrónico: ecommerce.items
    • Valor de comercio electrónico: ecommerce.value
    • Moneda de comercio electrónico: ecommerce.currency
  • Parámetros del evento (nombre del parámetro - valor):
    • items: &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • value: &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency: &lbrace;&lbrace;Ecommerce Currency&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,
      quantity: 3
    }
    ]
  }
});

view_item

Este evento indica que se le 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 Es la moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras.

Métricas de valor en el evento view_item para que no contribuyan a los ingresos

* Si estableces value, debes establecer 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 un evento clave, te recomendamos que configures value.
* currency es obligatorio si configuras value.
items Array<Item> Sí Los artículos 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 una 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 en el alcance del artículo.
coupon string No SUMMER_FUN Indica 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o una taxonomía, esta será la primera categoría.
item_category2 string No Adultos La jerarquía de segunda categoría o la taxonomía adicional del artículo
item_category3 string No Camisas La jerarquía de tercera categoría o la taxonomía adicional del artículo
item_category4 string No Equipo de rodaje La jerarquía de cuarta categoría o la taxonomía adicional del artículo
item_category5 string No Manga corta La jerarquía de quinta categoría o la 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 establece, se ignora item_list_id a nivel del evento.
Si no se establece, se usa 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 establece, se ignora item_list_name a nivel del evento.
Si no se establece, se usa 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 Place de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de Place de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: "location id" solo está disponible en el alcance del artículo.
price number No 10.01 Es el precio de la unidad monetaria 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 la capa de datos (Nombre: nombre de la variable de capa de datos):
    • Elementos de comercio electrónico: ecommerce.items
    • Valor de comercio electrónico: ecommerce.value
    • Moneda de comercio electrónico: ecommerce.currency
  • Parámetros del evento (nombre del parámetro - valor):
    • items: &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • value: &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency: &lbrace;&lbrace;Ecommerce Currency&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,
      quantity: 3
    }
    ]
  }
});

view_item_list

Registra este evento cuando se le presente al usuario una lista de artículos de una categoría determinada.

Parámetros

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

Métricas de valor en el evento view_item para que no contribuyan a los ingresos

* Si estableces value, debes establecer 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 artículo.
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 artículo.
items Array<Item> Sí Los artículos 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 una 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 en el alcance del artículo.
coupon string No SUMMER_FUN Indica 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o una taxonomía, esta será la primera categoría.
item_category2 string No Adultos La jerarquía de segunda categoría o la taxonomía adicional del artículo
item_category3 string No Camisas La jerarquía de tercera categoría o la taxonomía adicional del artículo
item_category4 string No Equipo de rodaje La jerarquía de cuarta categoría o la taxonomía adicional del artículo
item_category5 string No Manga corta La jerarquía de quinta categoría o la 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 establece, se ignora item_list_id a nivel del evento.
Si no se establece, se usa 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 establece, se ignora item_list_name a nivel del evento.
Si no se establece, se usa 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 Place de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de Place de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: "location id" solo está disponible en el alcance del artículo.
price number No 10.01 Es el precio de la unidad monetaria 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 la capa de datos (Nombre: nombre de la variable de capa de datos):
    • Elementos 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 - valor):
    • items: &lbrace;&lbrace;Ecommerce Items&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,
      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
    }]
  }
});

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 artículo.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad de promoción asociado con el evento.

Se ignora si se establece a nivel del artículo.
promotion_id string No P_12345 Es el ID de la promoción asociada con el evento.

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

Se ignora si se establece a nivel del artículo.
items Array<Item> Sí* Los artículos del evento.

* Se espera que el array items tenga un solo elemento que represente el artículo asociado con la promoción. Si se proporcionan varios elementos, solo se usará el primero en 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 una 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 en el alcance del artículo.
coupon string No SUMMER_FUN Indica 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 establece, se ignora creative_name a nivel del evento.
Si no se establece, se usa 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 con el artículo.

Si se establece, se ignora creative_slot a nivel del evento.
Si no se establece, se usa 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o una taxonomía, esta será la primera categoría.
item_category2 string No Adultos La jerarquía de segunda categoría o la taxonomía adicional del artículo
item_category3 string No Camisas La jerarquía de tercera categoría o la taxonomía adicional del artículo
item_category4 string No Equipo de rodaje La jerarquía de cuarta categoría o la taxonomía adicional del artículo
item_category5 string No Manga corta La jerarquía de quinta categoría o la 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 establece, se ignora item_list_id a nivel del evento.
Si no se establece, se usa 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 establece, se ignora item_list_name a nivel del evento.
Si no se establece, se usa 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 Place de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de Place de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: "location id" solo está disponible en el alcance del artículo.
price number No 10.01 Es el precio de la unidad monetaria 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 con el artículo.

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

Si se establece, se ignora promotion_name a nivel del evento.
Si no se establece, se usa 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 la capa de datos (Nombre: nombre de la variable de capa de datos):
    • Nombre de la creatividad de comercio electrónico: ecommerce.creative_name
    • Ranura de creatividad 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
    • Elementos de comercio electrónico: ecommerce.items
  • Parámetros del evento (nombre del parámetro - valor):
    • creative_name: &lbrace;&lbrace;Nombre de la creatividad de comercio electrónico&rbrace;&rbrace;
    • creative_slot: &lbrace;&lbrace;Ecommerce Creative Slot&rbrace;&rbrace;
    • promotion_id: &lbrace;&lbrace;Ecommerce Promotion ID&rbrace;&rbrace;
    • promotion_name: &lbrace;&lbrace;Nombre de la promoción de comercio electrónico&rbrace;&rbrace;
    • items: &lbrace;&lbrace;Ecommerce Items&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,
      quantity: 3
    }
    ]
  }
});

working_lead

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

Parámetros

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

* Si estableces value, debes establecer 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 un evento clave, te recomendamos que configures 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 - valor):
    • currency: USD
    • value - 30.03
    • lead_status: Conversaciones iniciadas
  • Activa el evento cuando un usuario se comunica con un representante o cuando un representante se comunica con un usuario.