Eventos recomendados

Estos eventos te permiten medir más funciones y comportamientos, así como generar informes más útiles en Google Analytics 4. Dado que necesitan contexto adicional para ser significativos, no se envían automáticamente. En este documento puedes consultar los parámetros obligatorios y opcionales de cada evento.

add_payment_info

Este evento indica que un usuario ha proporcionado sus datos de pago en un proceso de tramitación de la compra de comercio electrónico.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* EUR Es la moneda de los artículos asociados al evento, expresada en el formato estándar ISO 4217 de tres letras.

* Si defines value, currency es obligatorio para que las métricas de ingresos se calculen con precisión.
value number Sí* 7,77 Es el valor monetario del evento.

* Por lo general, value es necesario para registrar información significativa. Si marcas el evento como una conversión, es recomendable que definas value.
* currency es obligatorio si defines value.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al evento.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
payment_type string No Tarjeta de crédito Es el método de pago que se ha elegido.
items Array<Item> Sí Son los artículos del evento.

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.
Nota: "affiliation" solo está disponible a nivel de artículo.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

Si se define, se ignora creative_name a nivel de evento.
Si no se define, se usa creative_name a nivel de evento, si está presente.
creative_slot string No aplicación_destacada_1 Es el nombre del espacio de la creatividad promocional asociado al artículo.

Si se define, se ignora creative_slot a nivel de evento.
Si no se define, se usa creative_slot a nivel de evento, si está presente.
discount number No 2,22 Es el valor del descuento monetario asociado al artículo.
index number No 5 Es el índice o la posición del artículo en una lista.
item_brand string No Google Es la marca del artículo.
item_category string No Ropa Es la categoría del artículo. Si se usa como parte de la jerarquía de una categoría o taxonomía, esta será la primera categoría.
item_category2 string No Adulto Es la jerarquía de la segunda categoría o una taxonomía adicional del artículo.
item_category3 string No Camisetas Es la jerarquía de la tercera categoría o una taxonomía adicional del artículo.
item_category4 string No Cuello redondo Es la jerarquía de la cuarta categoría o una taxonomía adicional del artículo.
item_category5 string No Manga corta Es la jerarquía de la quinta categoría o una taxonomía adicional del artículo.
item_list_id string No productos_relacionados Es el ID de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_id a nivel de evento.
Si no se define, se usa item_list_id a nivel de evento, si está presente.
item_list_name string No Productos relacionados Es el nombre de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No ChIJIQBpaG2ahYAR_6128GcTUEo (el ID de sitio de Google para San Francisco) Es la ubicación física asociada al artículo (por ejemplo, la ubicación de la tienda física). Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.
Nota: "location id" solo está disponible a nivel de artículo.
price number No 9,99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

Si se define, se ignora promotion_name a nivel de evento.
Si no se define, se usa promotion_name a nivel de evento, si está presente.
quantity number No 1

Es la cantidad de artículos.

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

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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;Ecommerce Coupon&rbrace;&rbrace;
    • payment_type - &lbrace;&lbrace;Ecommerce Payment Type&rbrace;&rbrace;
  • Activador: event 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: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

add_shipping_info

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

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* EUR Es la moneda de los artículos asociados al evento, expresada en el formato estándar ISO 4217 de tres letras.

* Si defines value, currency es obligatorio para que las métricas de ingresos se calculen con precisión.
value number Sí* 7,77 Es el valor monetario del evento.

* Por lo general, value es necesario para registrar información significativa. Si marcas el evento como una conversión, es recomendable que definas value.
* currency es obligatorio si defines value.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al evento.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
shipping_tier string No Terrestre Es la modalidad de envío (por ejemplo, Ground, Air o Next-day) que se ha seleccionado para el artículo comprado.
items Array<Item> Sí Son los artículos del evento.

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.
Nota: "affiliation" solo está disponible a nivel de artículo.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

Si se define, se ignora creative_name a nivel de evento.
Si no se define, se usa creative_name a nivel de evento, si está presente.
creative_slot string No aplicación_destacada_1 Es el nombre del espacio de la creatividad promocional asociado al artículo.

Si se define, se ignora creative_slot a nivel de evento.
Si no se define, se usa creative_slot a nivel de evento, si está presente.
discount number No 2,22 Es el valor del descuento monetario asociado al artículo.
index number No 5 Es el índice o la posición del artículo en una lista.
item_brand string No Google Es la marca del artículo.
item_category string No Ropa Es la categoría del artículo. Si se usa como parte de la jerarquía de una categoría o taxonomía, esta será la primera categoría.
item_category2 string No Adulto Es la jerarquía de la segunda categoría o una taxonomía adicional del artículo.
item_category3 string No Camisetas Es la jerarquía de la tercera categoría o una taxonomía adicional del artículo.
item_category4 string No Cuello redondo Es la jerarquía de la cuarta categoría o una taxonomía adicional del artículo.
item_category5 string No Manga corta Es la jerarquía de la quinta categoría o una taxonomía adicional del artículo.
item_list_id string No productos_relacionados Es el ID de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_id a nivel de evento.
Si no se define, se usa item_list_id a nivel de evento, si está presente.
item_list_name string No Productos relacionados Es el nombre de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No ChIJIQBpaG2ahYAR_6128GcTUEo (el ID de sitio de Google para San Francisco) Es la ubicación física asociada al artículo (por ejemplo, la ubicación de la tienda física). Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.
Nota: "location id" solo está disponible a nivel de artículo.
price number No 9,99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

Si se define, se ignora promotion_name a nivel de evento.
Si no se define, se usa promotion_name a nivel de evento, si está presente.
quantity number No 1

