Eventos

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 configuras value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30,03 Indica el valor monetario del evento.

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

Los parámetros coupon a nivel del evento y del artículo son independientes.
payment_type string No Credit Card Es la forma de pago elegida.
items Array<Item> 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 item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere uno de item_id o item_name.

affiliation string No Google Store Una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: La “afiliación” solo está disponible en el alcance del artículo.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

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

Si se configura, se ignora creative_name a nivel del evento.
Si no se configura, 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 configura, se ignora creative_slot a nivel del evento.
Si no se configura, 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
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 Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la 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 configura, se ignora item_list_id a nivel del evento.
Si no se configura, 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 configura, se ignora item_list_name a nivel del evento.
Si no se configura, 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). Se recomienda usar el ID de Google Place correspondiente al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: El atributo "location id" solo está disponible en el alcance del artículo.
price number No 10,01 Es el precio unitario monetaria 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 del precio unitario en el parámetro discount.
promotion_id string No P_12345 Es el ID de la promoción asociada con el artículo.

Si se configura, se ignora promotion_id a nivel del evento.
Si no se configura, 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 configura, se ignora promotion_name a nivel del evento.
Si no se configura, 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 configuras value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30,03 Indica el valor monetario del evento.

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

Los parámetros coupon a nivel del evento y del artículo son independientes.
shipping_tier string No Terrestre Indica el nivel de envío (p.ej., Ground, Air, Next-day) seleccionado para la entrega del artículo comprado.
items Array<Item> 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 item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere uno de item_id o item_name.

affiliation string No Google Store Una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: La “afiliación” solo está disponible en el alcance del artículo.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

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

Si se configura, se ignora creative_name a nivel del evento.
Si no se configura, 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 configura, se ignora creative_slot a nivel del evento.
Si no se configura, 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
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 Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la 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 configura, se ignora item_list_id a nivel del evento.
Si no se configura, 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 configura, se ignora item_list_name a nivel del evento.
Si no se configura, 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). Se recomienda usar el ID de Google Place correspondiente al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: El atributo "location id" solo está disponible en el alcance del artículo.
price number No 10,01 Es el precio unitario monetaria 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 del precio unitario en el parámetro discount.
promotion_id string No P_12345 Es el ID de la promoción asociada con el artículo.

Si se configura, se ignora promotion_id a nivel del evento.
Si no se configura, 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 configura, se ignora promotion_name a nivel del evento.
Si no se configura, 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 un artículo se agregó al carrito para su 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 configuras value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30,03 Indica el valor monetario del evento.

* Establece value como la suma de (price * quantity) para todos los elementos de items. No incluyas shipping ni tax.
* Por lo general, se requiere value para obtener informes significativos. Si marcas el evento como una conversión, te recomendamos que configures value.
* currency es obligatorio si configuras value.
items Array<Item> 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 item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere uno de item_id o item_name.

affiliation string No Google Store Una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: La “afiliación” solo está disponible en el alcance del artículo.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

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

Si se configura, se ignora creative_name a nivel del evento.
Si no se configura, 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 configura, se ignora creative_slot a nivel del evento.
Si no se configura, 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
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 Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la 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 configura, se ignora item_list_id a nivel del evento.
Si no se configura, 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 configura, se ignora item_list_name a nivel del evento.
Si no se configura, 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). Se recomienda usar el ID de Google Place correspondiente al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: El atributo "location id" solo está disponible en el alcance del artículo.
price number No 10,01 Es el precio unitario monetaria 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 del precio unitario en el parámetro discount.
promotion_id string No P_12345 Es el ID de la promoción asociada con el artículo.

Si se configura, se ignora promotion_id a nivel del evento.
Si no se configura, 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 configura, se ignora promotion_name a nivel del evento.
Si no se configura, 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 elemento 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 configuras value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30,03 Indica el valor monetario del evento.

* Establece value como la suma de (price * quantity) para todos los elementos de items. No incluyas shipping ni tax.
* Por lo general, se requiere value para obtener informes significativos. Si marcas el evento como una conversión, te recomendamos que configures value.
* currency es obligatorio si configuras value.
items Array<Item> 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 item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere uno de item_id o item_name.

affiliation string No Google Store Una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: La “afiliación” solo está disponible en el alcance del artículo.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

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

