Prueba el servidor de MCP para Google Analytics. Instala desde GitHub y consulta el anuncio para obtener más detalles.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Eventos recomendados

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

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

Para todas las propiedades

`earn_virtual_currency`

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

Parámetros

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

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: earn_virtual_currency
Parámetros del evento (nombre del parámetro - valor):

virtual_currency_name - Gems
value - 5

Activa el evento cuando alguien recibe dinero virtual

`join_group`

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

Parámetros

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

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: join_group
Parámetros del evento (nombre del parámetro - valor):

group_id - G_12345

Activa el evento cuando un usuario se une a un grupo

`login`

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

Parámetros

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

Ejemplo

`search`

Registra este evento para indicar cuándo el usuario realizó una búsqueda. 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 vea una página de resultados de búsqueda después de realizar una búsqueda.

Parámetros

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

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: search
Parámetros del evento (nombre del parámetro - valor):

search_term, camisetas

Se activa cuando un usuario realiza una búsqueda en tu sitio web

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: search
Parámetros del evento (nombre del parámetro - valor):

search_term, camisetas

Se activa cuando un usuario realiza una búsqueda en tu sitio web

`select_content`

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`content_type`	`string`	No	producto	Es el tipo de contenido seleccionado.
`content_id`	`string`	No	C_12345	Es un identificador del contenido que se seleccionó. El valor debe incluir al menos un carácter no numérico.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: select_content
Parámetros del evento (nombre del parámetro - valor):

content_type: producto
content_id - C_12345

Activador: El evento es igual a select_content

`share`

Usa este evento cuando un usuario haya compartido contenido.

Parámetros

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

El siguiente ejemplo es para implementaciones de Tag Manager:

Ejemplo

`sign_up`

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

Parámetros

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

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: sign_up
Parámetros del evento (nombre del parámetro - valor):

method: Google

Se activa cuando un usuario se registra para obtener una cuenta.

`spend_virtual_currency`

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

Parámetros

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

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: spend_virtual_currency
Parámetros del evento (nombre del parámetro - valor):

value - 5
virtual_currency_name - Gems
item_name: Starter Boost

Se activa cuando alguien compra un artículo virtual

`tutorial_begin`

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

Parámetros

No hay parámetros para este evento.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

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

`tutorial_complete`

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

Parámetros

No se sugieren parámetros para este evento.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

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

Ventas en línea

`add_payment_info`

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras. * Las métricas de valor en el evento `view_item` no contribuyen a los ingresos. * Si estableces `value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`value`	`number`	Sí*	30.03	Es el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos de `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requiere `value` para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el evento. Los parámetros `coupon` a nivel del evento y del artículo son independientes.
`payment_type`	`string`	No	Credit Card	Es la forma de pago elegida.
`items`	`Array<Item>`	Sí		Son los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan and Friends	Se trata del nombre del artículo. *Se requiere `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física. Nota: `affiliation` solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Es el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del artículo son independientes.
`discount`	`number`	No	2.22	Es el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	Índice o posición del elemento en una lista.
`item_brand`	`string`	No	Google	Se refiere a la marca del artículo.
`item_category`	`string`	No	Indumentaria	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
`item_category2`	`string`	No	Adultos	Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
`item_category4`	`string`	No	Equipo de rodaje	Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_id` a nivel del evento. Si no se establece, se usa el `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_name` a nivel del evento. Si no se establece, se usa el `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	verde	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco)	Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: `location_id` solo está disponible en el alcance del elemento.
`price`	`number`	No	10.01	Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado. Si se aplica un descuento al artículo, establece `price` en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro `discount`.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: add_payment_info
Variables de capa de datos (nombre - nombre de la variable de capa de datos):

Artículos de comercio electrónico: ecommerce.items
Valor del comercio electrónico: ecommerce.value
Moneda de comercio electrónico: ecommerce.currency
Cupón de comercio electrónico: ecommerce.coupon
Tipo de pago de comercio electrónico: ecommerce.payment_type

Parámetros del evento (nombre del parámetro - valor):

items: {{Artículos de comercio electrónico}}
value: {{Valor de comercio electrónico}}
currency: {{Moneda de comercio electrónico}}
coupon: {{Ecommerce Coupon}}
payment_type: {{Ecommerce Payment Type}}

Activador: El evento es igual a add_payment_info

Configuración del activador:

Tipo de activador: Evento personalizado
Nombre del evento: add_payment_info
Este activador se activa en todos los eventos personalizados.

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

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

`add_shipping_info`

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras. * Las métricas de valor en el evento `view_item` no contribuyen a los ingresos. * Si estableces `value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`value`	`number`	Sí*	30.03	Es el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos de `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requiere `value` para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el evento. Los parámetros `coupon` a nivel del evento y del artículo son independientes.
`shipping_tier`	`string`	No	Suelo	Indica el nivel de envío (p.ej., `Ground`, `Air`, `Next-day`) seleccionado para la entrega del artículo comprado.
`items`	`Array<Item>`	Sí		Son los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan and Friends	Se trata del nombre del artículo. *Se requiere `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física. Nota: `affiliation` solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Es el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del artículo son independientes.
`discount`	`number`	No	2.22	Es el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	Índice o posición del elemento en una lista.
`item_brand`	`string`	No	Google	Se refiere a la marca del artículo.
`item_category`	`string`	No	Indumentaria	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
`item_category2`	`string`	No	Adultos	Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
`item_category4`	`string`	No	Equipo de rodaje	Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_id` a nivel del evento. Si no se establece, se usa el `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_name` a nivel del evento. Si no se establece, se usa el `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	verde	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco)	Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: `location_id` solo está disponible en el alcance del elemento.
`price`	`number`	No	10.01	Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado. Si se aplica un descuento al artículo, establece `price` en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro `discount`.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: add_shipping_info
Variables de capa de datos (nombre - nombre de la variable de capa de datos):