Es la cantidad de artículos.

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

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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
    • Modalidad 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;Ecommerce Coupon&rbrace;&rbrace;
    • shipping_tier: &lbrace;&lbrace;Ecommerce Shipping Tier&rbrace;&rbrace;
  • Activador: event 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: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

add_to_cart

Este evento indica que se ha añadido un artículo al carrito.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* EUR Es la moneda de los artículos asociados al evento, expresada en el formato estándar ISO 4217 de tres letras.

* Si defines value, currency es obligatorio para que las métricas de ingresos se calculen con precisión.
value number Sí* 7,77 Es el valor monetario del evento.

* Por lo general, value es necesario para registrar información significativa. Si marcas el evento como una conversión, es recomendable que definas value.
* currency es obligatorio si defines value.
items Array<Item> Sí Son los artículos del evento.

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.
Nota: "affiliation" solo está disponible a nivel de artículo.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

Si se define, se ignora creative_name a nivel de evento.
Si no se define, se usa creative_name a nivel de evento, si está presente.
creative_slot string No aplicación_destacada_1 Es el nombre del espacio de la creatividad promocional asociado al artículo.

Si se define, se ignora creative_slot a nivel de evento.
Si no se define, se usa creative_slot a nivel de evento, si está presente.
discount number No 2,22 Es el valor del descuento monetario asociado al artículo.
index number No 5 Es el índice o la posición del artículo en una lista.
item_brand string No Google Es la marca del artículo.
item_category string No Ropa Es la categoría del artículo. Si se usa como parte de la jerarquía de una categoría o taxonomía, esta será la primera categoría.
item_category2 string No Adulto Es la jerarquía de la segunda categoría o una taxonomía adicional del artículo.
item_category3 string No Camisetas Es la jerarquía de la tercera categoría o una taxonomía adicional del artículo.
item_category4 string No Cuello redondo Es la jerarquía de la cuarta categoría o una taxonomía adicional del artículo.
item_category5 string No Manga corta Es la jerarquía de la quinta categoría o una taxonomía adicional del artículo.
item_list_id string No productos_relacionados Es el ID de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_id a nivel de evento.
Si no se define, se usa item_list_id a nivel de evento, si está presente.
item_list_name string No Productos relacionados Es el nombre de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No ChIJIQBpaG2ahYAR_6128GcTUEo (el ID de sitio de Google para San Francisco) Es la ubicación física asociada al artículo (por ejemplo, la ubicación de la tienda física). Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.
Nota: "location id" solo está disponible a nivel de artículo.
price number No 9,99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

Si se define, se ignora promotion_name a nivel de evento.
Si no se define, se usa promotion_name a nivel de evento, si está presente.
quantity number No 1

Es la cantidad de artículos.

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

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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: event 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: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

add_to_wishlist

Este evento indica que se ha añadido un artículo a una lista de deseos. Usa este evento para identificar artículos de regalo populares en la aplicación.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* EUR Es la moneda de los artículos asociados al evento, expresada en el formato estándar ISO 4217 de tres letras.

* Si defines value, currency es obligatorio para que las métricas de ingresos se calculen con precisión.
value number Sí* 7,77 Es el valor monetario del evento.

* Por lo general, value es necesario para registrar información significativa. Si marcas el evento como una conversión, es recomendable que definas value.
* currency es obligatorio si defines value.
items Array<Item> Sí Son los artículos del evento.

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.
Nota: "affiliation" solo está disponible a nivel de artículo.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

Si se define, se ignora creative_name a nivel de evento.
Si no se define, se usa creative_name a nivel de evento, si está presente.
creative_slot string No aplicación_destacada_1 Es el nombre del espacio de la creatividad promocional asociado al artículo.

Si se define, se ignora creative_slot a nivel de evento.
Si no se define, se usa creative_slot a nivel de evento, si está presente.
discount number No 2,22 Es el valor del descuento monetario asociado al artículo.
index number No 5 Es el índice o la posición del artículo en una lista.
item_brand string No Google Es la marca del artículo.
item_category string No Ropa Es la categoría del artículo. Si se usa como parte de la jerarquía de una categoría o taxonomía, esta será la primera categoría.
item_category2 string No Adulto Es la jerarquía de la segunda categoría o una taxonomía adicional del artículo.
item_category3 string No Camisetas Es la jerarquía de la tercera categoría o una taxonomía adicional del artículo.
item_category4 string No Cuello redondo Es la jerarquía de la cuarta categoría o una taxonomía adicional del artículo.
item_category5 string No Manga corta Es la jerarquía de la quinta categoría o una taxonomía adicional del artículo.
item_list_id string No productos_relacionados Es el ID de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_id a nivel de evento.
Si no se define, se usa item_list_id a nivel de evento, si está presente.
item_list_name string No Productos relacionados Es el nombre de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No ChIJIQBpaG2ahYAR_6128GcTUEo (el ID de sitio de Google para San Francisco) Es la ubicación física asociada al artículo (por ejemplo, la ubicación de la tienda física). Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.
Nota: "location id" solo está disponible a nivel de artículo.
price number No 9,99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

Si se define, se ignora promotion_name a nivel de evento.
Si no se define, se usa promotion_name a nivel de evento, si está presente.
quantity number No 1

Es la cantidad de artículos.

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

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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: event 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: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

begin_checkout

Este evento indica que el usuario ha iniciado la tramitación de una compra.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* EUR Es la moneda de los artículos asociados al evento, expresada en el formato estándar ISO 4217 de tres letras.

* Si defines value, currency es obligatorio para que las métricas de ingresos se calculen con precisión.
value number Sí* 7,77 Es el valor monetario del evento.

