Eventos recomendados

Estos eventos te permiten medir funciones y comportamientos adicionales, y generar más informes útiles en Google Analytics 4. Dado que estos eventos requieren contexto para que sean significativos, no se envían automáticamente. Usa este documento para consulta los parámetros obligatorios y los opcionales para cada evento.

add_payment_info

Este evento significa que un usuario envió su información de pago en una 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 Moneda de los artículos asociados con el evento, en 3 letras ISO 4217.

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

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

Los parámetros coupon a nivel del evento y del elemento se de forma independiente.
payment_type string No Credit Card Indica la forma de pago elegida.
items Array<Item> Sí Los elementos del evento.

Parámetros de elementos

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

Se trata del ID del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

item_name string Sí* Camiseta de Stan y sus amigos

Se trata del nombre del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

affiliation string No Google Store Afiliación de un producto para designar una empresa proveedora o una tienda en la ubicación de la tienda física.
Nota: La "afiliación" 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 elemento se de forma independiente.
creative_name string No summer_banner2 Es el nombre de la creatividad promocional.

Si se establece, se ignorará creative_name a nivel del evento.
Si no se establece, se usa creative_name a nivel del evento si presente.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad promocional asociado con el elemento.

Si se establece, se ignorará creative_slot a nivel del evento.
Si no se establece, se usa creative_slot a nivel del evento si presente.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 El índice/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 usan como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
item_category2 string No Adultos Es 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 Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
item_category5 string No Manga corta Es 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 ignorará item_list_id a nivel del evento.
Si no se establece, se usa item_list_id a nivel del evento si 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 ignorará item_list_name a nivel del evento.
Si no se establece, se usa item_list_name a nivel del evento si presente.
item_variant string No verde La variante o el código único del artículo, o la descripción del artículo adicional detalles/opciones.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco) Indica la ubicación física asociada con el artículo (p. ej., la ubicación física). ubicación de la tienda). Se recomienda usar la Google ID de lugar correspondiente al elemento asociado. Una ubicación personalizada con tu ID.
Nota: El ID de ubicación solo está disponible en el alcance del artículo.
price number No 10:01 Es el precio unitario monetario del artículo, expresado en unidades de la moneda especificada. parámetro.
Si se aplica un descuento al elemento, establece price en el precio unitario con descuento y especifica el descuento de precio por unidad 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 ignorará promotion_id a nivel del evento.
Si no se establece, se usa promotion_id a nivel del evento si presente.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada con el artículo.

Si se establece, se ignorará promotion_name a nivel del evento.
Si no se establece, se usa promotion_name a nivel del evento si 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 hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para las implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: evento de GA4
  • Nombre del evento: add_payment_info
  • Variables de capa de datos (nombre - nombre de variable de capa de datos):
    • Artículos 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 de 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;
    • payment_type - &lbrace;&lbrace;Tipo de pago de comercio electrónico&rbrace;
  • Activador: 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 significa 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 Moneda de los artículos asociados con el evento, en 3 letras ISO 4217.

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

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

Los parámetros coupon a nivel del evento y del elemento se de forma independiente.
shipping_tier string No Suelo El nivel de envío (p.ej., Ground, Air, Next-day) seleccionado para la entrega del artículo comprado.
items Array<Item> Sí Los elementos del evento.

Parámetros de elementos

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

Se trata del ID del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

item_name string Sí* Camiseta de Stan y sus amigos

Se trata del nombre del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

affiliation string No Google Store Afiliación de un producto para designar una empresa proveedora o una tienda en la ubicación de la tienda física.
Nota: La "afiliación" 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 elemento se de forma independiente.
creative_name string No summer_banner2 Es el nombre de la creatividad promocional.

Si se establece, se ignorará creative_name a nivel del evento.
Si no se establece, se usa creative_name a nivel del evento si presente.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad promocional asociado con el elemento.

Si se establece, se ignorará creative_slot a nivel del evento.
Si no se establece, se usa creative_slot a nivel del evento si presente.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 El índice/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 usan como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
item_category2 string No Adultos Es 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 Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
item_category5 string No Manga corta Es 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 ignorará item_list_id a nivel del evento.
Si no se establece, se usa item_list_id a nivel del evento si 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 ignorará item_list_name a nivel del evento.
Si no se establece, se usa item_list_name a nivel del evento si presente.
item_variant string No verde La variante o el código único del artículo, o la descripción del artículo adicional detalles/opciones.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco) Indica la ubicación física asociada con el artículo (p. ej., la ubicación física). ubicación de la tienda). Se recomienda usar la Google ID de lugar correspondiente al elemento asociado. Una ubicación personalizada con tu ID.
Nota: El ID de ubicación solo está disponible en el alcance del artículo.
price number No 10:01 Es el precio unitario monetario del artículo, expresado en unidades de la moneda especificada. parámetro.
Si se aplica un descuento al elemento, establece price en el precio unitario con descuento y especifica el descuento de precio por unidad 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 ignorará promotion_id a nivel del evento.
Si no se establece, se usa promotion_id a nivel del evento si presente.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada con el artículo.

Si se establece, se ignorará promotion_name a nivel del evento.
Si no se establece, se usa promotion_name a nivel del evento si 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 hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para las implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: evento de GA4
  • Nombre del evento: add_shipping_info
  • Variables de capa de datos (nombre - nombre de variable de capa de datos):
    • Artículos 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 de 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;
    • shipping_tier - &lbrace;&lbrace;Nivel de envío de comercio electrónico&rbrace;
  • Activador: 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 significa 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 Moneda de los artículos asociados con el evento, en 3 letras ISO 4217.

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

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

Parámetros de elementos

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