Artículos de comercio electrónico: ecommerce.items
Valor del comercio electrónico: ecommerce.value
Moneda de comercio electrónico: ecommerce.currency
Cupón de comercio electrónico: ecommerce.coupon
Nivel de envío de comercio electrónico: ecommerce.shipping_tier

Parámetros del evento (nombre del parámetro - valor):

items: {{Artículos de comercio electrónico}}
value: {{Valor de comercio electrónico}}
currency: {{Moneda de comercio electrónico}}
coupon: {{Ecommerce Coupon}}
shipping_tier: {{Ecommerce Shipping Tier}}

Activador: El evento es igual a add_shipping_info

Configuración del activador:

Tipo de activador: Evento personalizado
Nombre del evento: add_shipping_info
Este activador se activa en todos los eventos personalizados.

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

`add_to_cart`

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras. * Las métricas de valor en el evento `view_item` no contribuyen a los ingresos. * Si estableces `value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`value`	`number`	Sí*	30.03	Es el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos de `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requiere `value` para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`items`	`Array<Item>`	Sí		Son los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan and Friends	Se trata del nombre del artículo. *Se requiere `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física. Nota: `affiliation` solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Es el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del artículo son independientes.
`discount`	`number`	No	2.22	Es el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	Índice o posición del elemento en una lista.
`item_brand`	`string`	No	Google	Se refiere a la marca del artículo.
`item_category`	`string`	No	Indumentaria	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
`item_category2`	`string`	No	Adultos	Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
`item_category4`	`string`	No	Equipo de rodaje	Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_id` a nivel del evento. Si no se establece, se usa el `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_name` a nivel del evento. Si no se establece, se usa el `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	verde	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco)	Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: `location_id` solo está disponible en el alcance del elemento.
`price`	`number`	No	10.01	Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado. Si se aplica un descuento al artículo, establece `price` en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro `discount`.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: add_to_cart
Variables de capa de datos (nombre - nombre de la variable de capa de datos):

Artículos de comercio electrónico: ecommerce.items
Valor del comercio electrónico: ecommerce.value
Moneda de comercio electrónico: ecommerce.currency

Parámetros del evento (nombre del parámetro - valor):

items: {{Artículos de comercio electrónico}}
value: {{Valor de comercio electrónico}}
currency: {{Moneda de comercio electrónico}}

Activador: El evento es igual a add_to_cart

Configuración del activador:

Tipo de activador: Evento personalizado
Nombre del evento: add_to_cart
Este activador se activa en todos los eventos personalizados.

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

`add_to_wishlist`

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras. * Las métricas de valor en el evento `view_item` no contribuyen a los ingresos. * Si estableces `value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`value`	`number`	Sí*	30.03	Es el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos de `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requiere `value` para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`items`	`Array<Item>`	Sí		Son los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan and Friends	Se trata del nombre del artículo. *Se requiere `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física. Nota: `affiliation` solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Es el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del artículo son independientes.
`discount`	`number`	No	2.22	Es el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	Índice o posición del elemento en una lista.
`item_brand`	`string`	No	Google	Se refiere a la marca del artículo.
`item_category`	`string`	No	Indumentaria	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
`item_category2`	`string`	No	Adultos	Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
`item_category4`	`string`	No	Equipo de rodaje	Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_id` a nivel del evento. Si no se establece, se usa el `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_name` a nivel del evento. Si no se establece, se usa el `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	verde	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco)	Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: `location_id` solo está disponible en el alcance del elemento.
`price`	`number`	No	10.01	Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado. Si se aplica un descuento al artículo, establece `price` en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro `discount`.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: add_to_wishlist
Variables de capa de datos (nombre - nombre de la variable de capa de datos):

Artículos de comercio electrónico: ecommerce.items
Valor del comercio electrónico: ecommerce.value
Moneda de comercio electrónico: ecommerce.currency

Parámetros del evento (nombre del parámetro - valor):

items: {{Artículos de comercio electrónico}}
value: {{Valor de comercio electrónico}}
currency: {{Moneda de comercio electrónico}}

Activador: El evento es igual a add_to_wishlist

Configuración del activador:

Tipo de activador: Evento personalizado
Nombre del evento: add_to_wishlist
Este activador se activa en todos los eventos personalizados.

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