Si se configura, se ignora creative_name a nivel del evento.
Si no se configura, 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 configura, se ignora creative_slot a nivel del evento.
Si no se configura, 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
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 Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la 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 configura, se ignora item_list_id a nivel del evento.
Si no se configura, 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 configura, se ignora item_list_name a nivel del evento.
Si no se configura, 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). Se recomienda usar el ID de Google Place correspondiente al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: El atributo "location id" solo está disponible en el alcance del artículo.
price number No 10,01 Es el precio unitario monetaria 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 del precio unitario en el parámetro discount.
promotion_id string No P_12345 Es el ID de la promoción asociada con el artículo.

Si se configura, se ignora promotion_id a nivel del evento.
Si no se configura, 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 configura, se ignora promotion_name a nivel del evento.
Si no se configura, 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 significa que un usuario comenzó una confirmación de la compra.

Parámetros

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

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

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

Los parámetros coupon a nivel del evento y del artículo son independientes.
items Array<Item> 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 item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere uno de item_id o item_name.

affiliation string No Google Store Una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: La “afiliación” solo está disponible en el alcance del artículo.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

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

Si se configura, se ignora creative_name a nivel del evento.
Si no se configura, 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 configura, se ignora creative_slot a nivel del evento.
Si no se configura, 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
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 Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la 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 configura, se ignora item_list_id a nivel del evento.
Si no se configura, 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 configura, se ignora item_list_name a nivel del evento.
Si no se configura, 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). Se recomienda usar el ID de Google Place correspondiente al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: El atributo "location id" solo está disponible en el alcance del artículo.
price number No 10,01 Es el precio unitario monetaria 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 del precio unitario en el parámetro discount.
promotion_id string No P_12345 Es el ID de la promoción asociada con el artículo.

Si se configura, se ignora promotion_id a nivel del evento.
Si no se configura, 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 configura, se ignora promotion_name a nivel del evento.
Si no se configura, 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

Usa 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 El nombre que se usa para identificar una promoción específica o una campaña estratégica.
source string No google 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.)
term string No verano+viajes El término de la campaña usado con la búsqueda pagada para proporcionar las palabras clave para los anuncios.
content string No logolink El contenido de la campaña que se utiliza para 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"
      }
    }]
  })
});

earn_virtual_currency

Este evento mide cuando un usuario recibe una 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 Gemas Indica el nombre de la moneda virtual.
value number No 5 Es 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 genera 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 de aplicar el remarketing a 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 configuras value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30,03 Indica el valor monetario del evento.

* Establece value como la suma de (price * quantity) para todos los elementos de items. No incluyas shipping ni tax.
* Por lo general, se requiere value para obtener informes significativos. Si marcas el evento como una conversión, te recomendamos que configures value.
* 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": "generate_lead",
      "params": {
        "currency": "USD",
        "value": 99.99
      }
    }]
  })
});

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 de redes sociales.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
group_id string No G_12345 Indica 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 niveles de la base de usuarios y, además, identificar los niveles que son 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"
      }
    }]
  })
});

acceder

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

Parámetros

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

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 publica una puntuación. Usa este evento para comprender el rendimiento de los usuarios en tu juego y correlacionar las puntuaciones altas con los públicos o los comportamientos.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
score number 10000 Puntaje que se publicará.
level number No 5 El nivel de la puntuación.
character string No Jugador 1 Es el personaje que logró 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 que 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 configuras value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30,03 Indica el valor monetario del evento.

* Establece value como la suma de (price * quantity) para todos los elementos de items. No incluyas shipping ni tax.
* Por lo general, se requiere value para obtener informes significativos. Si marcas el evento como una conversión, te recomendamos que configures value.
* currency es obligatorio si configuras value.
transaction_id string T_12345 Es el identificador único de una transacción.

El parámetro transaction_id te ayuda a evitar recibir eventos duplicados por una compra.
coupon string No SUMMER_FUN Indica el nombre o código del cupón asociado con el evento.

Los parámetros coupon a nivel del evento y del artículo son independientes.
shipping number No 3.33 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> 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 item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere uno de item_id o item_name.

affiliation string No Google Store Una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: La “afiliación” solo está disponible en el alcance del artículo.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

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