* Por lo general, value es necesario para registrar información significativa. Si marcas el evento como una conversión, es recomendable que definas value.
* currency es obligatorio si defines value.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al evento.

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

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.
Nota: "affiliation" solo está disponible a nivel de artículo.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

Si se define, se ignora creative_name a nivel de evento.
Si no se define, se usa creative_name a nivel de evento, si está presente.
creative_slot string No aplicación_destacada_1 Es el nombre del espacio de la creatividad promocional asociado al artículo.

Si se define, se ignora creative_slot a nivel de evento.
Si no se define, se usa creative_slot a nivel de evento, si está presente.
discount number No 2,22 Es el valor del descuento monetario asociado al artículo.
index number No 5 Es el índice o la posición del artículo en una lista.
item_brand string No Google Es la marca del artículo.
item_category string No Ropa Es la categoría del artículo. Si se usa como parte de la jerarquía de una categoría o taxonomía, esta será la primera categoría.
item_category2 string No Adulto Es la jerarquía de la segunda categoría o una taxonomía adicional del artículo.
item_category3 string No Camisetas Es la jerarquía de la tercera categoría o una taxonomía adicional del artículo.
item_category4 string No Cuello redondo Es la jerarquía de la cuarta categoría o una taxonomía adicional del artículo.
item_category5 string No Manga corta Es la jerarquía de la quinta categoría o una taxonomía adicional del artículo.
item_list_id string No productos_relacionados Es el ID de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_id a nivel de evento.
Si no se define, se usa item_list_id a nivel de evento, si está presente.
item_list_name string No Productos relacionados Es el nombre de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No ChIJIQBpaG2ahYAR_6128GcTUEo (el ID de sitio de Google para San Francisco) Es la ubicación física asociada al artículo (por ejemplo, la ubicación de la tienda física). Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.
Nota: "location id" solo está disponible a nivel de artículo.
price number No 9,99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

Si se define, se ignora promotion_name a nivel de evento.
Si no se define, se usa promotion_name a nivel de evento, si está presente.
quantity number No 1

Es la cantidad de artículos.

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

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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;Ecommerce Coupon&rbrace;&rbrace;
  • Activador: event es igual a begin_checkout

Configuración del activador:

  • Tipo de activador: evento personalizado
  • Nombre del evento: begin_checkout
  • Este activador se activa en: todos los eventos personalizados
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "begin_checkout",
  ecommerce: {
    currency: "USD",
    value: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

earn_virtual_currency

Este evento se registra cuando un usuario recibe una moneda virtual en un juego. Si quieres comprender mejor tu economía virtual, registra este evento con spend_virtual_currency.

Parámetros

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

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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 - Gems
    • value - 5
  • Activar el evento cuando un usuario reciba dinero virtual

generate_lead

Este evento se registra cuando se genera un cliente potencial (por ejemplo, mediante un formulario). Regístralo para conocer la efectividad de tus campañas de marketing y saber cuántos clientes que han interactuado con tu empresa vuelven a hacerlo después de mostrarles anuncios de remarketing.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* EUR Es la moneda de los artículos asociados al evento, expresada en el formato estándar ISO 4217 de tres letras.

* Si defines value, currency es obligatorio para que las métricas de ingresos se calculen con precisión.
value number Sí* 7,77 Es el valor monetario del evento.

* Por lo general, value es necesario para registrar información significativa. Si marcas el evento como una conversión, es recomendable que definas value.
* currency es obligatorio si defines value.

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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 - 99,99
  • Activar el evento cuando se haya conseguido 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 determinados grupos o características 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 es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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
  • Activar el evento cuando un usuario se una a un grupo

level_end

Este evento indica que un jugador ha llegado al final de un nivel de un juego.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
level_name string No Empieza el viaje... Es el nombre del nivel.
success boolean No true Se asigna el valor true si el nivel se ha completado correctamente.

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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 - Empieza la aventura…
    • success - true
  • Se activa cuando un jugador llega al final de un nivel (por ejemplo, en la página de confirmación del nivel)

level_start

Este evento indica que un jugador ha iniciado un nivel de un juego.

Parámetros

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

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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 - Empieza la aventura…
  • Se activa cuando un jugador empieza un nivel (por ejemplo, en la página de inicio del nivel)

level_up

Este evento indica que un jugador ha pasado a un nivel superior de un juego. Úsalo para medir la distribución de niveles de tu base de usuarios e identificar los niveles que son difíciles de completar.

Parámetros

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

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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):
    • level - 5
    • character - Jugador 1
  • Se activa cuando un jugador sube de nivel

login

Envía este evento para indicar que un usuario ha iniciado sesión en tu sitio web o aplicación.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
method string No Google Es el método que se ha usado para iniciar sesión.

Ejemplo

Ver la configuración de 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 inicia sesión

post_score

Envía este evento cuando el usuario publique una puntuación. Úsalo para conocer el rendimiento de los usuarios en tu juego y relacionar las puntuaciones más altas con determinadas audiencias o comportamientos.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
score number Sí 10.000 Es la puntuación que se va a publicar.
level number No 5 Es el nivel de la puntuación.
character string No Jugador 1 Es el personaje que ha obtenido la puntuación.

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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
    • level - 5
    • character - Jugador 1
  • Se activa cuando el usuario publica una puntuación

purchase

Este evento indica que un usuario ha comprado uno o varios artículos.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* EUR Es la moneda de los artículos asociados al evento, expresada en el formato estándar ISO 4217 de tres letras.

* Si defines value, currency es obligatorio 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.