`begin_checkout`

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras. * Las métricas de valor en el evento `view_item` no contribuyen a los ingresos. * Si estableces `value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`value`	`number`	Sí*	30.03	Es el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos de `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requiere `value` para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el evento. Los parámetros `coupon` a nivel del evento y del artículo son independientes.
`items`	`Array<Item>`	Sí		Son los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan and Friends	Se trata del nombre del artículo. *Se requiere `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física. Nota: `affiliation` solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Es el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del artículo son independientes.
`discount`	`number`	No	2.22	Es el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	Índice o posición del elemento en una lista.
`item_brand`	`string`	No	Google	Se refiere a la marca del artículo.
`item_category`	`string`	No	Indumentaria	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
`item_category2`	`string`	No	Adultos	Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
`item_category4`	`string`	No	Equipo de rodaje	Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_id` a nivel del evento. Si no se establece, se usa el `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_name` a nivel del evento. Si no se establece, se usa el `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	verde	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco)	Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: `location_id` solo está disponible en el alcance del elemento.
`price`	`number`	No	10.01	Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado. Si se aplica un descuento al artículo, establece `price` en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro `discount`.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: begin_checkout
Variables de capa de datos (nombre - nombre de la variable de capa de datos):

Artículos de comercio electrónico: ecommerce.items
Valor del comercio electrónico: ecommerce.value
Moneda de comercio electrónico: ecommerce.currency
Cupón de comercio electrónico: ecommerce.coupon

Parámetros del evento (nombre del parámetro - valor):

items: {{Artículos de comercio electrónico}}
value: {{Valor de comercio electrónico}}
currency: {{Moneda de comercio electrónico}}
coupon: {{Ecommerce Coupon}}

Activador: El evento es igual a begin_checkout

Configuración del activador:

Tipo de activador: Evento personalizado
Nombre del evento: begin_checkout
Este activador se activa en todos los eventos personalizados.

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

`purchase`

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras. * Las métricas de valor en el evento `view_item` no contribuyen a los ingresos. * Si estableces `value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`value`	`number`	Sí*	30.03	Es el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos de `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requiere `value` para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`customer_type`	`string` (`new` / `returning`)	No	nuevo	¿La conversión proviene de un cliente `nuevo` o `recurrente`? `new`: Cliente nuevo que no realizó una compra en un período determinado (se recomienda establecer un período de 540 días y configurar este valor de parámetro como predeterminado, pero no es obligatorio). `returning`: Un cliente recurrente que hizo una compra durante el período determinado. No especifiques un valor si no hay certeza (por ejemplo, si el usuario compró como invitado).
`transaction_id`	`string`	Sí	T_12345	Es el identificador único de una transacción. El parámetro `transaction_id` te ayuda a evitar recibir eventos duplicados por una compra.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el evento. Los parámetros `coupon` a nivel del evento y del artículo son independientes.
`shipping`	`number`	No	3.33	Es el costo de envío asociado a una transacción.
`tax`	`number`	No	1.11	Es el costo de impuestos asociado con una transacción.
`items`	`Array<Item>`	Sí		Son los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan and Friends	Se trata del nombre del artículo. *Se requiere `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física. Nota: `affiliation` solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Es el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del artículo son independientes.
`discount`	`number`	No	2.22	Es el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	Índice o posición del elemento en una lista.
`item_brand`	`string`	No	Google	Se refiere a la marca del artículo.
`item_category`	`string`	No	Indumentaria	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
`item_category2`	`string`	No	Adultos	Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
`item_category4`	`string`	No	Equipo de rodaje	Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_id` a nivel del evento. Si no se establece, se usa el `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_name` a nivel del evento. Si no se establece, se usa el `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	verde	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco)	Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: `location_id` solo está disponible en el alcance del elemento.
`price`	`number`	No	10.01	Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado. Si se aplica un descuento al artículo, establece `price` en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro `discount`.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: purchase

Artículos de comercio electrónico: ecommerce.items
ID de transacción de comercio electrónico: ecommerce.transaction_id
Valor del comercio electrónico: ecommerce.value
Impuestos de comercio electrónico: ecommerce.tax
Envío de comercio electrónico: ecommerce.shipping
Moneda de comercio electrónico: ecommerce.currency
Cupón de comercio electrónico: ecommerce.coupon

Parámetros del evento (nombre del parámetro - valor):

items: {{Artículos de comercio electrónico}}
transaction_id: {{ID de transacción de comercio electrónico}}
value: {{Valor de comercio electrónico}}
tax: {{Impuesto sobre el comercio electrónico}}
shipping: {{Ecommerce Shipping}}
currency: {{Moneda de comercio electrónico}}
coupon: {{Ecommerce Coupon}}

Activador: El evento es igual a compra

Configuración del activador:

Tipo de activador: Evento personalizado
Nombre del evento: purchase
Este activador se activa en todos los eventos personalizados.

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