Si se configura, se ignora creative_name a nivel del evento.
Si no se configura, 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 configura, se ignora creative_slot a nivel del evento.
Si no se configura, 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
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 Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la 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 configura, se ignora item_list_id a nivel del evento.
Si no se configura, 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 configura, se ignora item_list_name a nivel del evento.
Si no se configura, 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). Se recomienda usar el ID de Google Place correspondiente al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: El atributo "location id" solo está disponible en el alcance del artículo.
price number No 10,01 Es el precio unitario monetaria 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 del precio unitario en el parámetro discount.
promotion_id string No P_12345 Es el ID de la promoción asociada con el artículo.

Si se configura, se ignora promotion_id a nivel del evento.
Si no se configura, 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 configura, se ignora promotion_name a nivel del evento.
Si no se configura, 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
          }
        ]
      }
    }]
  })
});

refund

Este evento indica que 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 configuras value, se requiere currency para que las métricas de ingresos se calculen con precisión.
transaction_id string T_12345 Es el identificador único de una transacción.
value number Sí* 30,03 Indica el valor monetario del evento.

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

Los parámetros coupon a nivel del evento y del artículo son independientes.
shipping number No 3.33 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 item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere uno de item_id o item_name.

affiliation string No Google Store Una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: La “afiliación” solo está disponible en el alcance del artículo.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

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

Si se configura, se ignora creative_name a nivel del evento.
Si no se configura, 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 configura, se ignora creative_slot a nivel del evento.
Si no se configura, 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
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 Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la 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 configura, se ignora item_list_id a nivel del evento.
Si no se configura, 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 configura, se ignora item_list_name a nivel del evento.
Si no se configura, 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). Se recomienda usar el ID de Google Place correspondiente al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: El atributo "location id" solo está disponible en el alcance del artículo.
price number No 10,01 Es el precio unitario monetaria 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 del precio unitario en el parámetro discount.
promotion_id string No P_12345 Es el ID de la promoción asociada con el artículo.

Si se configura, se ignora promotion_id a nivel del evento.
Si no se configura, 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 configura, se ignora promotion_name a nivel del evento.
Si no se configura, 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 del 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 configuras value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30,03 Indica el valor monetario del evento.

* Establece value como la suma de (price * quantity) para todos los elementos de items. No incluyas shipping ni tax.
* Por lo general, se requiere value para obtener informes significativos. Si marcas el evento como una conversión, te recomendamos que configures value.
* currency es obligatorio si configuras value.
items Array<Item> 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 item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere uno de item_id o item_name.

affiliation string No Google Store Una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: La “afiliación” solo está disponible en el alcance del artículo.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

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

Si se configura, se ignora creative_name a nivel del evento.
Si no se configura, 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 configura, se ignora creative_slot a nivel del evento.
Si no se configura, 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
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 Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la 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 configura, se ignora item_list_id a nivel del evento.
Si no se configura, 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 configura, se ignora item_list_name a nivel del evento.
Si no se configura, 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). Se recomienda usar el ID de Google Place correspondiente al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: El atributo "location id" solo está disponible en el alcance del artículo.
price number No 10,01 Es el precio unitario monetaria 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 del precio unitario en el parámetro discount.
promotion_id string No P_12345 Es el ID de la promoción asociada con el artículo.

Si se configura, se ignora promotion_id a nivel del evento.
Si no se configura, 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 configura, se ignora promotion_name a nivel del evento.
Si no se configura, 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
          }
        ]
      }
    }]
  })
});

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 vea una página de resultados de búsqueda después de realizar una búsqueda.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
search_term string 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ó contenido de un tipo determinado. Este evento puede ayudarte a identificar el contenido popular y las categorías de contenido de tu sitio web o app.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
content_type string No product Es el tipo de contenido seleccionado.
content_id string No C_12345 Un identificador para el contenido seleccionado.

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 configura a nivel del artículo.
item_list_name string No Productos relacionados El nombre de la lista en la que se presentó el artículo al usuario

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

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

Parámetros de elementos

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

Se trata del ID del artículo.

*Se requiere uno de item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere uno de item_id o item_name.

affiliation string No Google Store Una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: La “afiliación” solo está disponible en el alcance del artículo.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

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