Se trata del ID del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

item_name string Sí* Camiseta de Stan y sus amigos

Se trata del nombre del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

affiliation string No Google Store Afiliación de un producto para designar una empresa proveedora o una tienda en la ubicación de la tienda física.
Nota: La "afiliación" 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 elemento se de forma independiente.
creative_name string No summer_banner2 Es el nombre de la creatividad promocional.

Si se establece, se ignorará creative_name a nivel del evento.
Si no se establece, se usa creative_name a nivel del evento si presente.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad promocional asociado con el elemento.

Si se establece, se ignorará creative_slot a nivel del evento.
Si no se establece, se usa creative_slot a nivel del evento si presente.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 El índice/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 usan como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
item_category2 string No Adultos Es 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 Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
item_category5 string No Manga corta Es 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 ignorará item_list_id a nivel del evento.
Si no se establece, se usa item_list_id a nivel del evento si 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 ignorará item_list_name a nivel del evento.
Si no se establece, se usa item_list_name a nivel del evento si presente.
item_variant string No verde La variante o el código único del artículo, o la descripción del artículo adicional detalles/opciones.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco) Indica la ubicación física asociada con el artículo (p. ej., la ubicación física). ubicación de la tienda). Se recomienda usar la Google ID de lugar correspondiente al elemento asociado. Una ubicación personalizada con tu ID.
Nota: El ID de ubicación solo está disponible en el alcance del artículo.
price number No 10:01 Es el precio unitario monetario del artículo, expresado en unidades de la moneda especificada. parámetro.
Si se aplica un descuento al elemento, establece price en el precio unitario con descuento y especifica el descuento de precio por unidad 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 ignorará promotion_id a nivel del evento.
Si no se establece, se usa promotion_id a nivel del evento si presente.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada con el artículo.

Si se establece, se ignorará promotion_name a nivel del evento.
Si no se establece, se usa promotion_name a nivel del evento si 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 hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para las implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: evento de GA4
  • Nombre del evento: add_to_cart
  • Variables de capa de datos (nombre - nombre de variable de capa de datos):
    • Artículos de comercio electrónico: ecommerce.items
    • Valor de comercio electrónico: ecommerce.value
    • Moneda de comercio electrónico: ecommerce.currency
  • Parámetros de 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: 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 significa que se agregó un artículo a una lista de deseos. Usa este evento para identificar artículos de regalo populares en tu aplicación.

Parámetros

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

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

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

Parámetros de elementos

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

Se trata del ID del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

item_name string Sí* Camiseta de Stan y sus amigos

Se trata del nombre del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

affiliation string No Google Store Afiliación de un producto para designar una empresa proveedora o una tienda en la ubicación de la tienda física.
Nota: La "afiliación" 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 elemento se de forma independiente.
creative_name string No summer_banner2 Es el nombre de la creatividad promocional.

Si se establece, se ignorará creative_name a nivel del evento.
Si no se establece, se usa creative_name a nivel del evento si presente.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad promocional asociado con el elemento.

Si se establece, se ignorará creative_slot a nivel del evento.
Si no se establece, se usa creative_slot a nivel del evento si presente.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 El índice/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 usan como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
item_category2 string No Adultos Es 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 Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
item_category5 string No Manga corta Es 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 ignorará item_list_id a nivel del evento.
Si no se establece, se usa item_list_id a nivel del evento si 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 ignorará item_list_name a nivel del evento.
Si no se establece, se usa item_list_name a nivel del evento si presente.
item_variant string No verde La variante o el código único del artículo, o la descripción del artículo adicional detalles/opciones.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco) Es la ubicación física asociada con el artículo (p. ej., la ubicación física). ubicación de la tienda). Se recomienda usar la Google ID de lugar correspondiente al elemento asociado. Una ubicación personalizada con tu ID.
Nota: El ID de ubicación solo está disponible en el alcance del artículo.
price number No 10:01 Es el precio unitario monetario del artículo, expresado en unidades de la moneda especificada. parámetro.
Si se aplica un descuento al elemento, establece price en el precio unitario con descuento y especifica el descuento de precio por unidad 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 ignorará promotion_id a nivel del evento.
Si no se establece, se usa promotion_id a nivel del evento si presente.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada con el artículo.

Si se establece, se ignorará promotion_name a nivel del evento.
Si no se establece, se usa promotion_name a nivel del evento si 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 hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para las implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: evento de GA4
  • Nombre del evento: add_to_wishlist
  • Variables de capa de datos (nombre - nombre de variable de capa de datos):
    • Artículos de comercio electrónico: ecommerce.items
    • Valor de comercio electrónico: ecommerce.value
    • Moneda de comercio electrónico: ecommerce.currency
  • Parámetros de 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: 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 inició la confirmación de la compra.

Parámetros

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

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

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

Los parámetros coupon a nivel del evento y del elemento se de forma independiente.
items Array<Item> Sí Los elementos del evento.

Parámetros de elementos

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

Se trata del ID del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

item_name string Sí* Camiseta de Stan y sus amigos

Se trata del nombre del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

affiliation string No Google Store Afiliación de un producto para designar una empresa proveedora o una tienda en la ubicación de la tienda física.
Nota: La "afiliación" 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 elemento se de forma independiente.
creative_name string No summer_banner2 Es el nombre de la creatividad promocional.

Si se establece, se ignorará creative_name a nivel del evento.
Si no se establece, se usa creative_name a nivel del evento si presente.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad promocional asociado con el elemento.