`refund`

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras. * Las métricas de valor en el evento `view_item` no contribuyen a los ingresos. * Si estableces `value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`transaction_id`	`string`	Sí	T_12345	Es el identificador único de una transacción.
`value`	`number`	Sí*	30.03	Es el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos de `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requiere `value` para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el evento. Los parámetros `coupon` a nivel del evento y del artículo son independientes.
`shipping`	`number`	No	3.33	Es el costo de envío asociado a una transacción.
`tax`	`number`	No	1.11	Es el costo de impuestos asociado con una transacción.
`items`	`Array<Item>`	No*		Son los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan and Friends	Se trata del nombre del artículo. *Se requiere `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física. Nota: `affiliation` solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Es el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del artículo son independientes.
`discount`	`number`	No	2.22	Es el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	Índice o posición del elemento en una lista.
`item_brand`	`string`	No	Google	Se refiere a la marca del artículo.
`item_category`	`string`	No	Indumentaria	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
`item_category2`	`string`	No	Adultos	Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
`item_category4`	`string`	No	Equipo de rodaje	Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_id` a nivel del evento. Si no se establece, se usa el `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_name` a nivel del evento. Si no se establece, se usa el `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	verde	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco)	Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: `location_id` solo está disponible en el alcance del elemento.
`price`	`number`	No	10.01	Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado. Si se aplica un descuento al artículo, establece `price` en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro `discount`.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: refund
Variables de capa de datos (nombre - nombre de la variable de capa de datos):

Artículos de comercio electrónico: ecommerce.items
ID de transacción de comercio electrónico: ecommerce.transaction_id
Valor del comercio electrónico: ecommerce.value
Impuestos de comercio electrónico: ecommerce.tax
Envío de comercio electrónico: ecommerce.shipping
Moneda de comercio electrónico: ecommerce.currency
Cupón de comercio electrónico: ecommerce.coupon

Parámetros del evento (nombre del parámetro - valor):

items: {{Artículos de comercio electrónico}}
transaction_id: {{ID de transacción de comercio electrónico}}
value: {{Valor de comercio electrónico}}
tax: {{Impuesto sobre el comercio electrónico}}
shipping: {{Ecommerce Shipping}}
currency: {{Moneda de comercio electrónico}}
coupon: {{Ecommerce Coupon}}

Activador: El evento es igual a reembolso

Configuración del activador:

Tipo de activador: Evento personalizado
Nombre del evento: refund
Este activador se activa en todos los eventos personalizados.

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

`remove_from_cart`

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras. * Las métricas de valor en el evento `view_item` no contribuyen a los ingresos. * Si estableces `value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`value`	`number`	Sí*	30.03	Es el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos de `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requiere `value` para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`items`	`Array<Item>`	Sí		Son los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan and Friends	Se trata del nombre del artículo. *Se requiere `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física. Nota: `affiliation` solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Es el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del artículo son independientes.
`discount`	`number`	No	2.22	Es el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	Índice o posición del elemento en una lista.
`item_brand`	`string`	No	Google	Se refiere a la marca del artículo.
`item_category`	`string`	No	Indumentaria	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
`item_category2`	`string`	No	Adultos	Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
`item_category4`	`string`	No	Equipo de rodaje	Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_id` a nivel del evento. Si no se establece, se usa el `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_name` a nivel del evento. Si no se establece, se usa el `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	verde	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco)	Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: `location_id` solo está disponible en el alcance del elemento.
`price`	`number`	No	10.01	Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado. Si se aplica un descuento al artículo, establece `price` en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro `discount`.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: remove_from_cart
Variables de capa de datos (nombre - nombre de la variable de capa de datos):

Artículos de comercio electrónico: ecommerce.items
Valor del comercio electrónico: ecommerce.value
Moneda de comercio electrónico: ecommerce.currency

Parámetros del evento (nombre del parámetro - valor):

items: {{Artículos de comercio electrónico}}
value: {{Valor de comercio electrónico}}
currency: {{Moneda de comercio electrónico}}

Activador: El evento es igual a remove_from_cart

Configuración del activador:

Tipo de activador: Evento personalizado
Nombre del evento: remove_from_cart
Este activador se activa en todos los eventos personalizados.

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