Si se configura, se ignora creative_name a nivel del evento.
Si no se configura, 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 configura, se ignora creative_slot a nivel del evento.
Si no se configura, 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
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 Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la 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 configura, se ignora item_list_id a nivel del evento.
Si no se configura, 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 configura, se ignora item_list_name a nivel del evento.
Si no se configura, 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). Se recomienda usar el ID de Google Place correspondiente al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: El atributo "location id" solo está disponible en el alcance del artículo.
price number No 10,01 Es el precio unitario monetaria 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 del precio unitario en el parámetro discount.
promotion_id string No P_12345 Es el ID de la promoción asociada con el artículo.

Si se configura, se ignora promotion_id a nivel del evento.
Si no se configura, 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 configura, se ignora promotion_name a nivel del evento.
Si no se configura, 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 configura a nivel del artículo.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad promocional asociado con el evento.

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

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

Se ignora si se configura a nivel del artículo.
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 item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere uno de item_id o item_name.

affiliation string No Google Store Una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: La “afiliación” solo está disponible en el alcance del artículo.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

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

Si se configura, se ignora creative_name a nivel del evento.
Si no se configura, 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 configura, se ignora creative_slot a nivel del evento.
Si no se configura, 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
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 Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la 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 configura, se ignora item_list_id a nivel del evento.
Si no se configura, 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 configura, se ignora item_list_name a nivel del evento.
Si no se configura, 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). Se recomienda usar el ID de Google Place correspondiente al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: El atributo "location id" solo está disponible en el alcance del artículo.
price number No 10,01 Es el precio unitario monetaria 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 del precio unitario en el parámetro discount.
promotion_id string No P_12345 Es el ID de la promoción asociada con el artículo.

Si se configura, se ignora promotion_id a nivel del evento.
Si no se configura, 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 configura, se ignora promotion_name a nivel del evento.
Si no se configura, 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
          }
        ]
      }
    }]
  })
});

compartirlo

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 con el que se comparte el contenido.
content_type string No imagen Es el tipo de contenido compartido.
item_id string No C_12345 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 salieron de sus cuentas.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
method string No Google Es el método que se usa 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 5 Es el valor de la moneda virtual.
virtual_currency_name string Gemas Indica el nombre de la moneda virtual.
item_name string No Potenciador inicial El nombre del elemento para el que se utiliza 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. Usa esto en un embudo con tutorial_complete para comprender cuántos usuarios completan el instructivo.

Parámetros

No se sugieren parámetros 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 significa que el usuario completó tu proceso de integración. Usa esto en un embudo con tutorial_begin para comprender cuántos usuarios completan el instructivo.

Parámetros

No se sugieren 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_complete"
    }]
  })
});

unlock_achievement

Registra este evento cuando el usuario desbloquee un logro. Este evento puede ayudarte a comprender la experiencia de los usuarios con tu juego.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
achievement_id string 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 configuras value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30,03 Indica el valor monetario del evento.

* Establece value como la suma de (price * quantity) para todos los elementos de items. No incluyas shipping ni tax.
* Por lo general, se requiere value para obtener informes significativos. Si marcas el evento como una conversión, te recomendamos que configures value.
* currency es obligatorio si configuras value.
items Array<Item> 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 item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere uno de item_id o item_name.

affiliation string No Google Store Una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: La “afiliación” solo está disponible en el alcance del artículo.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

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

Si se configura, se ignora creative_name a nivel del evento.
Si no se configura, 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 configura, se ignora creative_slot a nivel del evento.
Si no se configura, 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
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 Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la 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 configura, se ignora item_list_id a nivel del evento.
Si no se configura, 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 configura, se ignora item_list_name a nivel del evento.
Si no se configura, 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). Se recomienda usar el ID de Google Place correspondiente al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: El atributo "location id" solo está disponible en el alcance del artículo.
price number No 10,01 Es el precio unitario monetaria 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 del precio unitario en el parámetro discount.
promotion_id string No P_12345 Es el ID de la promoción asociada con el artículo.

Si se configura, se ignora promotion_id a nivel del evento.
Si no se configura, 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 configura, se ignora promotion_name a nivel del evento.
Si no se configura, 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ó parte del 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 configuras value, se requiere currency para que las métricas de ingresos se calculen con precisión.
value number Sí* 30,03 Indica el valor monetario del evento.

