Se usó la API de Cloud Translation para traducir esta página.

Eventos

ad_impression

Usa este evento cuando un usuario vea una impresión de anuncios.

Un ad_impression enviado con el Protocolo de medición no se incluirá en las exportaciones a otras plataformas publicitarias, como Google Ads.
Enviar eventos de ad_impression con el Protocolo de medición puede generar impresiones duplicadas si configuraste el etiquetado o el SDK para tus productos publicitarios de Google vinculados. Solo envía un evento ad_impression con el Protocolo de medición si el evento no se capturó mediante el etiquetado ni el SDK.

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`ad_platform`	`string`	No	MoPub	Es la plataforma de anuncios.
`ad_source`	`string`	No	AdColony	Es la fuente del anuncio.
`ad_format`	`string`	No	Banner	Es el formato del anuncio.
`ad_unit_name`	`string`	No	Banner_03	Es el nombre de la unidad de anuncios.
`currency`	`string`	No	USD	Es la moneda de los elementos asociados con el 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`	No	3.99	Es el valor de la impresión de anuncios. * Por lo general, se requieren `value` para generar informes significativos. * `currency` es obligatorio si configuras `value`.

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events":[{
      "name":"ad_impression",
      "params":{
        "ad_platform": "MoPub",
        "ad_source": "AdColony",
        "ad_format": "Banner",
        "ad_unit_name": "Banner_03",
        "currency": "USD",
        "value": 3.99
      }
    }]
  })
});

add_payment_info

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Es la moneda de los elementos asociados con el 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	Indica el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos en `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requieren `value` para generar informes significativos. Si marcas el evento como una conversión, se recomienda que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el evento. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`payment_type`	`string`	No	Credit Card	Indica la forma de pago elegida.
`items`	`Array<Item>`	Sí		Los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan y sus amigos	Se trata del nombre del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Afiliación de un producto para designar la empresa proveedora o la ubicación de la tienda física Nota: La "afiliación" solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Si se establece, se ignorará `creative_name` a nivel del evento. Si no se establece, se usa `creative_name` a nivel del evento, si está presente.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el artículo. Si se establece, se ignorará `creative_slot` a nivel del evento. Si no se establece, se usa `creative_slot` a nivel del evento, si está presente.
`discount`	`number`	No	2.22	Indica el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	El índice/posición del elemento en una lista.
`item_brand`	`string`	No	Servicios	Se refiere a la marca del artículo.
`item_category`	`string`	No	Apparel	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera.
`item_category2`	`string`	No	Adult	Es la jerarquía de segunda categoría o la taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	La jerarquía de tercera categoría o la taxonomía adicional del artículo
`item_category4`	`string`	No	Equipo de rodaje	Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la jerarquía de quinta categoría o la taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_id` a nivel del evento. Si no se establece, se usa `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_name` a nivel del evento. Si no se establece, se usa `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	green	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco)	Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Te recomendamos usar el ID de lugar de Google que corresponda al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: El atributo “ID de ubicación” solo está disponible en el alcance del artículo.
`price`	`number`	No	10:01	Es el precio unitario monetario del artículo, expresado en unidades 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 en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_id` a nivel del evento. Si no se establece, se usa `promotion_id` a nivel del evento, si está presente.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_name` a nivel del evento. Si no se establece, se usa `promotion_name` a nivel del evento, si está presente.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_payment_info",
      "params": {
        "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",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_shipping_info

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Es la moneda de los elementos asociados con el 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	Indica el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos en `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requieren `value` para generar informes significativos. Si marcas el evento como una conversión, se recomienda que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el evento. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`shipping_tier`	`string`	No	Terrestre	Indica el nivel de envío (p.ej., `Ground`, `Air` o `Next-day`) seleccionado para la entrega del artículo comprado.
`items`	`Array<Item>`	Sí		Los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan y sus amigos	Se trata del nombre del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Afiliación de un producto para designar la empresa proveedora o la ubicación de la tienda física Nota: La "afiliación" solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Si se establece, se ignorará `creative_name` a nivel del evento. Si no se establece, se usa `creative_name` a nivel del evento, si está presente.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el artículo. Si se establece, se ignorará `creative_slot` a nivel del evento. Si no se establece, se usa `creative_slot` a nivel del evento, si está presente.
`discount`	`number`	No	2.22	Indica el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	El índice/posición del elemento en una lista.
`item_brand`	`string`	No	Servicios	Se refiere a la marca del artículo.
`item_category`	`string`	No	Apparel	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera.
`item_category2`	`string`	No	Adult	Es la jerarquía de segunda categoría o la taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	La jerarquía de tercera categoría o la taxonomía adicional del artículo
`item_category4`	`string`	No	Equipo de rodaje	Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la jerarquía de quinta categoría o la taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_id` a nivel del evento. Si no se establece, se usa `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_name` a nivel del evento. Si no se establece, se usa `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	green	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco)	Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Te recomendamos usar el ID de lugar de Google que corresponda al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: El atributo “ID de ubicación” solo está disponible en el alcance del artículo.
`price`	`number`	No	10:01	Es el precio unitario monetario del artículo, expresado en unidades 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 en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_id` a nivel del evento. Si no se establece, se usa `promotion_id` a nivel del evento, si está presente.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_name` a nivel del evento. Si no se establece, se usa `promotion_name` a nivel del evento, si está presente.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_shipping_info",
      "params": {
        "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",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_cart

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Es la moneda de los elementos asociados con el 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	Indica el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos en `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requieren `value` para generar informes significativos. Si marcas el evento como una conversión, se recomienda que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`items`	`Array<Item>`	Sí		Los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan y sus amigos	Se trata del nombre del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Afiliación de un producto para designar la empresa proveedora o la ubicación de la tienda física Nota: La "afiliación" solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Si se establece, se ignorará `creative_name` a nivel del evento. Si no se establece, se usa `creative_name` a nivel del evento, si está presente.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el artículo. Si se establece, se ignorará `creative_slot` a nivel del evento. Si no se establece, se usa `creative_slot` a nivel del evento, si está presente.
`discount`	`number`	No	2.22	Indica el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	El índice/posición del elemento en una lista.
`item_brand`	`string`	No	Servicios	Se refiere a la marca del artículo.
`item_category`	`string`	No	Apparel	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera.
`item_category2`	`string`	No	Adult	Es la jerarquía de segunda categoría o la taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	La jerarquía de tercera categoría o la taxonomía adicional del artículo
`item_category4`	`string`	No	Equipo de rodaje	Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la jerarquía de quinta categoría o la taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_id` a nivel del evento. Si no se establece, se usa `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_name` a nivel del evento. Si no se establece, se usa `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	green	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco)	Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Te recomendamos usar el ID de lugar de Google que corresponda al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: El atributo “ID de ubicación” solo está disponible en el alcance del artículo.
`price`	`number`	No	10:01	Es el precio unitario monetario del artículo, expresado en unidades 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 en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_id` a nivel del evento. Si no se establece, se usa `promotion_id` a nivel del evento, si está presente.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_name` a nivel del evento. Si no se establece, se usa `promotion_name` a nivel del evento, si está presente.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_wishlist

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Es la moneda de los elementos asociados con el 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	Indica el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos en `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requieren `value` para generar informes significativos. Si marcas el evento como una conversión, se recomienda que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`items`	`Array<Item>`	Sí		Los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan y sus amigos	Se trata del nombre del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Afiliación de un producto para designar la empresa proveedora o la ubicación de la tienda física Nota: La "afiliación" solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Si se establece, se ignorará `creative_name` a nivel del evento. Si no se establece, se usa `creative_name` a nivel del evento, si está presente.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el artículo. Si se establece, se ignorará `creative_slot` a nivel del evento. Si no se establece, se usa `creative_slot` a nivel del evento, si está presente.
`discount`	`number`	No	2.22	Indica el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	El índice/posición del elemento en una lista.
`item_brand`	`string`	No	Servicios	Se refiere a la marca del artículo.
`item_category`	`string`	No	Apparel	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera.
`item_category2`	`string`	No	Adult	Es la jerarquía de segunda categoría o la taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	La jerarquía de tercera categoría o la taxonomía adicional del artículo
`item_category4`	`string`	No	Equipo de rodaje	Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la jerarquía de quinta categoría o la taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_id` a nivel del evento. Si no se establece, se usa `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_name` a nivel del evento. Si no se establece, se usa `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	green	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco)	Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Te recomendamos usar el ID de lugar de Google que corresponda al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: El atributo “ID de ubicación” solo está disponible en el alcance del artículo.
`price`	`number`	No	10:01	Es el precio unitario monetario del artículo, expresado en unidades 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 en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_id` a nivel del evento. Si no se establece, se usa `promotion_id` a nivel del evento, si está presente.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_name` a nivel del evento. Si no se establece, se usa `promotion_name` a nivel del evento, si está presente.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_wishlist",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

begin_checkout

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Es la moneda de los elementos asociados con el 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	Indica el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos en `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requieren `value` para generar informes significativos. Si marcas el evento como una conversión, se recomienda que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el evento. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`items`	`Array<Item>`	Sí		Los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan y sus amigos	Se trata del nombre del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Afiliación de un producto para designar la empresa proveedora o la ubicación de la tienda física Nota: La "afiliación" solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Si se establece, se ignorará `creative_name` a nivel del evento. Si no se establece, se usa `creative_name` a nivel del evento, si está presente.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el artículo. Si se establece, se ignorará `creative_slot` a nivel del evento. Si no se establece, se usa `creative_slot` a nivel del evento, si está presente.
`discount`	`number`	No	2.22	Indica el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	El índice/posición del elemento en una lista.
`item_brand`	`string`	No	Servicios	Se refiere a la marca del artículo.
`item_category`	`string`	No	Apparel	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera.
`item_category2`	`string`	No	Adult	Es la jerarquía de segunda categoría o la taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	La jerarquía de tercera categoría o la taxonomía adicional del artículo
`item_category4`	`string`	No	Equipo de rodaje	Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la jerarquía de quinta categoría o la taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_id` a nivel del evento. Si no se establece, se usa `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_name` a nivel del evento. Si no se establece, se usa `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	green	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco)	Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Te recomendamos usar el ID de lugar de Google que corresponda al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: El atributo “ID de ubicación” solo está disponible en el alcance del artículo.
`price`	`number`	No	10:01	Es el precio unitario monetario del artículo, expresado en unidades 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 en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_id` a nivel del evento. Si no se establece, se usa `promotion_id` a nivel del evento, si está presente.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_name` a nivel del evento. Si no se establece, se usa `promotion_name` a nivel del evento, si está presente.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;


fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "begin_checkout",
      "params": {
        "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",
            "currency": "USD",
            "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
          }
        ]
      }
    }]
  })
});

campaign_details

Utiliza este evento para enviar los detalles de la campaña que se aplicarán a los eventos futuros.

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`campaign_id`	`string`	No	google_1234	El ID de la campaña.
`campaign`	`string`	No	Summer_fun	Es el nombre que se usa para identificar una promoción o una campaña estratégica específica.
`source`	`string`	No	google	Es la fuente de tráfico de la campaña (p. ej., google, correo electrónico, etcétera).
`medium`	`string`	No	cpc	El medio de la campaña (p. ej., correo electrónico, costo por clic, etcétera)
`term`	`string`	No	verano+viajes	Es el término de la campaña que se usa con la búsqueda pagada para proporcionar las palabras clave de los anuncios.
`content`	`string`	No	logolink	El contenido de la campaña que se utiliza en las pruebas A/B y los anuncios segmentados por contenido para diferenciar los anuncios o vínculos que dirigen a la misma URL.

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "campaign_details",
      "params": {
        "campaign_id": "google_1234",
        "campaign": "Summer_fun",
        "source": "google",
        "medium": "cpc",
        "term": "summer+travel",
        "content": "logolink"
      }
    }]
  })
});