El parámetro transaction_id evita que haya eventos duplicados correspondientes a una compra.
value number Sí* 12,21 Es el valor monetario del evento.

* value es necesario para registrar información significativa y rellenar la audiencia predictiva de compradores.
* currency es obligatorio si defines value.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al evento.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
shipping number No 3,33 Son los gastos de envío asociados a una transacción.
tax number No 1,11 Es el importe de los impuestos asociados a una transacción.
items Array<Item> Sí Son los artículos del evento.

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.
Nota: "affiliation" solo está disponible a nivel de artículo.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

Si se define, se ignora creative_name a nivel de evento.
Si no se define, se usa creative_name a nivel de evento, si está presente.
creative_slot string No aplicación_destacada_1 Es el nombre del espacio de la creatividad promocional asociado al artículo.

Si se define, se ignora creative_slot a nivel de evento.
Si no se define, se usa creative_slot a nivel de evento, si está presente.
discount number No 2,22 Es el valor del descuento monetario asociado al artículo.
index number No 5 Es el índice o la posición del artículo en una lista.
item_brand string No Google Es la marca del artículo.
item_category string No Ropa Es la categoría del artículo. Si se usa como parte de la jerarquía de una categoría o taxonomía, esta será la primera categoría.
item_category2 string No Adulto Es la jerarquía de la segunda categoría o una taxonomía adicional del artículo.
item_category3 string No Camisetas Es la jerarquía de la tercera categoría o una taxonomía adicional del artículo.
item_category4 string No Cuello redondo Es la jerarquía de la cuarta categoría o una taxonomía adicional del artículo.
item_category5 string No Manga corta Es la jerarquía de la quinta categoría o una taxonomía adicional del artículo.
item_list_id string No productos_relacionados Es el ID de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_id a nivel de evento.
Si no se define, se usa item_list_id a nivel de evento, si está presente.
item_list_name string No Productos relacionados Es el nombre de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No ChIJIQBpaG2ahYAR_6128GcTUEo (el ID de sitio de Google para San Francisco) Es la ubicación física asociada al artículo (por ejemplo, la ubicación de la tienda física). Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.
Nota: "location id" solo está disponible a nivel de artículo.
price number No 9,99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

Si se define, se ignora promotion_name a nivel de evento.
Si no se define, se usa promotion_name a nivel de evento, si está presente.
quantity number No 1

Es la cantidad de artículos.

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

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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
    • Impuestos de comercio electrónico - ecommerce.tax
    • Envío de comercio electrónico - ecommerce.shipping
    • Moneda de comercio electrónico: ecommerce.currency
    • Cupón de comercio electrónico - ecommerce.coupon
  • Parámetros de evento (Nombre del parámetro - Valor):
    • items - &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • transaction_id - &lbrace;&lbrace;Ecommerce Transaction ID&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • tax - &lbrace;&lbrace;Ecommerce Tax&rbrace;&rbrace;
    • shipping - &lbrace;&lbrace;Ecommerce Shipping&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;Ecommerce Coupon&rbrace;&rbrace;
  • Activador: event es igual a purchase

Configuración del activador:

  • Tipo de activador: evento personalizado
  • Nombre del evento: purchase
  • Este activador se activa en: todos los eventos personalizados
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "purchase",
  ecommerce: {
      transaction_id: "T_12345",
      value: 25.42,
      tax: 4.90,
      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: 9.99,
        quantity: 1
      },
      {
        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: 20.99,
        promotion_id: "P_12345",
        promotion_name: "Summer Sale",
        quantity: 1
      }]
  }
});

refund

Este evento indica que se han reembolsado uno o varios artículos a un usuario.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* EUR Es la moneda de los artículos asociados al evento, expresada en el formato estándar ISO 4217 de tres letras.

* Si defines value, currency es obligatorio 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í* 7,77 Es el valor monetario del evento.

* Por lo general, value es necesario para registrar información significativa. Si marcas el evento como una conversión, es recomendable que definas value.
* currency es obligatorio si defines value.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al evento.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
shipping number No 3,33 Son los gastos de envío asociados a una transacción.
tax number No 1,11 Es el importe de los impuestos asociados a una transacción.
items Array<Item> No* Son los artículos del evento.

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.
Nota: "affiliation" solo está disponible a nivel de artículo.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

Si se define, se ignora creative_name a nivel de evento.
Si no se define, se usa creative_name a nivel de evento, si está presente.
creative_slot string No aplicación_destacada_1 Es el nombre del espacio de la creatividad promocional asociado al artículo.

Si se define, se ignora creative_slot a nivel de evento.
Si no se define, se usa creative_slot a nivel de evento, si está presente.
discount number No 2,22 Es el valor del descuento monetario asociado al artículo.
index number No 5 Es el índice o la posición del artículo en una lista.
item_brand string No Google Es la marca del artículo.
item_category string No Ropa Es la categoría del artículo. Si se usa como parte de la jerarquía de una categoría o taxonomía, esta será la primera categoría.
item_category2 string No Adulto Es la jerarquía de la segunda categoría o una taxonomía adicional del artículo.
item_category3 string No Camisetas Es la jerarquía de la tercera categoría o una taxonomía adicional del artículo.
item_category4 string No Cuello redondo Es la jerarquía de la cuarta categoría o una taxonomía adicional del artículo.
item_category5 string No Manga corta Es la jerarquía de la quinta categoría o una taxonomía adicional del artículo.
item_list_id string No productos_relacionados Es el ID de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_id a nivel de evento.
Si no se define, se usa item_list_id a nivel de evento, si está presente.
item_list_name string No Productos relacionados Es el nombre de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No ChIJIQBpaG2ahYAR_6128GcTUEo (el ID de sitio de Google para San Francisco) Es la ubicación física asociada al artículo (por ejemplo, la ubicación de la tienda física). Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.
Nota: "location id" solo está disponible a nivel de artículo.
price number No 9,99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