Si se establece, se ignorará creative_slot a nivel del evento.
Si no se establece, se usa creative_slot a nivel del evento si presente.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 El índice/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 usan como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
item_category2 string No Adultos Es 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 Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
item_category5 string No Manga corta Es 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 ignorará item_list_id a nivel del evento.
Si no se establece, se usa item_list_id a nivel del evento si 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 ignorará item_list_name a nivel del evento.
Si no se establece, se usa item_list_name a nivel del evento si presente.
item_variant string No verde La variante o el código único del artículo, o la descripción del artículo adicional detalles/opciones.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco) Es la ubicación física asociada con el artículo (p. ej., la ubicación física). ubicación de la tienda). Se recomienda usar la Google ID de lugar correspondiente al elemento asociado. Una ubicación personalizada con tu ID.
Nota: El ID de ubicación solo está disponible en el alcance del artículo.
price number No 10:01 Es el precio unitario monetario del artículo, expresado en unidades de la moneda especificada. parámetro.
Si se aplica un descuento al elemento, establece price en el precio unitario con descuento y especifica el descuento de precio por unidad 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 ignorará promotion_id a nivel del evento.
Si no se establece, se usa promotion_id a nivel del evento si presente.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada con el artículo.

Si se establece, se ignorará promotion_name a nivel del evento.
Si no se establece, se usa promotion_name a nivel del evento si 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 hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para las implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: evento de GA4
  • Nombre del evento: begin_checkout
  • Variables de capa de datos (nombre - nombre de variable de capa de datos):
    • Artículos 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 de 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;
  • Activador: evento equals started_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 un cliente potencial se convierte y se cierra (por ejemplo, a través de una compra).

Parámetros

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

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

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

Ejemplo

El siguiente ejemplo es para las 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 de evento (nombre del parámetro, valor):
    • currency: USD
    • value al 30.03
  • Activa el evento cuando el usuario se convierta en un cliente potencial que generó una conversión (un cliente).

close_unconvert_lead

Este evento mide cuando se marca a un usuario como un cliente potencial que no generó una conversión junto con el motivo.

Parámetros

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

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

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

Ejemplo

El siguiente ejemplo es para las 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 de evento (nombre del parámetro, valor):
    • currency: USD
    • value al 30.03
  • Activa el evento cuando se marca que un usuario no se convierte en un cliente potencial que generó una conversión por uno de varios motivos

disqualify_lead

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

Parámetros

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

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

* Por lo general, se requieren value para generar informes significativos. Si marcas el evento como un evento clave, se recomienda que establezcas value
* currency es obligatorio si configuras value.
disqualified_lead_reason string No No quiero hacer una compra El motivo por el que se marcó a un cliente potencial como descalificado.

Ejemplo

El siguiente ejemplo es para las 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 de evento (nombre del parámetro, valor):
    • currency: USD
    • value al 30.03
    • disqualified_lead_reason - No deseo realizar una compra
  • Activa el evento cuando se marca a un usuario como descalificado para convertirse en cliente potencial por uno de varios motivos

earn_virtual_currency

Este evento mide cuando un usuario obtiene moneda virtual en un juego. Regístralo junto con spend_virtual_currency para comprender mejor tu la 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 Indica el valor de la moneda virtual.

Ejemplo

El siguiente ejemplo es para las 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 de evento (nombre del parámetro, valor):
    • virtual_currency_name - Gemas
    • De value a 5
  • Activa el evento cuando se le otorgue moneda virtual a alguien

generate_lead

Este evento mide cuándo se generó un cliente potencial (por ejemplo, a través de un formulario). Regístralos para comprender la eficacia de tus campañas de marketing y ¿Cuántos clientes vuelven a interactuar con su empresa después de utilizar el remarketing clientes.

Parámetros

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

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

* Por lo general, se requieren value para generar informes significativos. Si marcas el evento como un evento clave, se recomienda que establezcas value
* currency es obligatorio si configuras value.
lead_source string No Feria Indica la fuente del cliente potencial.

Ejemplo

El siguiente ejemplo es para las 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 de evento (nombre del parámetro, valor):
    • currency: USD
    • value al 30.03
    • lead_source: Feria comercial
  • Activa el evento cuando se genere un cliente potencial.

join_group

Registra este evento cuando un usuario se una a un grupo, como un gremio, un equipo o una familia. Usa este evento para analizar la popularidad de ciertos grupos o funciones 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 las 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 de evento (nombre del parámetro, valor):
    • group_id: G_12345
  • Activa el evento cuando un usuario se una a un grupo

level_end

Este evento significa que un jugador alcanzó el final de un nivel en un juego.

Parámetros

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

Ejemplo

El siguiente ejemplo es para las 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 de evento (nombre del parámetro, valor):
    • level_name - El viaje comienza...
    • Success - true
  • Se activa cuando un jugador llega al final de un nivel (p. ej., en la página de confirmación del nivel).

level_start

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

Parámetros

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

Ejemplo

El siguiente ejemplo es para las 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 de evento (nombre del parámetro, valor):
    • level_name - El viaje comienza...
  • Se activa cuando alguien comienza un nivel nuevo (p.ej., la página de inicio del nivel)

level_up

Este evento significa que un jugador subió de nivel en un juego. Úsalo para medir el de tu base de usuarios e identificar niveles difíciles de que se completó.

Parámetros

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

Ejemplo

El siguiente ejemplo es para las 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 de evento (nombre del parámetro, valor):
    • De level a 5
    • character: Jugador 1
  • Se activa cuando un jugador sube de nivel

acceder

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 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 de evento (nombre del parámetro, valor):
    • method: Google
  • Se activa cuando un usuario accede

post_score

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

Parámetros

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

Ejemplo

El siguiente ejemplo es para las 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 de evento (nombre del parámetro, valor):
    • score-10,000
    • De level a 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 Moneda de los artículos asociados con el evento, en 3 letras ISO 4217.

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