close_convert_lead

Este evento mide cuándo un cliente potencial se convierte y se cierra (por ejemplo, mediante una compra).

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Es la moneda de los elementos asociados con el 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	Indica el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos en `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requieren `value` para generar informes significativos. Si marcas el evento como una conversión, se recomienda que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`items`	`Array<Item>`	No		Los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan y sus amigos	Se trata del nombre del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Afiliación de un producto para designar la empresa proveedora o la ubicación de la tienda física Nota: La "afiliación" solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Si se establece, se ignorará `creative_name` a nivel del evento. Si no se establece, se usa `creative_name` a nivel del evento, si está presente.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el artículo. Si se establece, se ignorará `creative_slot` a nivel del evento. Si no se establece, se usa `creative_slot` a nivel del evento, si está presente.
`discount`	`number`	No	2.22	Indica el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	El índice/posición del elemento en una lista.
`item_brand`	`string`	No	Servicios	Se refiere a la marca del artículo.
`item_category`	`string`	No	Apparel	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera.
`item_category2`	`string`	No	Adult	Es la jerarquía de segunda categoría o la taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	La jerarquía de tercera categoría o la taxonomía adicional del artículo
`item_category4`	`string`	No	Equipo de rodaje	Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la jerarquía de quinta categoría o la taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_id` a nivel del evento. Si no se establece, se usa `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_name` a nivel del evento. Si no se establece, se usa `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	green	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco)	Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Te recomendamos usar el ID de lugar de Google que corresponda al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: El atributo “ID de ubicación” solo está disponible en el alcance del artículo.
`price`	`number`	No	10:01	Es el precio unitario monetario del artículo, expresado en unidades 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 en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_id` a nivel del evento. Si no se establece, se usa `promotion_id` a nivel del evento, si está presente.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_name` a nivel del evento. Si no se establece, se usa `promotion_name` a nivel del evento, si está presente.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "close_convert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

close_unconvert_lead

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Es la moneda de los elementos asociados con el 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	Indica el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos en `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requieren `value` para generar informes significativos. Si marcas el evento como una conversión, se recomienda que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`unconvert_lead_reason`	`string`	No	Nunca respondió	El motivo por el que no se generó la conversión del cliente potencial.
`items`	`Array<Item>`	No		Los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan y sus amigos	Se trata del nombre del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Afiliación de un producto para designar la empresa proveedora o la ubicación de la tienda física Nota: La "afiliación" solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Si se establece, se ignorará `creative_name` a nivel del evento. Si no se establece, se usa `creative_name` a nivel del evento, si está presente.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el artículo. Si se establece, se ignorará `creative_slot` a nivel del evento. Si no se establece, se usa `creative_slot` a nivel del evento, si está presente.
`discount`	`number`	No	2.22	Indica el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	El índice/posición del elemento en una lista.
`item_brand`	`string`	No	Servicios	Se refiere a la marca del artículo.
`item_category`	`string`	No	Apparel	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera.
`item_category2`	`string`	No	Adult	Es la jerarquía de segunda categoría o la taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	La jerarquía de tercera categoría o la taxonomía adicional del artículo
`item_category4`	`string`	No	Equipo de rodaje	Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la jerarquía de quinta categoría o la taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_id` a nivel del evento. Si no se establece, se usa `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_name` a nivel del evento. Si no se establece, se usa `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	green	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco)	Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Te recomendamos usar el ID de lugar de Google que corresponda al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: El atributo “ID de ubicación” solo está disponible en el alcance del artículo.
`price`	`number`	No	10:01	Es el precio unitario monetario del artículo, expresado en unidades 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 en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_id` a nivel del evento. Si no se establece, se usa `promotion_id` a nivel del evento, si está presente.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_name` a nivel del evento. Si no se establece, se usa `promotion_name` a nivel del evento, si está presente.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "close_unconvert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "unconvert_lead_reason": "Never responded",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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
          }
        ]
      }
    }]
  })
});