Si se define, se ignora promotion_name a nivel de evento.
Si no se define, se usa promotion_name a nivel de evento, si está presente.
quantity number No 1

Es la cantidad de artículos.

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

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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
    • Impuestos de comercio electrónico - ecommerce.tax
    • Envío de comercio electrónico - ecommerce.shipping
    • Moneda de comercio electrónico: ecommerce.currency
    • Cupón de comercio electrónico - ecommerce.coupon
  • Parámetros de evento (Nombre del parámetro - Valor):
    • items - &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • transaction_id - &lbrace;&lbrace;Ecommerce Transaction ID&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • tax - &lbrace;&lbrace;Ecommerce Tax&rbrace;&rbrace;
    • shipping - &lbrace;&lbrace;Ecommerce Shipping&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;Ecommerce Coupon&rbrace;&rbrace;
  • Activador: event es igual a refund

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: 12.21,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

remove_from_cart

Este evento indica que se ha retirado un artículo del carrito.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* EUR Es la moneda de los artículos asociados al evento, expresada en el formato estándar ISO 4217 de tres letras.

* Si defines value, currency es obligatorio para que las métricas de ingresos se calculen con precisión.
value number Sí* 7,77 Es el valor monetario del evento.

* Por lo general, value es necesario para registrar información significativa. Si marcas el evento como una conversión, es recomendable que definas value.
* currency es obligatorio si defines value.
items Array<Item> Sí Son los artículos del evento.

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.
Nota: "affiliation" solo está disponible a nivel de artículo.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

Si se define, se ignora creative_name a nivel de evento.
Si no se define, se usa creative_name a nivel de evento, si está presente.
creative_slot string No aplicación_destacada_1 Es el nombre del espacio de la creatividad promocional asociado al artículo.

Si se define, se ignora creative_slot a nivel de evento.
Si no se define, se usa creative_slot a nivel de evento, si está presente.
discount number No 2,22 Es el valor del descuento monetario asociado al artículo.
index number No 5 Es el índice o la posición del artículo en una lista.
item_brand string No Google Es la marca del artículo.
item_category string No Ropa Es la categoría del artículo. Si se usa como parte de la jerarquía de una categoría o taxonomía, esta será la primera categoría.
item_category2 string No Adulto Es la jerarquía de la segunda categoría o una taxonomía adicional del artículo.
item_category3 string No Camisetas Es la jerarquía de la tercera categoría o una taxonomía adicional del artículo.
item_category4 string No Cuello redondo Es la jerarquía de la cuarta categoría o una taxonomía adicional del artículo.
item_category5 string No Manga corta Es la jerarquía de la quinta categoría o una taxonomía adicional del artículo.
item_list_id string No productos_relacionados Es el ID de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_id a nivel de evento.
Si no se define, se usa item_list_id a nivel de evento, si está presente.
item_list_name string No Productos relacionados Es el nombre de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No ChIJIQBpaG2ahYAR_6128GcTUEo (el ID de sitio de Google para San Francisco) Es la ubicación física asociada al artículo (por ejemplo, la ubicación de la tienda física). Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.
Nota: "location id" solo está disponible a nivel de artículo.
price number No 9,99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

Si se define, se ignora promotion_name a nivel de evento.
Si no se define, se usa promotion_name a nivel de evento, si está presente.
quantity number No 1

Es la cantidad de artículos.

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

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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: event 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: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

Registra este evento para indicar el momento en el que ha realizado una búsqueda el usuario. Puedes usar este evento para identificar qué buscan los usuarios en tu sitio web o aplicación. Por ejemplo, podrías enviar este evento cuando un usuario ve una página de resultados después de hacer una búsqueda.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
search_term string Sí camisetas Es el término que se ha buscado.

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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 activa cuando un usuario hace una búsqueda en tu sitio web

select_content

Este evento indica que un usuario ha seleccionado contenido de un determinado tipo, lo que te puede servir para identificar el contenido popular y las categorías de contenido de tu sitio web o aplicación.

Parámetros

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

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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: event es igual a select_content

select_item

Este evento indica que se ha seleccionado un artículo de una lista.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
item_list_id string No productos_relacionados Es el ID de la lista en la que se ha mostrado el artículo al usuario.

Se ignora si se define a nivel de artículo.
item_list_name string No Productos relacionados Es el nombre de la lista en la que se ha mostrado el artículo al usuario.

Se ignora si se define a nivel de artículo.
items Array<Item> Sí* Son los artículos del evento.

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

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.
Nota: "affiliation" solo está disponible a nivel de artículo.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

Si se define, se ignora creative_name a nivel de evento.
Si no se define, se usa creative_name a nivel de evento, si está presente.
creative_slot string No aplicación_destacada_1 Es el nombre del espacio de la creatividad promocional asociado al artículo.