* Establece value como la suma de (price * quantity) para todos los elementos de items No incluyas shipping ni tax.
* Por lo general, se requieren value para generar informes significativos. Si marcas el evento como un evento clave, se recomienda que establezcas 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 elemento se de forma independiente.
shipping number No 3.33 Indica el costo de envío asociado a una transacción.
tax number No 1.11 Es el costo de impuestos asociado con una transacción.
items Array<Item> Sí Los elementos del evento.

Parámetros de elementos

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

Se trata del ID del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

item_name string Sí* Camiseta de Stan y sus amigos

Se trata del nombre del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

affiliation string No Google Store Afiliación de un producto para designar una empresa proveedora o una tienda en la ubicación de la tienda física.
Nota: La "afiliación" 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 elemento se de forma independiente.
creative_name string No summer_banner2 Es el nombre de la creatividad promocional.

Si se establece, se ignorará creative_name a nivel del evento.
Si no se establece, se usa creative_name a nivel del evento si presente.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad promocional asociado con el elemento.

Si se establece, se ignorará creative_slot a nivel del evento.
Si no se establece, se usa creative_slot a nivel del evento si presente.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 El índice/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 usan como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
item_category2 string No Adultos Es 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 Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
item_category5 string No Manga corta Es 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 ignorará item_list_id a nivel del evento.
Si no se establece, se usa item_list_id a nivel del evento si 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 ignorará item_list_name a nivel del evento.
Si no se establece, se usa item_list_name a nivel del evento si presente.
item_variant string No verde La variante o el código único del artículo, o la descripción del artículo adicional detalles/opciones.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco) Indica la ubicación física asociada con el artículo (p. ej., la ubicación física). ubicación de la tienda). Se recomienda usar la Google ID de lugar correspondiente al elemento asociado. Una ubicación personalizada con tu ID.
Nota: El ID de ubicación solo está disponible en el alcance del artículo.
price number No 10:01 Es el precio unitario monetario del artículo, expresado en unidades de la moneda especificada. parámetro.
Si se aplica un descuento al elemento, establece price en el precio unitario con descuento y especifica el descuento de precio por unidad 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 ignorará promotion_id a nivel del evento.
Si no se establece, se usa promotion_id a nivel del evento si presente.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada con el artículo.

Si se establece, se ignorará promotion_name a nivel del evento.
Si no se establece, se usa promotion_name a nivel del evento si 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 hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para las implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: evento de GA4
  • Nombre del evento: purchase
    • Artículos de comercio electrónico: ecommerce.items
    • ID de transacción de comercio electrónico: ecommerce.transaction_id
    • Valor de comercio electrónico: ecommerce.value
    • Impuesto sobre el 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 de 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;
    • value - &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • tax - &lbrace;&lbrace;Impuesto de comercio electrónico&rbrace;
    • shipping - &lbrace;&lbrace;Envío de comercio electrónico&rbrace;
    • currency - &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;Cupón de comercio electrónico&rbrace;
  • Activador: evento equivale a compra

Configuración del activador:

  • Tipo de activador: Evento personalizado
  • Nombre del evento: purchase
  • Este activador se activa en todos los eventos personalizados
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "purchase",
  ecommerce: {
    transaction_id: "T_12345",
    // Sum of (price * quantity) for all items.
    value: 72.05,
    tax: 3.60,
    shipping: 5.99,
    currency: "USD",
    coupon: "SUMMER_SALE",
    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 cliente potencial calificado.

Parámetros

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

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

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

Ejemplo

El siguiente ejemplo es para las 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 de evento (nombre del parámetro, valor):
    • currency: USD
    • value al 30.03
  • Activa el evento cuando se marque que un usuario cumple con los criterios para convertirse en cliente potencial calificado

refund

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

Parámetros

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

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

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

Los parámetros coupon a nivel del evento y del elemento se de forma independiente.
shipping number No 3.33 Indica el costo de envío asociado a una transacción.
tax number No 1.11 Es el costo de impuestos asociado con una transacción.
items Array<Item> No* Los elementos del evento.

Parámetros de elementos

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

Se trata del ID del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

item_name string Sí* Camiseta de Stan y sus amigos

Se trata del nombre del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

affiliation string No Google Store Afiliación de un producto para designar una empresa proveedora o una tienda en la ubicación de la tienda física.
Nota: La "afiliación" 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 elemento se de forma independiente.
creative_name string No summer_banner2 Es el nombre de la creatividad promocional.

Si se establece, se ignorará creative_name a nivel del evento.
Si no se establece, se usa creative_name a nivel del evento si presente.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad promocional asociado con el elemento.

Si se establece, se ignorará creative_slot a nivel del evento.
Si no se establece, se usa creative_slot a nivel del evento si presente.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 El índice/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 usan como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
item_category2 string No Adultos Es 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 Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
item_category5 string No Manga corta Es 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 ignorará item_list_id a nivel del evento.
Si no se establece, se usa item_list_id a nivel del evento si 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 ignorará item_list_name a nivel del evento.
Si no se establece, se usa item_list_name a nivel del evento si presente.
item_variant string No verde La variante o el código único del artículo, o la descripción del artículo adicional detalles/opciones.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco) Indica la ubicación física asociada con el artículo (p. ej., la ubicación física). ubicación de la tienda). Se recomienda usar la Google ID de lugar correspondiente al elemento asociado. Una ubicación personalizada con tu ID.
Nota: El ID de ubicación solo está disponible en el alcance del artículo.
price number No 10:01 Es el precio unitario monetario del artículo, expresado en unidades de la moneda especificada. parámetro.
Si se aplica un descuento al elemento, establece price en el precio unitario con descuento y especifica el descuento de precio por unidad 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 ignorará promotion_id a nivel del evento.
Si no se establece, se usa promotion_id a nivel del evento si presente.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada con el artículo.