disqualify_lead

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Es la moneda de los elementos asociados con el 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	Indica el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos en `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requieren `value` para generar informes significativos. Si marcas el evento como una conversión, se recomienda que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`disqualified_lead_reason`	`string`	No	No quiero hacer una compra	El motivo por el que se marcó a un cliente potencial como descalificado.
`items`	`Array<Item>`	No		Los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan y sus amigos	Se trata del nombre del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Afiliación de un producto para designar la empresa proveedora o la ubicación de la tienda física Nota: La "afiliación" solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Si se establece, se ignorará `creative_name` a nivel del evento. Si no se establece, se usa `creative_name` a nivel del evento, si está presente.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el artículo. Si se establece, se ignorará `creative_slot` a nivel del evento. Si no se establece, se usa `creative_slot` a nivel del evento, si está presente.
`discount`	`number`	No	2.22	Indica el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	El índice/posición del elemento en una lista.
`item_brand`	`string`	No	Servicios	Se refiere a la marca del artículo.
`item_category`	`string`	No	Apparel	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera.
`item_category2`	`string`	No	Adult	Es la jerarquía de segunda categoría o la taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	La jerarquía de tercera categoría o la taxonomía adicional del artículo
`item_category4`	`string`	No	Equipo de rodaje	Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la jerarquía de quinta categoría o la taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_id` a nivel del evento. Si no se establece, se usa `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_name` a nivel del evento. Si no se establece, se usa `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	green	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco)	Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Te recomendamos usar el ID de lugar de Google que corresponda al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: El atributo “ID de ubicación” solo está disponible en el alcance del artículo.
`price`	`number`	No	10:01	Es el precio unitario monetario del artículo, expresado en unidades 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 en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_id` a nivel del evento. Si no se establece, se usa `promotion_id` a nivel del evento, si está presente.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_name` a nivel del evento. Si no se establece, se usa `promotion_name` a nivel del evento, si está presente.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "disqualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "disqualified_lead_reason": "Not looking to buy",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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
          }
        ]
      }
    }]
  })
});

earn_virtual_currency

Este evento mide cuando un usuario obtiene moneda virtual en un juego. Registra esto 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	Indica el valor de la moneda virtual.

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "earn_virtual_currency",
      "params": {
        "virtual_currency_name": "Gems",
        "value": 5
      }
    }]
  })
});

generate_lead

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Es la moneda de los elementos asociados con el 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	Indica el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos en `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requieren `value` para generar informes significativos. Si marcas el evento como una conversión, se recomienda que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`lead_source`	`string`	No	Feria	Indica la fuente del cliente potencial.
`items`	`Array<Item>`	No		Los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan y sus amigos	Se trata del nombre del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Afiliación de un producto para designar la empresa proveedora o la ubicación de la tienda física Nota: La "afiliación" solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Si se establece, se ignorará `creative_name` a nivel del evento. Si no se establece, se usa `creative_name` a nivel del evento, si está presente.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el artículo. Si se establece, se ignorará `creative_slot` a nivel del evento. Si no se establece, se usa `creative_slot` a nivel del evento, si está presente.
`discount`	`number`	No	2.22	Indica el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	El índice/posición del elemento en una lista.
`item_brand`	`string`	No	Servicios	Se refiere a la marca del artículo.
`item_category`	`string`	No	Apparel	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera.
`item_category2`	`string`	No	Adult	Es la jerarquía de segunda categoría o la taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	La jerarquía de tercera categoría o la taxonomía adicional del artículo
`item_category4`	`string`	No	Equipo de rodaje	Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la jerarquía de quinta categoría o la taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_id` a nivel del evento. Si no se establece, se usa `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_name` a nivel del evento. Si no se establece, se usa `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	green	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco)	Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Te recomendamos usar el ID de lugar de Google que corresponda al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: El atributo “ID de ubicación” solo está disponible en el alcance del artículo.
`price`	`number`	No	10:01	Es el precio unitario monetario del artículo, expresado en unidades 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 en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_id` a nivel del evento. Si no se establece, se usa `promotion_id` a nivel del evento, si está presente.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_name` a nivel del evento. Si no se establece, se usa `promotion_name` a nivel del evento, si está presente.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "generate_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_source": "Trade show",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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
          }
        ]
      }
    }]
  })
});

join_group

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

Parámetros

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events":[{
      "name":"join_group",
      "params":{
        "group_id":"G_12345"
      }
    }]
  })
});

level_up

Este evento significa que un jugador subió de nivel en un juego. Úsalo para medir la distribución de los niveles de la base de usuarios y para identificar los niveles que sean difíciles de completar.

Parámetros

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "level_up",
      "params": {
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

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	Servicios	El método que se usa para acceder.

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "login",
      "params": {
        "method": "Google"
      }
    }]
  })
});

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 correlaciona las puntuaciones altas con el público o los comportamientos.

Parámetros

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "post_score",
      "params": {
        "score": 10000,
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

purchase

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Es la moneda de los elementos asociados con el 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	Indica el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos en `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requieren `value` para generar informes significativos. Si marcas el evento como una conversión, se recomienda que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`transaction_id`	`string`	Sí	T_12345	Es el identificador único de una transacción. El parámetro `transaction_id` te ayuda a evitar recibir eventos duplicados por una compra.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el evento. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`shipping`	`number`	No	3.33	Indica el costo de envío asociado a una transacción.
`tax`	`number`	No	1.11	Es el costo de impuestos asociado con una transacción.
`items`	`Array<Item>`	Sí		Los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan y sus amigos	Se trata del nombre del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Afiliación de un producto para designar la empresa proveedora o la ubicación de la tienda física Nota: La "afiliación" solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Si se establece, se ignorará `creative_name` a nivel del evento. Si no se establece, se usa `creative_name` a nivel del evento, si está presente.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el artículo. Si se establece, se ignorará `creative_slot` a nivel del evento. Si no se establece, se usa `creative_slot` a nivel del evento, si está presente.
`discount`	`number`	No	2.22	Indica el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	El índice/posición del elemento en una lista.
`item_brand`	`string`	No	Servicios	Se refiere a la marca del artículo.
`item_category`	`string`	No	Apparel	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera.
`item_category2`	`string`	No	Adult	Es la jerarquía de segunda categoría o la taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	La jerarquía de tercera categoría o la taxonomía adicional del artículo
`item_category4`	`string`	No	Equipo de rodaje	Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la jerarquía de quinta categoría o la taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_id` a nivel del evento. Si no se establece, se usa `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_name` a nivel del evento. Si no se establece, se usa `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	green	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco)	Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Te recomendamos usar el ID de lugar de Google que corresponda al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: El atributo “ID de ubicación” solo está disponible en el alcance del artículo.
`price`	`number`	No	10:01	Es el precio unitario monetario del artículo, expresado en unidades 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 en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_id` a nivel del evento. Si no se establece, se usa `promotion_id` a nivel del evento, si está presente.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_name` a nivel del evento. Si no se establece, se usa `promotion_name` a nivel del evento, si está presente.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "purchase",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "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",
            "currency": "USD",
            "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
          }
        ]
      }
    }]
  })
});

qualify_lead

Este evento mide cuando se marca que un usuario cumple con los criterios para convertirse en cliente potencial calificado.

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Es la moneda de los elementos asociados con el 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	Indica el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos en `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requieren `value` para generar informes significativos. Si marcas el evento como una conversión, se recomienda que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`items`	`Array<Item>`	No		Los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan y sus amigos	Se trata del nombre del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Afiliación de un producto para designar la empresa proveedora o la ubicación de la tienda física Nota: La "afiliación" solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Si se establece, se ignorará `creative_name` a nivel del evento. Si no se establece, se usa `creative_name` a nivel del evento, si está presente.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el artículo. Si se establece, se ignorará `creative_slot` a nivel del evento. Si no se establece, se usa `creative_slot` a nivel del evento, si está presente.
`discount`	`number`	No	2.22	Indica el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	El índice/posición del elemento en una lista.
`item_brand`	`string`	No	Servicios	Se refiere a la marca del artículo.
`item_category`	`string`	No	Apparel	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera.
`item_category2`	`string`	No	Adult	Es la jerarquía de segunda categoría o la taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	La jerarquía de tercera categoría o la taxonomía adicional del artículo
`item_category4`	`string`	No	Equipo de rodaje	Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la jerarquía de quinta categoría o la taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_id` a nivel del evento. Si no se establece, se usa `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_name` a nivel del evento. Si no se establece, se usa `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	green	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco)	Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Te recomendamos usar el ID de lugar de Google que corresponda al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: El atributo “ID de ubicación” solo está disponible en el alcance del artículo.
`price`	`number`	No	10:01	Es el precio unitario monetario del artículo, expresado en unidades 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 en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_id` a nivel del evento. Si no se establece, se usa `promotion_id` a nivel del evento, si está presente.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_name` a nivel del evento. Si no se establece, se usa `promotion_name` a nivel del evento, si está presente.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "qualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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
          }
        ]
      }
    }]
  })
});