* Establece value como la suma de (price * quantity) para todos los elementos de items. No incluyas shipping ni tax.
* Por lo general, se requiere value para obtener informes significativos. Si marcas el evento como una conversión, te recomendamos que configures value.
* currency es obligatorio si configuras value.
items Array<Item> 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 item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere uno de item_id o item_name.

affiliation string No Google Store Una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: La “afiliación” solo está disponible en el alcance del artículo.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

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

Si se configura, se ignora creative_name a nivel del evento.
Si no se configura, 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 configura, se ignora creative_slot a nivel del evento.
Si no se configura, 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
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 Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la 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 configura, se ignora item_list_id a nivel del evento.
Si no se configura, 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 configura, se ignora item_list_name a nivel del evento.
Si no se configura, 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). Se recomienda usar el ID de Google Place correspondiente al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: El atributo "location id" solo está disponible en el alcance del artículo.
price number No 10,01 Es el precio unitario monetaria 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 del precio unitario en el parámetro discount.
promotion_id string No P_12345 Es el ID de la promoción asociada con el artículo.

Si se configura, se ignora promotion_id a nivel del evento.
Si no se configura, 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 configura, se ignora promotion_name a nivel del evento.
Si no se configura, 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 configura a nivel del artículo.
item_list_name string No Productos relacionados El nombre de la lista en la que se presentó el artículo al usuario

Se ignora si se configura a nivel del artículo.
items Array<Item> 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 item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere uno de item_id o item_name.

affiliation string No Google Store Una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: La “afiliación” solo está disponible en el alcance del artículo.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

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

Si se configura, se ignora creative_name a nivel del evento.
Si no se configura, 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 configura, se ignora creative_slot a nivel del evento.
Si no se configura, 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
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 Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la 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 configura, se ignora item_list_id a nivel del evento.
Si no se configura, 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 configura, se ignora item_list_name a nivel del evento.
Si no se configura, 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). Se recomienda usar el ID de Google Place correspondiente al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: El atributo "location id" solo está disponible en el alcance del artículo.
price number No 10,01 Es el precio unitario monetaria 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 del precio unitario en el parámetro discount.
promotion_id string No P_12345 Es el ID de la promoción asociada con el artículo.

Si se configura, se ignora promotion_id a nivel del evento.
Si no se configura, 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 configura, se ignora promotion_name a nivel del evento.
Si no se configura, 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 configura a nivel del artículo.
creative_slot string No featured_app_1 Es el nombre del espacio para la creatividad promocional asociado con el evento.

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

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

Se ignora si se configura a nivel del artículo.
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 primer elemento de items.

Parámetros de elementos

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

Se trata del ID del artículo.

*Se requiere uno de item_id o item_name.

item_name string Sí* Camiseta de Stan and Friends

Se trata del nombre del artículo.

*Se requiere uno de item_id o item_name.

affiliation string No Google Store Una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: La “afiliación” solo está disponible en el alcance del artículo.
coupon string No SUMMER_FUN Es el nombre o código del cupón asociado con el artículo.

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

Si se configura, se ignora creative_name a nivel del evento.
Si no se configura, 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 configura, se ignora creative_slot a nivel del evento.
Si no se configura, 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 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Apparel La categoría del artículo Si se usa como parte de una jerarquía de categorías o taxonomía, esta será la primera categoría.
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 Es la jerarquía de tercera categoría o la taxonomía adicional del artículo.
item_category4 string No Equipo de rodaje Es la 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 configura, se ignora item_list_id a nivel del evento.
Si no se configura, 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 configura, se ignora item_list_name a nivel del evento.
Si no se configura, 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). Se recomienda usar el ID de Google Place correspondiente al elemento asociado. También se puede usar un ID de ubicación personalizado.
Nota: El atributo "location id" solo está disponible en el alcance del artículo.
price number No 10,01 Es el precio unitario monetaria 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 del precio unitario en el parámetro discount.
promotion_id string No P_12345 Es el ID de la promoción asociada con el artículo.

Si se configura, se ignora promotion_id a nivel del evento.
Si no se configura, 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 configura, se ignora promotion_name a nivel del evento.
Si no se configura, 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 se muestren los resultados de una búsqueda al usuario. Ten en cuenta que puedes habilitar el evento view_search_results para su recopilación automática a través de la medición de eventos optimizada en Google Analytics.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
search_term string No Ropa Indica 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"
      }
    }]
  })
});