Si se establece, se ignorará promotion_name a nivel del evento.
Si no se establece, se usa promotion_name a nivel del evento si 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 hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para las implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: evento de GA4
  • Nombre del evento: refund
  • Variables de capa de datos (nombre - nombre de variable de capa de datos):
    • Artículos de comercio electrónico: ecommerce.items
    • ID de transacción de comercio electrónico: ecommerce.transaction_id
    • Valor de comercio electrónico: ecommerce.value
    • Impuesto sobre el 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 de 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;
    • value - &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • tax - &lbrace;&lbrace;Impuesto de comercio electrónico&rbrace;
    • shipping - &lbrace;&lbrace;Envío de comercio electrónico&rbrace;
    • currency - &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;Cupón de comercio electrónico&rbrace;
  • Activador: evento equivale a reembolso

Configuración del activador:

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

remove_from_cart

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

Parámetros

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

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

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

Parámetros de elementos

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

Se trata del ID del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

item_name string Sí* Camiseta de Stan y sus amigos

Se trata del nombre del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

affiliation string No Google Store Afiliación de un producto para designar una empresa proveedora o una tienda en la ubicación de la tienda física.
Nota: La "afiliación" 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 elemento se de forma independiente.
creative_name string No summer_banner2 Es el nombre de la creatividad promocional.

Si se establece, se ignorará creative_name a nivel del evento.
Si no se establece, se usa creative_name a nivel del evento si presente.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad promocional asociado con el elemento.

Si se establece, se ignorará creative_slot a nivel del evento.
Si no se establece, se usa creative_slot a nivel del evento si presente.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 El índice/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 usan como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
item_category2 string No Adultos Es 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 Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
item_category5 string No Manga corta Es 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 ignorará item_list_id a nivel del evento.
Si no se establece, se usa item_list_id a nivel del evento si 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 ignorará item_list_name a nivel del evento.
Si no se establece, se usa item_list_name a nivel del evento si presente.
item_variant string No verde La variante o el código único del artículo, o la descripción del artículo adicional detalles/opciones.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco) Indica la ubicación física asociada con el artículo (p. ej., la ubicación física). ubicación de la tienda). Se recomienda usar la Google ID de lugar correspondiente al elemento asociado. Una ubicación personalizada con tu ID.
Nota: El ID de ubicación solo está disponible en el alcance del artículo.
price number No 10:01 Es el precio unitario monetario del artículo, expresado en unidades de la moneda especificada. parámetro.
Si se aplica un descuento al elemento, establece price en el precio unitario con descuento y especifica el descuento de precio por unidad 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 ignorará promotion_id a nivel del evento.
Si no se establece, se usa promotion_id a nivel del evento si presente.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada con el artículo.

Si se establece, se ignorará promotion_name a nivel del evento.
Si no se establece, se usa promotion_name a nivel del evento si 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 hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para las implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: evento de GA4
  • Nombre del evento: remove_from_cart
  • Variables de capa de datos (nombre - nombre de variable de capa de datos):
    • Artículos de comercio electrónico: ecommerce.items
    • Valor de comercio electrónico: ecommerce.value
    • Moneda de comercio electrónico: ecommerce.currency
  • Parámetros de 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: 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. Para Por ejemplo, podrías 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ó.

Ejemplo

El siguiente ejemplo es para las 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 de evento (nombre del parámetro, valor):
    • search_term - camisetas
  • Se activan cuando un usuario realiza una búsqueda en tu sitio web.

select_content

Este evento significa que un usuario seleccionó cierto tipo de contenido. Este evento puede ayudarte a identificar contenido popular y categorías de contenido 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 Un identificador para el contenido que se seleccionó.

Ejemplo

El siguiente ejemplo es para las 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 de 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 significa que se seleccionó un elemento de una lista.

Parámetros

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

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

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

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

Parámetros de elementos

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

Se trata del ID del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

item_name string Sí* Camiseta de Stan y sus amigos

Se trata del nombre del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

affiliation string No Google Store Afiliación de un producto para designar una empresa proveedora o una tienda en la ubicación de la tienda física.
Nota: La "afiliación" 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 elemento se de forma independiente.
creative_name string No summer_banner2 Es el nombre de la creatividad promocional.

Si se establece, se ignorará creative_name a nivel del evento.
Si no se establece, se usa creative_name a nivel del evento si presente.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad promocional asociado con el elemento.

Si se establece, se ignorará creative_slot a nivel del evento.
Si no se establece, se usa creative_slot a nivel del evento si presente.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 El índice/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 usan como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
item_category2 string No Adultos Es 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 Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
item_category5 string No Manga corta Es 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 ignorará item_list_id a nivel del evento.
Si no se establece, se usa item_list_id a nivel del evento si 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 ignorará item_list_name a nivel del evento.
Si no se establece, se usa item_list_name a nivel del evento si presente.
item_variant string No verde La variante o el código único del artículo, o la descripción del artículo adicional detalles/opciones.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco) Indica la ubicación física asociada con el artículo (p. ej., la ubicación física). ubicación de la tienda). Se recomienda usar la Google ID de lugar correspondiente al elemento asociado. Una ubicación personalizada con tu ID.
Nota: El ID de ubicación solo está disponible en el alcance del artículo.
price number No 10:01 Es el precio unitario monetario del artículo, expresado en unidades de la moneda especificada. parámetro.
Si se aplica un descuento al elemento, establece price en el precio unitario con descuento y especifica el descuento de precio por unidad 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 ignorará promotion_id a nivel del evento.
Si no se establece, se usa promotion_id a nivel del evento si presente.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada con el artículo.