refund

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Es la moneda de los elementos asociados con el 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.
`transaction_id`	`string`	Sí	T_12345	Es el identificador único de una transacción.
`value`	`number`	Sí*	30,03	Indica el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos en `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requieren `value` para generar informes significativos. Si marcas el evento como una conversión, se recomienda que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el evento. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`shipping`	`number`	No	3.33	Indica el costo de envío asociado a una transacción.
`tax`	`number`	No	1.11	Es el costo de impuestos asociado con una transacción.
`items`	`Array<Item>`	No*		Los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan y sus amigos	Se trata del nombre del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Afiliación de un producto para designar la empresa proveedora o la ubicación de la tienda física Nota: La "afiliación" solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Si se establece, se ignorará `creative_name` a nivel del evento. Si no se establece, se usa `creative_name` a nivel del evento, si está presente.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el artículo. Si se establece, se ignorará `creative_slot` a nivel del evento. Si no se establece, se usa `creative_slot` a nivel del evento, si está presente.
`discount`	`number`	No	2.22	Indica el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	El índice/posición del elemento en una lista.
`item_brand`	`string`	No	Servicios	Se refiere a la marca del artículo.
`item_category`	`string`	No	Apparel	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera.
`item_category2`	`string`	No	Adult	Es la jerarquía de segunda categoría o la taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	La jerarquía de tercera categoría o la taxonomía adicional del artículo
`item_category4`	`string`	No	Equipo de rodaje	Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la jerarquía de quinta categoría o la taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_id` a nivel del evento. Si no se establece, se usa `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_name` a nivel del evento. Si no se establece, se usa `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	green	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco)	Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Te recomendamos usar el ID de lugar de Google que corresponda al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: El atributo “ID de ubicación” solo está disponible en el alcance del artículo.
`price`	`number`	No	10:01	Es el precio unitario monetario del artículo, expresado en unidades 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 en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_id` a nivel del evento. Si no se establece, se usa `promotion_id` a nivel del evento, si está presente.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_name` a nivel del evento. Si no se establece, se usa `promotion_name` a nivel del evento, si está presente.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "refund",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "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",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

remove_from_cart

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Es la moneda de los elementos asociados con el 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	Indica el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos en `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requieren `value` para generar informes significativos. Si marcas el evento como una conversión, se recomienda que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`items`	`Array<Item>`	Sí		Los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan y sus amigos	Se trata del nombre del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Afiliación de un producto para designar la empresa proveedora o la ubicación de la tienda física Nota: La "afiliación" solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Si se establece, se ignorará `creative_name` a nivel del evento. Si no se establece, se usa `creative_name` a nivel del evento, si está presente.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el artículo. Si se establece, se ignorará `creative_slot` a nivel del evento. Si no se establece, se usa `creative_slot` a nivel del evento, si está presente.
`discount`	`number`	No	2.22	Indica el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	El índice/posición del elemento en una lista.
`item_brand`	`string`	No	Servicios	Se refiere a la marca del artículo.
`item_category`	`string`	No	Apparel	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera.
`item_category2`	`string`	No	Adult	Es la jerarquía de segunda categoría o la taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	La jerarquía de tercera categoría o la taxonomía adicional del artículo
`item_category4`	`string`	No	Equipo de rodaje	Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la jerarquía de quinta categoría o la taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_id` a nivel del evento. Si no se establece, se usa `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_name` a nivel del evento. Si no se establece, se usa `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	green	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco)	Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Te recomendamos usar el ID de lugar de Google que corresponda al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: El atributo “ID de ubicación” solo está disponible en el alcance del artículo.
`price`	`number`	No	10:01	Es el precio unitario monetario del artículo, expresado en unidades 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 en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_id` a nivel del evento. Si no se establece, se usa `promotion_id` a nivel del evento, si está presente.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_name` a nivel del evento. Si no se establece, se usa `promotion_name` a nivel del evento, si está presente.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "remove_from_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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
          }
        ]
      }
    }]
  })
});

screen_view

Usa este evento para indicar que se produjo una transición de pantalla.

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`screen_class`	`string`	No	MainActivity	Es la clase de la pantalla.
`screen_name`	`string`	No	Información	Es el nombre de la pantalla.

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "screen_view",
      "params": {
        "screen_class": "MainActivity",
        "screen_name": "About"
      }
    }]
  })
});

search

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

Parámetros

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "search",
      "params": {
        "search_term": "t-shirts"
      }
    }]
  })
});

select_content

Este evento significa que un usuario seleccionó cierto tipo de contenido. Este evento puede ayudarte a identificar contenido y categorías de contenido populares en tu sitio web o app.

Parámetros

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_content",
      "params": {
        "content_type": "product",
        "content_id": "C_12345"
      }
    }]
  })
});