`select_item`

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Se ignora si se configura a nivel del elemento.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Se ignora si se configura a nivel del elemento.
`items`	`Array<Item>`	Sí		Son los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan and Friends	Se trata del nombre del artículo. *Se requiere `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física. Nota: `affiliation` solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Es el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del artículo son independientes.
`discount`	`number`	No	2.22	Es el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	Índice o posición del elemento en una lista.
`item_brand`	`string`	No	Google	Se refiere a la marca del artículo.
`item_category`	`string`	No	Indumentaria	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
`item_category2`	`string`	No	Adultos	Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
`item_category4`	`string`	No	Equipo de rodaje	Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_id` a nivel del evento. Si no se establece, se usa el `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_name` a nivel del evento. Si no se establece, se usa el `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	verde	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco)	Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: `location_id` solo está disponible en el alcance del elemento.
`price`	`number`	No	10.01	Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado. Si se aplica un descuento al artículo, establece `price` en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro `discount`.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: select_item
Variables de capa de datos (nombre - nombre de la variable de capa de datos):

Artículos de comercio electrónico: ecommerce.items
ID de la lista de artículos de comercio electrónico: ecommerce.item_list_id
Nombre de la lista de artículos de comercio electrónico: ecommerce.item_list_name

Parámetros del evento (nombre del parámetro - valor):

items: {{Artículos de comercio electrónico}}
item_list_id: {{ID de la lista de artículos de comercio electrónico}}
item_list_name: {{Nombre de la lista de artículos de comercio electrónico}}

Activador: El evento es igual a select_item

Configuración del activador:

Tipo de activador: Evento personalizado
Nombre del evento: select_item
Este activador se activa en todos los eventos personalizados.

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_item",
  ecommerce: {
    currency: "USD",
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`select_promotion`

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad de promoción.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad de promoción asociado al evento.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada al evento.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada al evento.
`items`	`Array<Item>`	No*		Son los elementos del evento. * Si no se incluye el array `items`, algunos informes, como el informe de Promociones, y las métricas no incluirán este evento de promoción.

Para completar las dimensiones de promoción centradas en el artículo, como "ID de promoción del artículo" o "Nombre de promoción del artículo", en los informes de Google Analytics, primero se buscan los parámetros de promoción correspondientes (promotion_id, promotion_name, creative_name y creative_slot) dentro de cada objeto específico del array items de tus eventos de comercio electrónico. Si no se encuentra un parámetro dentro del objeto del elemento, Google Analytics usará el valor del parámetro a *nivel del evento* si se proporciona uno. Una dimensión de promoción centrada en el artículo para un elemento en particular solo se registrará como "(not set)" si falta el parámetro pertinente tanto en el objeto del elemento como en los parámetros a nivel del evento. Los parámetros a nivel del elemento siempre tienen prioridad sobre los parámetros a nivel del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan and Friends	Se trata del nombre del artículo. *Se requiere `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física. Nota: `affiliation` solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Es el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del artículo son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad de promoción. Si no se configura, el valor predeterminado es `creative_name` a nivel del evento.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad de promoción asociado al elemento. Si no se configura, el valor predeterminado es `creative_slot` a nivel del evento.
`discount`	`number`	No	2.22	Es el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	Índice o posición del elemento en una lista.
`item_brand`	`string`	No	Google	Se refiere a la marca del artículo.
`item_category`	`string`	No	Indumentaria	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
`item_category2`	`string`	No	Adultos	Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
`item_category4`	`string`	No	Equipo de rodaje	Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_id` a nivel del evento. Si no se establece, se usa el `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_name` a nivel del evento. Si no se establece, se usa el `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	verde	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco)	Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: `location_id` solo está disponible en el alcance del elemento.
`price`	`number`	No	10.01	Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado. Si se aplica un descuento al artículo, establece `price` en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada al artículo. Si no se configura, el valor predeterminado es `promotion_id` a nivel del evento.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada al artículo. Si no se configura, el valor predeterminado es `promotion_name` a nivel del evento.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: select_promotion
Variables de capa de datos (nombre - nombre de la variable de capa de datos):

Nombre de la creatividad de comercio electrónico: ecommerce.creative_name
Espacio creativo de comercio electrónico: ecommerce.creative_slot
ID de promoción de comercio electrónico: ecommerce.promotion_id
Nombre de la promoción de comercio electrónico: ecommerce.promotion_name
Artículos de comercio electrónico: ecommerce.items

Parámetros del evento (nombre del parámetro - valor):

creative_name: {{Nombre de la creatividad de comercio electrónico}}
creative_slot: {{Espacio para creatividad de comercio electrónico}}
promotion_id: {{ID de promoción de comercio electrónico}}
promotion_name: {{Nombre de la promoción de comercio electrónico}}
items: {{Artículos de comercio electrónico}}

Activador: El evento es igual a select_promotion

Configuración del activador:

Tipo de activador: Evento personalizado
Nombre del evento: select_promotion
Este activador se activa en todos los eventos personalizados.

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_promotion",
  ecommerce: {
    currency: "USD",
    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",
      creative_name: "summer_banner2",
      creative_slot: "featured_app_1",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

`view_cart`

Este evento indica que un usuario vio su carrito.

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras. * Las métricas de valor en el evento `view_item` no contribuyen a los ingresos. * Si estableces `value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`value`	`number`	Sí*	30.03	Es el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos de `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requiere `value` para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`items`	`Array<Item>`	Sí		Son los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan and Friends	Se trata del nombre del artículo. *Se requiere `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física. Nota: `affiliation` solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Es el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del artículo son independientes.
`discount`	`number`	No	2.22	Es el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	Índice o posición del elemento en una lista.
`item_brand`	`string`	No	Google	Se refiere a la marca del artículo.
`item_category`	`string`	No	Indumentaria	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
`item_category2`	`string`	No	Adultos	Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
`item_category4`	`string`	No	Equipo de rodaje	Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_id` a nivel del evento. Si no se establece, se usa el `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_name` a nivel del evento. Si no se establece, se usa el `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	verde	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco)	Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: `location_id` solo está disponible en el alcance del elemento.
`price`	`number`	No	10.01	Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado. Si se aplica un descuento al artículo, establece `price` en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro `discount`.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: view_cart
Variables de capa de datos (nombre - nombre de la variable de capa de datos):

Artículos de comercio electrónico: ecommerce.items
Valor del comercio electrónico: ecommerce.value
Moneda de comercio electrónico: ecommerce.currency

Parámetros del evento (nombre del parámetro - valor):

items: {{Artículos de comercio electrónico}}
value: {{Valor de comercio electrónico}}
currency: {{Moneda del comercio electrónico}}

Activador: El evento es igual a view_cart

Configuración del activador:

Tipo de activador: Evento personalizado
Nombre del evento: view_cart
Este activador se activa en todos los eventos personalizados.

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

`view_item`

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras. * Las métricas de valor en el evento `view_item` no contribuyen a los ingresos. * Si estableces `value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`value`	`number`	Sí*	30.03	Es el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos de `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requiere `value` para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`items`	`Array<Item>`	Sí		Son los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan and Friends	Se trata del nombre del artículo. *Se requiere `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física. Nota: `affiliation` solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Es el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del artículo son independientes.
`discount`	`number`	No	2.22	Es el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	Índice o posición del elemento en una lista.
`item_brand`	`string`	No	Google	Se refiere a la marca del artículo.
`item_category`	`string`	No	Indumentaria	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
`item_category2`	`string`	No	Adultos	Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
`item_category4`	`string`	No	Equipo de rodaje	Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_id` a nivel del evento. Si no se establece, se usa el `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_name` a nivel del evento. Si no se establece, se usa el `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	verde	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco)	Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: `location_id` solo está disponible en el alcance del elemento.
`price`	`number`	No	10.01	Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado. Si se aplica un descuento al artículo, establece `price` en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro `discount`.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: view_item
Variables de capa de datos (nombre - nombre de la variable de capa de datos):