Si se define, se ignora creative_slot a nivel de evento.
Si no se define, se usa creative_slot a nivel de evento, si está presente.
discount number No 2,22 Es el valor del descuento monetario asociado al artículo.
index number No 5 Es el índice o la posición del artículo en una lista.
item_brand string No Google Es la marca del artículo.
item_category string No Ropa Es la categoría del artículo. Si se usa como parte de la jerarquía de una categoría o taxonomía, esta será la primera categoría.
item_category2 string No Adulto Es la jerarquía de la segunda categoría o una taxonomía adicional del artículo.
item_category3 string No Camisetas Es la jerarquía de la tercera categoría o una taxonomía adicional del artículo.
item_category4 string No Cuello redondo Es la jerarquía de la cuarta categoría o una taxonomía adicional del artículo.
item_category5 string No Manga corta Es la jerarquía de la quinta categoría o una taxonomía adicional del artículo.
item_list_id string No productos_relacionados Es el ID de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_id a nivel de evento.
Si no se define, se usa item_list_id a nivel de evento, si está presente.
item_list_name string No Productos relacionados Es el nombre de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No ChIJIQBpaG2ahYAR_6128GcTUEo (el ID de sitio de Google para San Francisco) Es la ubicación física asociada al artículo (por ejemplo, la ubicación de la tienda física). Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.
Nota: "location id" solo está disponible a nivel de artículo.
price number No 9,99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

Si se define, se ignora promotion_name a nivel de evento.
Si no se define, se usa promotion_name a nivel de evento, si está presente.
quantity number No 1

Es la cantidad de artículos.

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

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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;Ecommerce Item List ID&rbrace;&rbrace;
    • item_list_name - &lbrace;&lbrace;Ecommerce Item List Name&rbrace;&rbrace;
  • Activador: event 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: 9.99,
      quantity: 1
    }
    ]
  }
});

select_promotion

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

Parámetros

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

Se ignora si se define a nivel de artículo.
creative_slot string No aplicación_destacada_1 Es el nombre del espacio de la creatividad promocional asociado al evento.

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

Se ignora si se define a nivel de artículo.
promotion_name string No Rebajas de verano Es el nombre de la promoción asociada al evento.

Se ignora si se define a nivel de artículo.
items Array<Item> No Son los artículos del evento.

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.
Nota: "affiliation" solo está disponible a nivel de artículo.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

Si se define, se ignora creative_name a nivel de evento.
Si no se define, se usa creative_name a nivel de evento, si está presente.
creative_slot string No aplicación_destacada_1 Es el nombre del espacio de la creatividad promocional asociado al artículo.

Si se define, se ignora creative_slot a nivel de evento.
Si no se define, se usa creative_slot a nivel de evento, si está presente.
discount number No 2,22 Es el valor del descuento monetario asociado al artículo.
index number No 5 Es el índice o la posición del artículo en una lista.
item_brand string No Google Es la marca del artículo.
item_category string No Ropa Es la categoría del artículo. Si se usa como parte de la jerarquía de una categoría o taxonomía, esta será la primera categoría.
item_category2 string No Adulto Es la jerarquía de la segunda categoría o una taxonomía adicional del artículo.
item_category3 string No Camisetas Es la jerarquía de la tercera categoría o una taxonomía adicional del artículo.
item_category4 string No Cuello redondo Es la jerarquía de la cuarta categoría o una taxonomía adicional del artículo.
item_category5 string No Manga corta Es la jerarquía de la quinta categoría o una taxonomía adicional del artículo.
item_list_id string No productos_relacionados Es el ID de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_id a nivel de evento.
Si no se define, se usa item_list_id a nivel de evento, si está presente.
item_list_name string No Productos relacionados Es el nombre de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No ChIJIQBpaG2ahYAR_6128GcTUEo (el ID de sitio de Google para San Francisco) Es la ubicación física asociada al artículo (por ejemplo, la ubicación de la tienda física). Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.
Nota: "location id" solo está disponible a nivel de artículo.
price number No 9,99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

Si se define, se ignora promotion_name a nivel de evento.
Si no se define, se usa promotion_name a nivel de evento, si está presente.
quantity number No 1

Es la cantidad de artículos.

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

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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 de la creatividad de comercio electrónico - ecommerce.creative_slot
    • ID de la 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;Ecommerce Creative Name&rbrace;&rbrace;
    • creative_slot - &lbrace;&lbrace;Ecommerce Creative Slot&rbrace;&rbrace;
    • promotion_id - &lbrace;&lbrace;Ecommerce Promotion ID&rbrace;&rbrace;
    • promotion_name - &lbrace;&lbrace;Ecommerce Promotion Name&rbrace;&rbrace;
    • items - &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
  • Tipo de variable: variable de capa de datos - 'ecommerce.items'
  • Activador: event 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: 9.99,
      quantity: 1
    }
    ]
  }
});

share

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 a través del cual se ha compartido el contenido.
content_type string No image Es el tipo de contenido que se ha compartido.
item_id string No C_12345 Es el ID del contenido que se ha compartido.

Ejemplo

Ver la configuración de 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 - image
    • item_id - C_12345
  • Se activa cuando un usuario comparte contenido

sign_up

Este evento indica que un usuario se ha registrado para crear una cuenta. Úsalo para conocer los comportamientos de los usuarios con la sesión iniciada y sin iniciar.

Parámetros

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

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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 para obtener una cuenta

spend_virtual_currency

Este evento registra la venta de productos virtuales en tu aplicación y te puede servir para identificar cuáles son los más populares.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
value number Sí 5 Es el valor de la moneda virtual.
virtual_currency_name string Sí Gemas Es el nombre de la moneda virtual.
item_name string No Starter Boost Es el nombre del artículo para el que se ha usado la moneda virtual.

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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):
    • value - 5
    • virtual_currency_name - Gems
    • item_name - Starter Boost
  • Se activa cuando un usuario compra un producto virtual

tutorial_begin

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

Parámetros

Este evento no tiene parámetros.

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: evento de GA4
  • Nombre del evento: tutorial_begin
  • Se activa cuando un usuario empieza el proceso de incorporación

tutorial_complete