select_item

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Se ignora si se establece a nivel del elemento.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Se ignora si se establece a nivel del elemento.
`items`	`Array<Item>`	Sí*		Los elementos del evento. * Se espera que el array `items` tenga un solo elemento que represente el elemento seleccionado. Si se proporcionan varios elementos, solo se usará el primero de `items`.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan y sus amigos	Se trata del nombre del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Afiliación de un producto para designar la empresa proveedora o la ubicación de la tienda física Nota: La "afiliación" solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Si se establece, se ignorará `creative_name` a nivel del evento. Si no se establece, se usa `creative_name` a nivel del evento, si está presente.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el artículo. Si se establece, se ignorará `creative_slot` a nivel del evento. Si no se establece, se usa `creative_slot` a nivel del evento, si está presente.
`discount`	`number`	No	2.22	Indica el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	El índice/posición del elemento en una lista.
`item_brand`	`string`	No	Servicios	Se refiere a la marca del artículo.
`item_category`	`string`	No	Apparel	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera.
`item_category2`	`string`	No	Adult	Es la jerarquía de segunda categoría o la taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	La jerarquía de tercera categoría o la taxonomía adicional del artículo
`item_category4`	`string`	No	Equipo de rodaje	Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la jerarquía de quinta categoría o la taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_id` a nivel del evento. Si no se establece, se usa `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_name` a nivel del evento. Si no se establece, se usa `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	green	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco)	Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Te recomendamos usar el ID de lugar de Google que corresponda al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: El atributo “ID de ubicación” solo está disponible en el alcance del artículo.
`price`	`number`	No	10:01	Es el precio unitario monetario del artículo, expresado en unidades 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 en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_id` a nivel del evento. Si no se establece, se usa `promotion_id` a nivel del evento, si está presente.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_name` a nivel del evento. Si no se establece, se usa `promotion_name` a nivel del evento, si está presente.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_item",
      "params": {
        "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",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_promotion

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Se ignora si se establece a nivel del elemento.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el evento. Se ignora si se establece a nivel del elemento.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el evento. Se ignora si se establece a nivel del elemento.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el evento. Se ignora si se establece a nivel del elemento.
`items`	`Array<Item>`	No		Los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan y sus amigos	Se trata del nombre del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Afiliación de un producto para designar la empresa proveedora o la ubicación de la tienda física Nota: La "afiliación" solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Si se establece, se ignorará `creative_name` a nivel del evento. Si no se establece, se usa `creative_name` a nivel del evento, si está presente.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el artículo. Si se establece, se ignorará `creative_slot` a nivel del evento. Si no se establece, se usa `creative_slot` a nivel del evento, si está presente.
`discount`	`number`	No	2.22	Indica el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	El índice/posición del elemento en una lista.
`item_brand`	`string`	No	Servicios	Se refiere a la marca del artículo.
`item_category`	`string`	No	Apparel	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera.
`item_category2`	`string`	No	Adult	Es la jerarquía de segunda categoría o la taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	La jerarquía de tercera categoría o la taxonomía adicional del artículo
`item_category4`	`string`	No	Equipo de rodaje	Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la jerarquía de quinta categoría o la taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_id` a nivel del evento. Si no se establece, se usa `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_name` a nivel del evento. Si no se establece, se usa `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	green	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco)	Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Te recomendamos usar el ID de lugar de Google que corresponda al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: El atributo “ID de ubicación” solo está disponible en el alcance del artículo.
`price`	`number`	No	10:01	Es el precio unitario monetario del artículo, expresado en unidades 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 en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_id` a nivel del evento. Si no se establece, se usa `promotion_id` a nivel del evento, si está presente.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_name` a nivel del evento. Si no se establece, se usa `promotion_name` a nivel del evento, si está presente.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_promotion",
      "params": {
        "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",
            "currency": "USD",
            "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",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

Usa este evento cuando un usuario comparta contenido.

Parámetros

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "share",
      "params": {
        "method": "Twitter",
        "content_type": "image",
        "item_id": "C_12345"
      }
    }]
  })
});

sign_up

Este evento indica que un usuario se registró en una cuenta. Usa este evento para comprender los diferentes comportamientos de los usuarios que accedieron y los que no.

Parámetros

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "sign_up",
      "params": {
        "method": "Google"
      }
    }]
  })
});

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	Indica el valor de la moneda virtual.
`virtual_currency_name`	`string`	Sí	Gems	Indica el nombre de la moneda virtual.
`item_name`	`string`	No	Refuerzo inicial	Es el nombre del elemento para el que se usa la moneda virtual.

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "spend_virtual_currency",
      "params": {
        "value": 5,
        "virtual_currency_name": "Gems",
        "item_name": "Starter Boost"
      }
    }]
  })
});

tutorial_begin

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

Parámetros

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

No hay parámetros para este evento.

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "tutorial_begin"
    }]
  })
});

tutorial_complete

Este evento indica que el usuario completa el proceso de integración. Usa esto en un embudo con tutorial_begin para comprender cuántos usuarios completan el instructivo.

Parámetros

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "tutorial_complete"
    }]
  })
});

unlock_achievement

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

Parámetros

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "unlock_achievement",
      "params": {
        "achievement_id": "A_12345"
      }
    }]
  })
});

view_cart