Artículos de comercio electrónico: ecommerce.items
Valor del comercio electrónico: ecommerce.value
Moneda de comercio electrónico: ecommerce.currency

Parámetros del evento (nombre del parámetro - valor):

items: {{Artículos de comercio electrónico}}
value: {{Valor de comercio electrónico}}
currency: {{Moneda del comercio electrónico}}

Activador: El evento es igual a view_item

Configuración del activador:

Tipo de activador: Evento personalizado
Nombre del evento: view_item
Este activador se activa en todos los eventos personalizados.

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

`view_item_list`

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras. Las métricas de valor en el evento `view_item` no contribuyen a los ingresos * Si estableces `value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Se ignora si se configura a nivel del elemento.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Se ignora si se configura a nivel del elemento.
`items`	`Array<Item>`	Sí		Son los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan and Friends	Se trata del nombre del artículo. *Se requiere `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física. Nota: `affiliation` solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Es el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del artículo son independientes.
`discount`	`number`	No	2.22	Es el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	Índice o posición del elemento en una lista.
`item_brand`	`string`	No	Google	Se refiere a la marca del artículo.
`item_category`	`string`	No	Indumentaria	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
`item_category2`	`string`	No	Adultos	Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
`item_category4`	`string`	No	Equipo de rodaje	Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_id` a nivel del evento. Si no se establece, se usa el `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_name` a nivel del evento. Si no se establece, se usa el `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	verde	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco)	Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: `location_id` solo está disponible en el alcance del elemento.
`price`	`number`	No	10.01	Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado. Si se aplica un descuento al artículo, establece `price` en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro `discount`.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: view_item_list
Variables de capa de datos (nombre - nombre de la variable de capa de datos):

Artículos de comercio electrónico: ecommerce.items
ID de la lista de artículos de comercio electrónico: ecommerce.item_list_id
Nombre de la lista de artículos de comercio electrónico: ecommerce.item_list_name

Parámetros del evento (nombre del parámetro - valor):

items: {{Artículos de comercio electrónico}}
item_list_id: {{ID de la lista de artículos de comercio electrónico}}
item_list_name: {{Nombre de la lista de artículos de comercio electrónico}}

Activador: El evento es igual a view_item_list

Configuración del activador:

Tipo de activador: Evento personalizado
Nombre del evento: view_item_list
Este activador se activa en todos los eventos personalizados.

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

`view_promotion`

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad de promoción.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad de promoción asociado al evento.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada al evento.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada al evento.
`items`	`Array<Item>`	Sí		Son los elementos del evento.

Para completar las dimensiones de promoción centradas en el artículo, como "ID de promoción del artículo" o "Nombre de promoción del artículo", en los informes de Google Analytics, primero se buscan los parámetros de promoción correspondientes (promotion_id, promotion_name, creative_name y creative_slot) dentro de cada objeto específico del array items de tus eventos de comercio electrónico. Si no se encuentra un parámetro dentro del objeto del elemento, Google Analytics usará el valor del parámetro a *nivel del evento* si se proporciona uno. Las dimensiones de promoción centradas en el artículo para un artículo en particular solo se registrarán como "(not set)" si falta el parámetro pertinente tanto en el objeto del artículo como en los parámetros a nivel del evento. Los parámetros a nivel del elemento siempre tienen prioridad sobre los parámetros a nivel del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan and Friends	Se trata del nombre del artículo. *Se requiere `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Es la afiliación de un producto para designar la empresa que lo proporciona o la ubicación de la tienda física. Nota: `affiliation` solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Es el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del artículo son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad de promoción. Si no se configura, el valor predeterminado es `creative_name` a nivel del evento.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad de promoción asociado al elemento. Si no se configura, el valor predeterminado es `creative_slot` a nivel del evento.
`discount`	`number`	No	2.22	Es el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	Índice o posición del elemento en una lista.
`item_brand`	`string`	No	Google	Se refiere a la marca del artículo.
`item_category`	`string`	No	Indumentaria	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
`item_category2`	`string`	No	Adultos	Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
`item_category4`	`string`	No	Equipo de rodaje	Es la cuarta jerarquía de categorías o taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la quinta jerarquía de categorías o taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_id` a nivel del evento. Si no se establece, se usa el `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se configura, se ignora el parámetro `item_list_name` a nivel del evento. Si no se establece, se usa el `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	verde	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco)	Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: `location_id` solo está disponible en el alcance del elemento.
`price`	`number`	No	10.01	Es el precio unitario monetario del artículo, en unidades del parámetro de moneda especificado. Si se aplica un descuento al artículo, establece `price` en el precio unitario con descuento y especifica el descuento del precio unitario en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada al artículo. Si no se configura, el valor predeterminado es `promotion_id` a nivel del evento.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada al artículo. Si no se configura, el valor predeterminado es `promotion_name` a nivel del evento.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