Si se establece, se ignorará promotion_name a nivel del evento.
Si no se establece, se usa promotion_name a nivel del evento si 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 hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para las implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: evento de GA4
  • Nombre del evento: select_item
  • Variables de capa de datos (nombre - nombre de variable de capa de datos):
    • Artículos de comercio electrónico: ecommerce.items
    • ID de la lista de artículos de comercio electrónico: ecommerce.item_list_id
    • Nombre de la lista de artículos de comercio electrónico: ecommerce.item_list_name
  • Parámetros de evento (nombre del parámetro, valor):
    • items - &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • item_list_id - &lbrace;&lbrace;ID de lista de artículos de comercio electrónico&rbrace;
    • item_list_name - &lbrace;&lbrace;Nombre de la lista de artículos de comercio electrónico&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 significa 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 promocional.

Se ignora si se establece a nivel del elemento.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad promocional asociado con el para cada evento.

Se ignora si se establece a nivel del elemento.
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 elemento.
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 elemento.
items Array<Item> No Los elementos del evento.

Parámetros de elementos

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

Se trata del ID del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

item_name string Sí* Camiseta de Stan y sus amigos

Se trata del nombre del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

affiliation string No Google Store Afiliación de un producto para designar una empresa proveedora o una tienda en la ubicación de la tienda física.
Nota: La "afiliación" 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 elemento se de forma independiente.
creative_name string No summer_banner2 Es el nombre de la creatividad promocional.

Si se establece, se ignorará creative_name a nivel del evento.
Si no se establece, se usa creative_name a nivel del evento si presente.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad promocional asociado con el elemento.

Si se establece, se ignorará creative_slot a nivel del evento.
Si no se establece, se usa creative_slot a nivel del evento si presente.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 El índice/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 usan como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
item_category2 string No Adultos Es 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 Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
item_category5 string No Manga corta Es 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 ignorará item_list_id a nivel del evento.
Si no se establece, se usa item_list_id a nivel del evento si 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 ignorará item_list_name a nivel del evento.
Si no se establece, se usa item_list_name a nivel del evento si presente.
item_variant string No verde La variante o el código único del artículo, o la descripción del artículo adicional detalles/opciones.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco) Indica la ubicación física asociada con el artículo (p. ej., la ubicación física). ubicación de la tienda). Se recomienda usar la Google ID de lugar correspondiente al elemento asociado. Una ubicación personalizada con tu ID.
Nota: El ID de ubicación solo está disponible en el alcance del artículo.
price number No 10:01 Es el precio unitario monetario del artículo, expresado en unidades de la moneda especificada. parámetro.
Si se aplica un descuento al elemento, establece price en el precio unitario con descuento y especifica el descuento de precio por unidad 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 ignorará promotion_id a nivel del evento.
Si no se establece, se usa promotion_id a nivel del evento si presente.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada con el artículo.

Si se establece, se ignorará promotion_name a nivel del evento.
Si no se establece, se usa promotion_name a nivel del evento si 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 hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para las implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: evento de GA4
  • Variables de capa de datos (nombre - nombre de variable de capa de datos):
    • Nombre de la creatividad de comercio electrónico: ecommerce.creative_name
    • Espacio para creatividades de comercio electrónico: ecommerce.creative_slot
    • ID de promoción de comercio electrónico: ecommerce.promotion_id
    • Nombre de la promoción de comercio electrónico: ecommerce.promotion_name
    • Artículos de comercio electrónico: ecommerce.items
  • Parámetros de evento (nombre del parámetro, valor):
    • creative_name - &lbrace;&lbrace;Nombre de la creatividad de comercio electrónico&rbrace;
    • creative_slot - &lbrace;&lbrace;Espacio de creatividad de comercio electrónico&rbrace;
    • promotion_id - &lbrace;&lbrace;ID de promoción de comercio electrónico&rbrace;
    • promotion_name - &lbrace;&lbrace;Nombre de la promoción de comercio electrónico&rbrace;
    • items - &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
  • Tipo de variable: capa de datos Variable - '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
    }
    ]
  }
});

compartir

Usa este evento cuando un usuario comparta contenido.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
method string No Twitter Es el método en 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.

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 de 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ó en una cuenta. Usa este evento para comprender los diferentes comportamientos de los usuarios que accedieron a su cuenta y los que no.

Parámetros

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

Ejemplo

El siguiente ejemplo es para las 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 de evento (nombre del parámetro, valor):
    • method: Google
  • Se activa cuando un usuario se registra en una cuenta.

spend_virtual_currency

Este evento mide la venta de bienes virtuales en tu app y te ayuda a identificar qué artículos virtuales son los más populares.

Parámetros

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

Ejemplo

El siguiente ejemplo es para las 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 de evento (nombre del parámetro, valor):
    • De value a 5
    • virtual_currency_name - Gemas
    • item_name - Refuerzo inicial
  • Se activa cuando alguien compra un artículo virtual

tutorial_begin

Este evento indica el inicio del proceso de integración. Úsalos 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 las 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 completa el proceso de integración. Usar esta en un embudo con tutorial_begin para comprender cuántos usuarios completan el .

Parámetros

No se sugiere ningún parámetro para este evento.

Ejemplo

El siguiente ejemplo es para las 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 haya desbloqueado un logro. Este evento puede ayudarte a comprender cómo experimentan los usuarios tu juego.

Parámetros

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

Ejemplo