Este evento significa que un usuario vio su carrito.

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Es la moneda de los elementos asociados con el 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	Indica el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos en `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requieren `value` para generar informes significativos. Si marcas el evento como una conversión, se recomienda que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`items`	`Array<Item>`	Sí		Los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan y sus amigos	Se trata del nombre del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Afiliación de un producto para designar la empresa proveedora o la ubicación de la tienda física Nota: La "afiliación" solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Si se establece, se ignorará `creative_name` a nivel del evento. Si no se establece, se usa `creative_name` a nivel del evento, si está presente.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el artículo. Si se establece, se ignorará `creative_slot` a nivel del evento. Si no se establece, se usa `creative_slot` a nivel del evento, si está presente.
`discount`	`number`	No	2.22	Indica el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	El índice/posición del elemento en una lista.
`item_brand`	`string`	No	Servicios	Se refiere a la marca del artículo.
`item_category`	`string`	No	Apparel	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera.
`item_category2`	`string`	No	Adult	Es la jerarquía de segunda categoría o la taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	La jerarquía de tercera categoría o la taxonomía adicional del artículo
`item_category4`	`string`	No	Equipo de rodaje	Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la jerarquía de quinta categoría o la taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_id` a nivel del evento. Si no se establece, se usa `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_name` a nivel del evento. Si no se establece, se usa `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	green	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco)	Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Te recomendamos usar el ID de lugar de Google que corresponda al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: El atributo “ID de ubicación” solo está disponible en el alcance del artículo.
`price`	`number`	No	10:01	Es el precio unitario monetario del artículo, expresado en unidades 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 en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_id` a nivel del evento. Si no se establece, se usa `promotion_id` a nivel del evento, si está presente.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_name` a nivel del evento. Si no se establece, se usa `promotion_name` a nivel del evento, si está presente.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_cart",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_item

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Es la moneda de los elementos asociados con el 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	Indica el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos en `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requieren `value` para generar informes significativos. Si marcas el evento como una conversión, se recomienda que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`items`	`Array<Item>`	Sí		Los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan y sus amigos	Se trata del nombre del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Afiliación de un producto para designar la empresa proveedora o la ubicación de la tienda física Nota: La "afiliación" solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Si se establece, se ignorará `creative_name` a nivel del evento. Si no se establece, se usa `creative_name` a nivel del evento, si está presente.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el artículo. Si se establece, se ignorará `creative_slot` a nivel del evento. Si no se establece, se usa `creative_slot` a nivel del evento, si está presente.
`discount`	`number`	No	2.22	Indica el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	El índice/posición del elemento en una lista.
`item_brand`	`string`	No	Servicios	Se refiere a la marca del artículo.
`item_category`	`string`	No	Apparel	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera.
`item_category2`	`string`	No	Adult	Es la jerarquía de segunda categoría o la taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	La jerarquía de tercera categoría o la taxonomía adicional del artículo
`item_category4`	`string`	No	Equipo de rodaje	Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la jerarquía de quinta categoría o la taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_id` a nivel del evento. Si no se establece, se usa `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_name` a nivel del evento. Si no se establece, se usa `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	green	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco)	Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Te recomendamos usar el ID de lugar de Google que corresponda al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: El atributo “ID de ubicación” solo está disponible en el alcance del artículo.
`price`	`number`	No	10:01	Es el precio unitario monetario del artículo, expresado en unidades 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 en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_id` a nivel del evento. Si no se establece, se usa `promotion_id` a nivel del evento, si está presente.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_name` a nivel del evento. Si no se establece, se usa `promotion_name` a nivel del evento, si está presente.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ],
      }
    }]
  })
});

view_item_list

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

Parámetros

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

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan y sus amigos	Se trata del nombre del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Afiliación de un producto para designar la empresa proveedora o la ubicación de la tienda física Nota: La "afiliación" solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Si se establece, se ignorará `creative_name` a nivel del evento. Si no se establece, se usa `creative_name` a nivel del evento, si está presente.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el artículo. Si se establece, se ignorará `creative_slot` a nivel del evento. Si no se establece, se usa `creative_slot` a nivel del evento, si está presente.
`discount`	`number`	No	2.22	Indica el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	El índice/posición del elemento en una lista.
`item_brand`	`string`	No	Servicios	Se refiere a la marca del artículo.
`item_category`	`string`	No	Apparel	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera.
`item_category2`	`string`	No	Adult	Es la jerarquía de segunda categoría o la taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	La jerarquía de tercera categoría o la taxonomía adicional del artículo
`item_category4`	`string`	No	Equipo de rodaje	Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la jerarquía de quinta categoría o la taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_id` a nivel del evento. Si no se establece, se usa `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_name` a nivel del evento. Si no se establece, se usa `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	green	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco)	Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Te recomendamos usar el ID de lugar de Google que corresponda al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: El atributo “ID de ubicación” solo está disponible en el alcance del artículo.
`price`	`number`	No	10:01	Es el precio unitario monetario del artículo, expresado en unidades 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 en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_id` a nivel del evento. Si no se establece, se usa `promotion_id` a nivel del evento, si está presente.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_name` a nivel del evento. Si no se establece, se usa `promotion_name` a nivel del evento, si está presente.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item_list",
      "params": {
        "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",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_promotion

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Se ignora si se establece a nivel del elemento.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el evento. Se ignora si se establece a nivel del elemento.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el evento. Se ignora si se establece a nivel del elemento.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el evento. Se ignora si se establece a nivel del elemento.
`items`	`Array<Item>`	Sí*		Los elementos del evento. * Se espera que el array `items` tenga un solo elemento que represente el elemento asociado con la promoción. Si se proporcionan varios elementos, solo se usará el primero de `items`.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan y sus amigos	Se trata del nombre del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Afiliación de un producto para designar la empresa proveedora o la ubicación de la tienda física Nota: La "afiliación" solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Si se establece, se ignorará `creative_name` a nivel del evento. Si no se establece, se usa `creative_name` a nivel del evento, si está presente.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el artículo. Si se establece, se ignorará `creative_slot` a nivel del evento. Si no se establece, se usa `creative_slot` a nivel del evento, si está presente.
`discount`	`number`	No	2.22	Indica el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	El índice/posición del elemento en una lista.
`item_brand`	`string`	No	Servicios	Se refiere a la marca del artículo.
`item_category`	`string`	No	Apparel	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera.
`item_category2`	`string`	No	Adult	Es la jerarquía de segunda categoría o la taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	La jerarquía de tercera categoría o la taxonomía adicional del artículo
`item_category4`	`string`	No	Equipo de rodaje	Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la jerarquía de quinta categoría o la taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_id` a nivel del evento. Si no se establece, se usa `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_name` a nivel del evento. Si no se establece, se usa `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	green	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco)	Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Te recomendamos usar el ID de lugar de Google que corresponda al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: El atributo “ID de ubicación” solo está disponible en el alcance del artículo.
`price`	`number`	No	10:01	Es el precio unitario monetario del artículo, expresado en unidades 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 en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_id` a nivel del evento. Si no se establece, se usa `promotion_id` a nivel del evento, si está presente.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_name` a nivel del evento. Si no se establece, se usa `promotion_name` a nivel del evento, si está presente.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_promotion",
      "params": {
        "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",
            "currency": "USD",
            "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",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_search_results

Registra este evento cuando el usuario vea los resultados de una búsqueda. Ten en cuenta que puedes habilitar el evento view_search_results para la recopilación automática mediante la medición optimizada de eventos en Google Analytics.

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`search_term`	`string`	No	Ropa	Es el término utilizado para la búsqueda.

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_search_results",
      "params": {
        "search_term": "Clothing"
      }
    }]
  })
});