Este evento indica que el usuario ha finalizado el proceso de incorporación. Úsalo en un embudo de conversión con tutorial_begin para saber cuántos usuarios finalizan el tutorial.

Parámetros

No hay parámetros sugeridos para este evento.

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de etiqueta

Configuración de la etiqueta:

  • Tipo de etiqueta: evento de GA4
  • Nombre del evento: tutorial_complete
  • Se activa cuando un usuario finaliza el proceso de incorporación

unlock_achievement

Registra este evento cuando el usuario haya desbloqueado un logro. Este evento te puede servir para entender cómo ven tu juego los usuarios.

Parámetros

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

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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 indica que un usuario ha visto su carrito.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* EUR Es la moneda de los artículos asociados al evento, expresada en el formato estándar ISO 4217 de tres letras.

* Si defines value, currency es obligatorio para que las métricas de ingresos se calculen con precisión.
value number Sí* 7,77 Es el valor monetario del evento.

* Por lo general, value es necesario para registrar información significativa. Si marcas el evento como una conversión, es recomendable que definas value.
* currency es obligatorio si defines value.
items Array<Item> Sí Son los artículos del evento.

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.
Nota: "affiliation" solo está disponible a nivel de artículo.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

Si se define, se ignora creative_name a nivel de evento.
Si no se define, se usa creative_name a nivel de evento, si está presente.
creative_slot string No aplicación_destacada_1 Es el nombre del espacio de la creatividad promocional asociado al artículo.

Si se define, se ignora creative_slot a nivel de evento.
Si no se define, se usa creative_slot a nivel de evento, si está presente.
discount number No 2,22 Es el valor del descuento monetario asociado al artículo.
index number No 5 Es el índice o la posición del artículo en una lista.
item_brand string No Google Es la marca del artículo.
item_category string No Ropa Es la categoría del artículo. Si se usa como parte de la jerarquía de una categoría o taxonomía, esta será la primera categoría.
item_category2 string No Adulto Es la jerarquía de la segunda categoría o una taxonomía adicional del artículo.
item_category3 string No Camisetas Es la jerarquía de la tercera categoría o una taxonomía adicional del artículo.
item_category4 string No Cuello redondo Es la jerarquía de la cuarta categoría o una taxonomía adicional del artículo.
item_category5 string No Manga corta Es la jerarquía de la quinta categoría o una taxonomía adicional del artículo.
item_list_id string No productos_relacionados Es el ID de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_id a nivel de evento.
Si no se define, se usa item_list_id a nivel de evento, si está presente.
item_list_name string No Productos relacionados Es el nombre de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No ChIJIQBpaG2ahYAR_6128GcTUEo (el ID de sitio de Google para San Francisco) Es la ubicación física asociada al artículo (por ejemplo, la ubicación de la tienda física). Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.
Nota: "location id" solo está disponible a nivel de artículo.
price number No 9,99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

Si se define, se ignora promotion_name a nivel de evento.
Si no se define, se usa promotion_name a nivel de evento, si está presente.
quantity number No 1

Es la cantidad de artículos.

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

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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: event 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: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

view_item

Este evento indica que se ha mostrado parte del contenido al usuario. Úsalo para descubrir los artículos que tienen más visualizaciones.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* EUR Es la moneda de los artículos asociados al evento, expresada en el formato estándar ISO 4217 de tres letras.

* Si defines value, currency es obligatorio para que las métricas de ingresos se calculen con precisión.
value number Sí* 7,77 Es el valor monetario del evento.

* Por lo general, value es necesario para registrar información significativa. Si marcas el evento como una conversión, es recomendable que definas value.
* currency es obligatorio si defines value.
items Array<Item> Sí Son los artículos del evento.

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.
Nota: "affiliation" solo está disponible a nivel de artículo.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

Si se define, se ignora creative_name a nivel de evento.
Si no se define, se usa creative_name a nivel de evento, si está presente.
creative_slot string No aplicación_destacada_1 Es el nombre del espacio de la creatividad promocional asociado al artículo.

Si se define, se ignora creative_slot a nivel de evento.
Si no se define, se usa creative_slot a nivel de evento, si está presente.
discount number No 2,22 Es el valor del descuento monetario asociado al artículo.
index number No 5 Es el índice o la posición del artículo en una lista.
item_brand string No Google Es la marca del artículo.
item_category string No Ropa Es la categoría del artículo. Si se usa como parte de la jerarquía de una categoría o taxonomía, esta será la primera categoría.
item_category2 string No Adulto Es la jerarquía de la segunda categoría o una taxonomía adicional del artículo.
item_category3 string No Camisetas Es la jerarquía de la tercera categoría o una taxonomía adicional del artículo.
item_category4 string No Cuello redondo Es la jerarquía de la cuarta categoría o una taxonomía adicional del artículo.
item_category5 string No Manga corta Es la jerarquía de la quinta categoría o una taxonomía adicional del artículo.
item_list_id string No productos_relacionados Es el ID de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_id a nivel de evento.
Si no se define, se usa item_list_id a nivel de evento, si está presente.
item_list_name string No Productos relacionados Es el nombre de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No ChIJIQBpaG2ahYAR_6128GcTUEo (el ID de sitio de Google para San Francisco) Es la ubicación física asociada al artículo (por ejemplo, la ubicación de la tienda física). Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.
Nota: "location id" solo está disponible a nivel de artículo.
price number No 9,99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

Si se define, se ignora promotion_name a nivel de evento.
Si no se define, se usa promotion_name a nivel de evento, si está presente.
quantity number No 1

Es la cantidad de artículos.

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

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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: event 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: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