El siguiente ejemplo es para las 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 de evento (nombre del parámetro, valor):
    • achievement_id: A_12345
  • Se activa cuando un usuario desbloquea un logro

view_cart

Este evento significa que un usuario vio su carrito.

Parámetros

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

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

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

Parámetros de elementos

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

Se trata del ID del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

item_name string Sí* Camiseta de Stan y sus amigos

Se trata del nombre del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

affiliation string No Google Store Afiliación de un producto para designar una empresa proveedora o una tienda en la ubicación de la tienda física.
Nota: La "afiliación" 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 elemento se de forma independiente.
creative_name string No summer_banner2 Es el nombre de la creatividad promocional.

Si se establece, se ignorará creative_name a nivel del evento.
Si no se establece, se usa creative_name a nivel del evento si presente.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad promocional asociado con el elemento.

Si se establece, se ignorará creative_slot a nivel del evento.
Si no se establece, se usa creative_slot a nivel del evento si presente.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 El índice/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 usan como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
item_category2 string No Adultos Es 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 Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
item_category5 string No Manga corta Es 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 ignorará item_list_id a nivel del evento.
Si no se establece, se usa item_list_id a nivel del evento si 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 ignorará item_list_name a nivel del evento.
Si no se establece, se usa item_list_name a nivel del evento si presente.
item_variant string No verde La variante o el código único del artículo, o la descripción del artículo adicional detalles/opciones.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco) Indica la ubicación física asociada con el artículo (p. ej., la ubicación física). ubicación de la tienda). Se recomienda usar la Google ID de lugar correspondiente al elemento asociado. Una ubicación personalizada con tu ID.
Nota: El ID de ubicación solo está disponible en el alcance del artículo.
price number No 10:01 Es el precio unitario monetario del artículo, expresado en unidades de la moneda especificada. parámetro.
Si se aplica un descuento al elemento, establece price en el precio unitario con descuento y especifica el descuento de precio por unidad 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 ignorará promotion_id a nivel del evento.
Si no se establece, se usa promotion_id a nivel del evento si presente.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada con el artículo.

Si se establece, se ignorará promotion_name a nivel del evento.
Si no se establece, se usa promotion_name a nivel del evento si 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 hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para las implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: evento de GA4
  • Nombre del evento: view_cart
  • Variables de capa de datos (nombre - nombre de variable de capa de datos):
    • Artículos de comercio electrónico: ecommerce.items
    • Valor de comercio electrónico: ecommerce.value
    • Moneda de comercio electrónico: ecommerce.currency
  • Parámetros de 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: 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 significa que se mostró cierto contenido al usuario. Usa este evento para descubrir los artículos más populares vistos.

Parámetros

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

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

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

Parámetros de elementos

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

Se trata del ID del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

item_name string Sí* Camiseta de Stan y sus amigos

Se trata del nombre del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

affiliation string No Google Store Afiliación de un producto para designar una empresa proveedora o una tienda en la ubicación de la tienda física.
Nota: La "afiliación" 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 elemento se de forma independiente.
creative_name string No summer_banner2 Es el nombre de la creatividad promocional.

Si se establece, se ignorará creative_name a nivel del evento.
Si no se establece, se usa creative_name a nivel del evento si presente.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad promocional asociado con el elemento.

Si se establece, se ignorará creative_slot a nivel del evento.
Si no se establece, se usa creative_slot a nivel del evento si presente.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 El índice/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 usan como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
item_category2 string No Adultos Es 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 Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
item_category5 string No Manga corta Es 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 ignorará item_list_id a nivel del evento.
Si no se establece, se usa item_list_id a nivel del evento si 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 ignorará item_list_name a nivel del evento.
Si no se establece, se usa item_list_name a nivel del evento si presente.
item_variant string No verde La variante o el código único del artículo, o la descripción del artículo adicional detalles/opciones.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco) Indica la ubicación física asociada con el artículo (p. ej., la ubicación física). ubicación de la tienda). Se recomienda usar la Google ID de lugar correspondiente al elemento asociado. Una ubicación personalizada con tu ID.
Nota: El ID de ubicación solo está disponible en el alcance del artículo.
price number No 10:01 Es el precio unitario monetario del artículo, expresado en unidades de la moneda especificada. parámetro.
Si se aplica un descuento al elemento, establece price en el precio unitario con descuento y especifica el descuento de precio por unidad 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 ignorará promotion_id a nivel del evento.
Si no se establece, se usa promotion_id a nivel del evento si presente.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada con el artículo.

Si se establece, se ignorará promotion_name a nivel del evento.
Si no se establece, se usa promotion_name a nivel del evento si 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 hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para las implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: evento de GA4
  • Nombre del evento: view_item
  • Variables de capa de datos (nombre - nombre de variable de capa de datos):
    • Artículos de comercio electrónico: ecommerce.items
    • Valor de comercio electrónico: ecommerce.value
    • Moneda de comercio electrónico: ecommerce.currency
  • Parámetros de 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: 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 elementos de un a una categoría determinada.

Parámetros

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

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

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

Parámetros de elementos

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

Se trata del ID del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

item_name string Sí* Camiseta de Stan y sus amigos

Se trata del nombre del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

affiliation string No Google Store Afiliación de un producto para designar una empresa proveedora o una tienda en la ubicación de la tienda física.
Nota: La "afiliación" 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 elemento se de forma independiente.
creative_name string No summer_banner2 Es el nombre de la creatividad promocional.

Si se establece, se ignorará creative_name a nivel del evento.
Si no se establece, se usa creative_name a nivel del evento si presente.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad promocional asociado con el elemento.