working_lead

Este evento mide cuando un usuario se contacta o es contactado por un representante.

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Es la moneda de los elementos asociados con el 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	Indica el valor monetario del evento. * Establece `value` como la suma de `(price * quantity)` para todos los elementos en `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requieren `value` para generar informes significativos. Si marcas el evento como una conversión, se recomienda que establezcas `value`. * `currency` es obligatorio si configuras `value`.
`lead_status`	`string`	No	Conversaciones iniciadas	Indica el estado del cliente potencial.
`items`	`Array<Item>`	No		Los elementos del evento.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí*	SKU_12345	Se trata del ID del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`item_name`	`string`	Sí*	Camiseta de Stan y sus amigos	Se trata del nombre del artículo. *Se requiere uno de los siguientes valores: `item_id` o `item_name`.
`affiliation`	`string`	No	Google Store	Afiliación de un producto para designar la empresa proveedora o la ubicación de la tienda física Nota: La "afiliación" solo está disponible en el alcance del elemento.
`coupon`	`string`	No	SUMMER_FUN	Indica el nombre o código del cupón asociado con el artículo. Los parámetros `coupon` a nivel del evento y del elemento son independientes.
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad promocional. Si se establece, se ignorará `creative_name` a nivel del evento. Si no se establece, se usa `creative_name` a nivel del evento, si está presente.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad promocional asociado con el artículo. Si se establece, se ignorará `creative_slot` a nivel del evento. Si no se establece, se usa `creative_slot` a nivel del evento, si está presente.
`discount`	`number`	No	2.22	Indica el valor de descuento monetario por unidad asociado con el artículo.
`index`	`number`	No	5	El índice/posición del elemento en una lista.
`item_brand`	`string`	No	Servicios	Se refiere a la marca del artículo.
`item_category`	`string`	No	Apparel	La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera.
`item_category2`	`string`	No	Adult	Es la jerarquía de segunda categoría o la taxonomía adicional del artículo.
`item_category3`	`string`	No	Camisas	La jerarquía de tercera categoría o la taxonomía adicional del artículo
`item_category4`	`string`	No	Equipo de rodaje	Es la jerarquía de cuarta categoría o la taxonomía adicional del artículo.
`item_category5`	`string`	No	Manga corta	Es la jerarquía de quinta categoría o la taxonomía adicional del artículo.
`item_list_id`	`string`	No	related_products	El ID de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_id` a nivel del evento. Si no se establece, se usa `item_list_id` a nivel del evento, si está presente.
`item_list_name`	`string`	No	Productos relacionados	El nombre de la lista en la que se presentó el artículo al usuario Si se establece, se ignorará `item_list_name` a nivel del evento. Si no se establece, se usa `item_list_name` a nivel del evento, si está presente.
`item_variant`	`string`	No	green	Es la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de Google Place para San Francisco)	Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Te recomendamos usar el ID de lugar de Google que corresponda al elemento asociado. También se puede usar un ID de ubicación personalizado. Nota: El atributo “ID de ubicación” solo está disponible en el alcance del artículo.
`price`	`number`	No	10:01	Es el precio unitario monetario del artículo, expresado en unidades 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 en el parámetro `discount`.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_id` a nivel del evento. Si no se establece, se usa `promotion_id` a nivel del evento, si está presente.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada con el artículo. Si se establece, se ignorará `promotion_name` a nivel del evento. Si no se establece, se usa `promotion_name` a nivel del evento, si está presente.
`quantity`	`number`	No	3	Cantidad de artículos. Si no se establece, `quantity` se establece en 1.

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

Enviar evento

Prueba este evento en el creador de eventos de GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "working_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_status": "Started conversations",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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
          }
        ]
      }
    }]
  })
});

Eventos

ad_impression

Parámetros

Enviar evento

add_payment_info

Parámetros

Parámetros de elementos

Enviar evento

add_shipping_info

Parámetros

Parámetros de elementos

Enviar evento

add_to_cart

Parámetros

Parámetros de elementos

Enviar evento

add_to_wishlist

Parámetros

Parámetros de elementos

Enviar evento

begin_checkout

Parámetros

Parámetros de elementos

Enviar evento

campaign_details

Parámetros

Enviar evento

close_convert_lead

Parámetros

Parámetros de elementos

Enviar evento

close_unconvert_lead

Parámetros

Parámetros de elementos

Enviar evento

disqualify_lead

Parámetros

Parámetros de elementos

Enviar evento

earn_virtual_currency

Parámetros

Enviar evento

generate_lead

Parámetros

Parámetros de elementos

Enviar evento

join_group

Parámetros

Enviar evento

level_up

Parámetros

Enviar evento

acceder

Parámetros

Enviar evento

post_score

Parámetros

Enviar evento

purchase

Parámetros

Parámetros de elementos

Enviar evento

qualify_lead

Parámetros

Parámetros de elementos

Enviar evento

refund

Parámetros

Parámetros de elementos

Enviar evento

remove_from_cart

Parámetros

Parámetros de elementos

Enviar evento

screen_view

Parámetros

Enviar evento

search

Parámetros

Enviar evento