Además de los parámetros prescritos, puedes incluir hasta 27 parámetros personalizados en el array items.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: view_promotion
Variables de capa de datos (nombre - nombre de la variable de capa de datos):

Nombre de la creatividad de comercio electrónico: ecommerce.creative_name
Espacio creativo de comercio electrónico: ecommerce.creative_slot
ID de promoción de comercio electrónico: ecommerce.promotion_id
Nombre de la promoción de comercio electrónico: ecommerce.promotion_name
Artículos de comercio electrónico: ecommerce.items

Parámetros del evento (nombre del parámetro - valor):

creative_name: {{Nombre de la creatividad de comercio electrónico}}
creative_slot: {{Espacio para creatividad de comercio electrónico}}
promotion_id: {{ID de promoción de comercio electrónico}}
promotion_name: {{Nombre de la promoción de comercio electrónico}}
items: {{Artículos de comercio electrónico}}

Activador: El evento es igual a view_promotion

Configuración del activador:

Tipo de activador: Evento personalizado
Nombre del evento: view_promotion
Este activador se activa en todos los eventos personalizados.

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_promotion",
  ecommerce: {
    currency: "USD",
    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",
      creative_name: "summer_banner2",
      creative_slot: "featured_app_1",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      google_business_vertical: "retail",
      quantity: 3
    }
    ]
  }
});

Videojuegos

`level_end`

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

Parámetros

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

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: level_end
Parámetros del evento (nombre del parámetro - valor):

level_name: Comienza el viaje…
success: true

Se activa cuando un jugador llega al final de un nivel (p. ej., la página de confirmación del nivel).

`level_start`

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

Parámetros

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

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: level_start
Parámetros del evento (nombre del parámetro - valor):

level_name: Comienza el viaje…

Se activa cuando alguien comienza un nivel nuevo (p.ej., la página de inicio del nivel)

`level_up`

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

Parámetros

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

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: level_up
Parámetros del evento (nombre del parámetro - valor):

level - 5
character: Jugador 1

Se activa cuando un jugador sube de nivel

`post_score`

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

Parámetros

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

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: post_score
Parámetros del evento (nombre del parámetro - valor):

score - 10000
level - 5
character: Jugador 1

Se activa cuando el usuario publica una puntuación.

`unlock_achievement`

Registra este evento cuando el usuario desbloqueó un logro. Este evento puede ayudarte a comprender cómo los usuarios experimentan tu juego.

Parámetros

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

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: unlock_achievement
Parámetros del evento (nombre del parámetro - valor):

achievement_id - A_12345

Se activa cuando un usuario desbloqueó un logro.

Generación de clientes potenciales

`close_convert_lead`

Registra este evento cuando un cliente potencial calificado se convierta correctamente en cliente. Por lo general, esto indica el final del proceso de desarrollo de clientes potenciales, por ejemplo, cuando se firma un contrato, comienza una suscripción pagada o se completa una venta final.

Nota: Para hacer un seguimiento de la adquisición inicial de clientes potenciales, como los envíos de formularios, los registros en boletines informativos o las solicitudes de demostración, usa el evento generate_lead.

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	No	USD	Es la moneda del valor asociado a la conversión (como el valor del contrato), en formato ISO 4217 de 3 letras. Es obligatorio si se configura `value`.
`value`	`number`	No	2,500	Es el valor monetario de la conversión, como el importe del primer pago o el valor del contrato. Es obligatoria si se configura `currency`.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: close_convert_lead
Parámetros del evento (nombre del parámetro - valor):

currency, USD
value - 30.03

Activa el evento cuando el usuario se convirtió en un cliente potencial que generó una conversión (un cliente)

`close_unconvert_lead`