Si se establece, se ignorará creative_slot a nivel del evento.
Si no se establece, se usa creative_slot a nivel del evento si presente.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 El índice/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 usan como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
item_category2 string No Adultos Es 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 Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
item_category5 string No Manga corta Es 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 ignorará item_list_id a nivel del evento.
Si no se establece, se usa item_list_id a nivel del evento si 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 ignorará item_list_name a nivel del evento.
Si no se establece, se usa item_list_name a nivel del evento si presente.
item_variant string No verde La variante o el código único del artículo, o la descripción del artículo adicional detalles/opciones.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco) Indica la ubicación física asociada con el artículo (p. ej., la ubicación física). ubicación de la tienda). Se recomienda usar la Google ID de lugar correspondiente al elemento asociado. Una ubicación personalizada con tu ID.
Nota: El ID de ubicación solo está disponible en el alcance del artículo.
price number No 10:01 Es el precio unitario monetario del artículo, expresado en unidades de la moneda especificada. parámetro.
Si se aplica un descuento al elemento, establece price en el precio unitario con descuento y especifica el descuento de precio por unidad 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 ignorará promotion_id a nivel del evento.
Si no se establece, se usa promotion_id a nivel del evento si presente.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada con el artículo.

Si se establece, se ignorará promotion_name a nivel del evento.
Si no se establece, se usa promotion_name a nivel del evento si 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 hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para las implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: evento de GA4
  • Nombre del evento: view_item_list
  • Variables de capa de datos (nombre - nombre de variable de capa de datos):
    • Artículos de comercio electrónico: ecommerce.items
    • ID de la lista de artículos de comercio electrónico: ecommerce.item_list_id
    • Nombre de la lista de artículos de comercio electrónico: ecommerce.item_list_name
  • Parámetros de evento (nombre del parámetro, valor):
    • items - &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • item_list_id - &lbrace;&lbrace;ID de lista de artículos de comercio electrónico&rbrace;
    • item_list_name - &lbrace;&lbrace;Nombre de la lista de artículos de comercio electrónico&rbrace;
  • Activador: 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 significa 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 promocional.

Se ignora si se establece a nivel del elemento.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad promocional asociado con el para cada evento.

Se ignora si se establece a nivel del elemento.
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 elemento.
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 elemento.
items Array<Item> Sí* Los elementos del evento.

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

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 uno de los siguientes valores: item_id o item_name.

item_name string Sí* Camiseta de Stan y sus amigos

Se trata del nombre del artículo.

*Se requiere uno de los siguientes valores: item_id o item_name.

affiliation string No Google Store Afiliación de un producto para designar una empresa proveedora o una tienda en la ubicación de la tienda física.
Nota: La "afiliación" 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 elemento se de forma independiente.
creative_name string No summer_banner2 Es el nombre de la creatividad promocional.

Si se establece, se ignorará creative_name a nivel del evento.
Si no se establece, se usa creative_name a nivel del evento si presente.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad promocional asociado con el elemento.

Si se establece, se ignorará creative_slot a nivel del evento.
Si no se establece, se usa creative_slot a nivel del evento si presente.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 El índice/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 usan como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
item_category2 string No Adultos Es 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 Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
item_category5 string No Manga corta Es 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 ignorará item_list_id a nivel del evento.
Si no se establece, se usa item_list_id a nivel del evento si 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 ignorará item_list_name a nivel del evento.
Si no se establece, se usa item_list_name a nivel del evento si presente.
item_variant string No verde La variante o el código único del artículo, o la descripción del artículo adicional detalles/opciones.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco) Indica la ubicación física asociada con el artículo (p. ej., la ubicación física). ubicación de la tienda). Se recomienda usar la Google ID de lugar correspondiente al elemento asociado. Una ubicación personalizada con tu ID.
Nota: El ID de ubicación solo está disponible en el alcance del artículo.
price number No 10:01 Es el precio unitario monetario del artículo, expresado en unidades de la moneda especificada. parámetro.
Si se aplica un descuento al elemento, establece price en el precio unitario con descuento y especifica el descuento de precio por unidad 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 ignorará promotion_id a nivel del evento.
Si no se establece, se usa promotion_id a nivel del evento si presente.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada con el artículo.

Si se establece, se ignorará promotion_name a nivel del evento.
Si no se establece, se usa promotion_name a nivel del evento si 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 hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para las implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: evento de GA4
  • Nombre del evento: view_promotion
  • Variables de capa de datos (nombre - nombre de variable de capa de datos):
    • Nombre de la creatividad de comercio electrónico: ecommerce.creative_name
    • Espacio para creatividades de comercio electrónico: ecommerce.creative_slot
    • ID de promoción de comercio electrónico: ecommerce.promotion_id
    • Nombre de la promoción de comercio electrónico: ecommerce.promotion_name
    • Artículos de comercio electrónico: ecommerce.items
  • Parámetros de evento (nombre del parámetro, valor):
    • creative_name - &lbrace;&lbrace;Nombre de la creatividad de comercio electrónico&rbrace;
    • creative_slot - &lbrace;&lbrace;Espacio de creatividad de comercio electrónico&rbrace;
    • promotion_id - &lbrace;&lbrace;ID de promoción de comercio electrónico&rbrace;
    • promotion_name - &lbrace;&lbrace;Nombre de la promoción de comercio electrónico&rbrace;
    • items - &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
  • Activador: event equals 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 contacta o es contactado por un representante.

Parámetros

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

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

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

Ejemplo

El siguiente ejemplo es para las 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 de evento (nombre del parámetro, valor):
    • currency: USD
    • value al 30.03
    • lead_status: Conversaciones iniciadas
  • Activa el evento cuando un usuario se contacta o es contactado por un representante