view_item_list

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

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
item_list_id string No productos_relacionados Es el ID de la lista en la que se ha mostrado el artículo al usuario.

Se ignora si se define a nivel de artículo.
item_list_name string No Productos relacionados Es el nombre de la lista en la que se ha mostrado el artículo al usuario.

Se ignora si se define a nivel de artículo.
items Array<Item> Sí Son los artículos del evento.

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.
Nota: "affiliation" solo está disponible a nivel de artículo.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

Si se define, se ignora creative_name a nivel de evento.
Si no se define, se usa creative_name a nivel de evento, si está presente.
creative_slot string No aplicación_destacada_1 Es el nombre del espacio de la creatividad promocional asociado al artículo.

Si se define, se ignora creative_slot a nivel de evento.
Si no se define, se usa creative_slot a nivel de evento, si está presente.
discount number No 2,22 Es el valor del descuento monetario asociado al artículo.
index number No 5 Es el índice o la posición del artículo en una lista.
item_brand string No Google Es la marca del artículo.
item_category string No Ropa Es la categoría del artículo. Si se usa como parte de la jerarquía de una categoría o taxonomía, esta será la primera categoría.
item_category2 string No Adulto Es la jerarquía de la segunda categoría o una taxonomía adicional del artículo.
item_category3 string No Camisetas Es la jerarquía de la tercera categoría o una taxonomía adicional del artículo.
item_category4 string No Cuello redondo Es la jerarquía de la cuarta categoría o una taxonomía adicional del artículo.
item_category5 string No Manga corta Es la jerarquía de la quinta categoría o una taxonomía adicional del artículo.
item_list_id string No productos_relacionados Es el ID de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_id a nivel de evento.
Si no se define, se usa item_list_id a nivel de evento, si está presente.
item_list_name string No Productos relacionados Es el nombre de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No ChIJIQBpaG2ahYAR_6128GcTUEo (el ID de sitio de Google para San Francisco) Es la ubicación física asociada al artículo (por ejemplo, la ubicación de la tienda física). Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.
Nota: "location id" solo está disponible a nivel de artículo.
price number No 9,99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

Si se define, se ignora promotion_name a nivel de evento.
Si no se define, se usa promotion_name a nivel de evento, si está presente.
quantity number No 1

Es la cantidad de artículos.

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

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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;Ecommerce Item List ID&rbrace;&rbrace;
    • item_list_name - &lbrace;&lbrace;Ecommerce Item List Name&rbrace;&rbrace;
  • Activador: event 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: 9.99,
      quantity: 1
    },
    {
      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: 20.99,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 1
    }]
  }
});

view_promotion

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

Parámetros

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

Se ignora si se define a nivel de artículo.
creative_slot string No aplicación_destacada_1 Es el nombre del espacio de la creatividad promocional asociado al evento.

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

Se ignora si se define a nivel de artículo.
promotion_name string No Rebajas de verano Es el nombre de la promoción asociada al evento.

Se ignora si se define a nivel de artículo.
items Array<Item> Sí* Son los artículos del evento.

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

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.
Nota: "affiliation" solo está disponible a nivel de artículo.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

Si se define, se ignora creative_name a nivel de evento.
Si no se define, se usa creative_name a nivel de evento, si está presente.
creative_slot string No aplicación_destacada_1 Es el nombre del espacio de la creatividad promocional asociado al artículo.

Si se define, se ignora creative_slot a nivel de evento.
Si no se define, se usa creative_slot a nivel de evento, si está presente.
discount number No 2,22 Es el valor del descuento monetario asociado al artículo.
index number No 5 Es el índice o la posición del artículo en una lista.
item_brand string No Google Es la marca del artículo.
item_category string No Ropa Es la categoría del artículo. Si se usa como parte de la jerarquía de una categoría o taxonomía, esta será la primera categoría.
item_category2 string No Adulto Es la jerarquía de la segunda categoría o una taxonomía adicional del artículo.
item_category3 string No Camisetas Es la jerarquía de la tercera categoría o una taxonomía adicional del artículo.
item_category4 string No Cuello redondo Es la jerarquía de la cuarta categoría o una taxonomía adicional del artículo.
item_category5 string No Manga corta Es la jerarquía de la quinta categoría o una taxonomía adicional del artículo.
item_list_id string No productos_relacionados Es el ID de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_id a nivel de evento.
Si no se define, se usa item_list_id a nivel de evento, si está presente.
item_list_name string No Productos relacionados Es el nombre de la lista en la que se ha mostrado el artículo al usuario.

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No ChIJIQBpaG2ahYAR_6128GcTUEo (el ID de sitio de Google para San Francisco) Es la ubicación física asociada al artículo (por ejemplo, la ubicación de la tienda física). Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.
Nota: "location id" solo está disponible a nivel de artículo.
price number No 9,99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

Si se define, se ignora promotion_name a nivel de evento.
Si no se define, se usa promotion_name a nivel de evento, si está presente.
quantity number No 1

Es la cantidad de artículos.

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

Ejemplo

El siguiente es un ejemplo para implementaciones de Tag Manager:

Ver la configuración de 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 de la creatividad de comercio electrónico - ecommerce.creative_slot
    • ID de la 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;Ecommerce Creative Name&rbrace;&rbrace;
    • creative_slot - &lbrace;&lbrace;Ecommerce Creative Slot&rbrace;&rbrace;
    • promotion_id - &lbrace;&lbrace;Ecommerce Promotion ID&rbrace;&rbrace;
    • promotion_name - &lbrace;&lbrace;Ecommerce Promotion Name&rbrace;&rbrace;
    • items - &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
  • Activador: event es igual a view_promotion

Configuración del activador:

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