Este evento mide cuando un usuario se marca como que no se convertirá en un lead que generó una conversión, junto con el motivo.

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda del `value` del evento, en formato ISO 4217 de 3 letras. * Si estableces `value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`value`	`number`	Sí*	30.03	Es el valor monetario del evento. * Por lo general, se requiere `value` para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`unconvert_lead_reason`	`string`	No	Nunca respondió	Es el motivo por el que no se generó una conversión del cliente potencial.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: close_unconvert_lead
Parámetros del evento (nombre del parámetro - valor):

currency, USD
value - 30.03

Activa el evento cuando se marca a un usuario como un cliente potencial que no generó una conversión por uno de varios motivos.

`disqualify_lead`

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda del `value` del evento, en formato ISO 4217 de 3 letras. * Si estableces `value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`value`	`number`	Sí*	30.03	Es el valor monetario del evento. * Por lo general, se requiere `value` para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`disqualified_lead_reason`	`string`	No	No quiero comprar	Es el motivo por el que un cliente potencial se marcó como descalificado.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: disqualify_lead
Parámetros del evento (nombre del parámetro - valor):

currency, USD
value - 30.03
disqualified_lead_reason: No quiero comprar

Activa el evento cuando se marca a un usuario como no calificado para convertirse en cliente potencial por uno de varios motivos.

`generate_lead`

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda del `value` del evento, en formato ISO 4217 de 3 letras. * Si estableces `value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`value`	`number`	Sí*	30.03	Es el valor monetario del evento. * Por lo general, se requiere `value` para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`lead_source`	`string`	No	Feria comercial	Es la fuente del cliente potencial.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: generate_lead
Parámetros del evento (nombre del parámetro - valor):

currency, USD
value - 30.03
lead_source: Feria comercial

Activa el evento cuando se genere un cliente potencial

`qualify_lead`

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda del `value` del evento, en formato ISO 4217 de 3 letras. * Si estableces `value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`value`	`number`	Sí*	30.03	Es el valor monetario del evento. * Por lo general, se requiere `value` para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas `value`. * `currency` es obligatorio si configuras `value`.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: qualify_lead
Parámetros del evento (nombre del parámetro - valor):

currency, USD
value - 30.03

Activa el evento cuando se marque a un usuario como apto para convertirse en cliente potencial calificado.

`working_lead`

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda del `value` del evento, en formato ISO 4217 de 3 letras. * Si estableces `value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`value`	`number`	Sí*	30.03	Es el valor monetario del evento. * Por lo general, se requiere `value` para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`lead_status`	`string`	No	Conversaciones iniciadas	Es el estado del cliente potencial.

Ejemplo

El siguiente ejemplo es para implementaciones de Tag Manager:

Muéstrame la configuración de la etiqueta

Configuración de la etiqueta:

Tipo de etiqueta: Evento de GA4
Nombre del evento: working_lead
Parámetros del evento (nombre del parámetro - valor):

currency, USD
value - 30.03
lead_status: Conversaciones iniciadas

Activa el evento cuando un usuario se comunica con un representante o un representante se comunica con él.

Eventos recomendados Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Para todas las propiedades

earn_virtual_currency

Parámetros

Ejemplo

Muéstrame la configuración de la etiqueta

join_group

Parámetros

Ejemplo

Muéstrame la configuración de la etiqueta

login

Parámetros

Ejemplo

Muéstrame la configuración de la etiqueta

search

Parámetros

Muéstrame la configuración de la etiqueta

Ejemplo

Muéstrame la configuración de la etiqueta

select_content

Parámetros

Ejemplo

Muéstrame la configuración de la etiqueta

share

Parámetros

Muéstrame la configuración de la etiqueta

Ejemplo

Muéstrame la configuración de la etiqueta

sign_up

Parámetros

Ejemplo

Muéstrame la configuración de la etiqueta

spend_virtual_currency

Parámetros

Ejemplo

Muéstrame la configuración de la etiqueta

tutorial_begin

Parámetros

Ejemplo

Muéstrame la configuración de la etiqueta

tutorial_complete

Parámetros

Ejemplo

Muéstrame la configuración de la etiqueta

Ventas en línea

add_payment_info

Parámetros

Parámetros de elementos

Ejemplo

Muéstrame la configuración de la etiqueta

add_shipping_info

Parámetros

Parámetros de elementos

Ejemplo

Muéstrame la configuración de la etiqueta

add_to_cart

Parámetros

Parámetros de elementos

Ejemplo

Muéstrame la configuración de la etiqueta

add_to_wishlist

Parámetros

Parámetros de elementos

Ejemplo

Muéstrame la configuración de la etiqueta

begin_checkout

Parámetros

Parámetros de elementos

Ejemplo

Muéstrame la configuración de la etiqueta

purchase

Parámetros

Parámetros de elementos

Ejemplo

Muéstrame la configuración de la etiqueta

refund

Parámetros

Parámetros de elementos

Ejemplo

Muéstrame la configuración de la etiqueta

Eventos recomendados

`earn_virtual_currency`

`join_group`

`login`

`search`

`select_content`

`share`

`sign_up`

`spend_virtual_currency`

`tutorial_begin`

`tutorial_complete`

`add_payment_info`

`add_shipping_info`

`add_to_cart`

`add_to_wishlist`

`begin_checkout`

`purchase`

`refund`

`remove_from_cart`

`select_item`

`select_promotion`

`view_cart`

`view_item`

`view_item_list`

`view_promotion`

`level_end`

`level_start`

`level_up`

`post_score`

`unlock_achievement`

`close_convert_lead`

`close_unconvert_lead`

`disqualify_lead`

`generate_lead`