Eventos

add_payment_info

Este evento indica que un usuario ha enviado sus datos de pago.

Parámetros

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

Si se define, se ignora currency a nivel de artículo.
Si no se define, se usa la moneda del primer artículo en items.

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

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

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

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.

Los parámetros de affiliation a nivel de evento y de artículo son independientes.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
currency string No EUR Es la moneda en el formato estándar ISO 4217 de tres letras.

Si se define, se ignora currency a nivel de evento.

No se admiten varias monedas por evento. Cada artículo debe tener definida la misma moneda.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

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

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

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

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No L_12345 Es la ubicación asociada al artículo. Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.

Si se define, se ignora location_id a nivel de evento.
Si no se define, se usa location_id a nivel de evento, si está presente.
price number No 9.99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

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

Es la cantidad de artículos.

Enviar el 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": 7.77,
        "coupon": "SUMMER_FUN",
        "payment_type": "Credit Card",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

add_shipping_info

Este evento indica que un usuario ha proporcionado sus datos para el envío.

Parámetros

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

Si se define, se ignora currency a nivel de artículo.
Si no se define, se usa la moneda del primer artículo en items.

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

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

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

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.

Los parámetros de affiliation a nivel de evento y de artículo son independientes.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
currency string No EUR Es la moneda en el formato estándar ISO 4217 de tres letras.

Si se define, se ignora currency a nivel de evento.

No se admiten varias monedas por evento. Cada artículo debe tener definida la misma moneda.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

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

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

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

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No L_12345 Es la ubicación asociada al artículo. Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.

Si se define, se ignora location_id a nivel de evento.
Si no se define, se usa location_id a nivel de evento, si está presente.
price number No 9.99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

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

Es la cantidad de artículos.

Enviar el 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": 7.77,
        "coupon": "SUMMER_FUN",
        "shipping_tier": "Ground",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

add_to_cart

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

Parámetros

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

Si se define, se ignora currency a nivel de artículo.
Si no se define, se usa la moneda del primer artículo en items.

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

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

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.

Los parámetros de affiliation a nivel de evento y de artículo son independientes.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
currency string No EUR Es la moneda en el formato estándar ISO 4217 de tres letras.

Si se define, se ignora currency a nivel de evento.

No se admiten varias monedas por evento. Cada artículo debe tener definida la misma moneda.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

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

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

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

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No L_12345 Es la ubicación asociada al artículo. Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.

Si se define, se ignora location_id a nivel de evento.
Si no se define, se usa location_id a nivel de evento, si está presente.
price number No 9.99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

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

Es la cantidad de artículos.

Enviar el 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": 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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

add_to_wishlist

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

Parámetros

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

Si se define, se ignora currency a nivel de artículo.
Si no se define, se usa la moneda del primer artículo en items.

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

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

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.

Los parámetros de affiliation a nivel de evento y de artículo son independientes.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
currency string No EUR Es la moneda en el formato estándar ISO 4217 de tres letras.

Si se define, se ignora currency a nivel de evento.

No se admiten varias monedas por evento. Cada artículo debe tener definida la misma moneda.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

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

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

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

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No L_12345 Es la ubicación asociada al artículo. Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.

Si se define, se ignora location_id a nivel de evento.
Si no se define, se usa location_id a nivel de evento, si está presente.
price number No 9.99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

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

Es la cantidad de artículos.

Enviar el 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": 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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

begin_checkout

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

Parámetros

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

Si se define, se ignora currency a nivel de artículo.
Si no se define, se usa la moneda del primer artículo en items.

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

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

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

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.

Los parámetros de affiliation a nivel de evento y de artículo son independientes.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
currency string No EUR Es la moneda en el formato estándar ISO 4217 de tres letras.

Si se define, se ignora currency a nivel de evento.

No se admiten varias monedas por evento. Cada artículo debe tener definida la misma moneda.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

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

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

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

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No L_12345 Es la ubicación asociada al artículo. Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.

Si se define, se ignora location_id a nivel de evento.
Si no se define, se usa location_id a nivel de evento, si está presente.
price number No 9.99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

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

Es la cantidad de artículos.

Enviar el 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": 7.77,
        "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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

earn_virtual_currency

Este evento se registra cuando se asigna la moneda virtual. Si quieres comprender mejor tu economía virtual, registra este evento con spend_virtual_currency.

Parámetros

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

Enviar el 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

Registra este evento cuando se haya conseguido un cliente potencial para conocer la eficacia de tus campañas de nueva interacción.

Parámetros

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

Si se define, se ignora currency a nivel de artículo.
Si no se define, se usa la moneda del primer artículo en items.

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

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

Enviar el 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 determinados grupos o características sociales.

Parámetros

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

Enviar el 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 indica que un jugador ha subido de nivel. Úsalo para medir la distribución de niveles de tu base de usuarios e identificar los niveles que son difíciles de completar.

Parámetros

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

Enviar el 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"
      }
    }]
  })
});

login

Envía este evento para indicar que un usuario ha iniciado sesión.

Parámetros

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

Enviar el evento

Prueba este evento en el creador de eventos de GA4.

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

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

post_score

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

Parámetros

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

Enviar el 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 ha comprado uno o varios artículos.

Parámetros

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

Si se define, se ignora currency a nivel de artículo.
Si no se define, se usa la moneda del primer artículo en items.

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

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

* value es necesario para registrar información significativa y rellenar la audiencia predictiva de los compradores.
* currency es obligatorio si defines value.
affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.

Los parámetros de affiliation a nivel de evento y de artículo son independientes.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al evento.

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

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.

Los parámetros de affiliation a nivel de evento y de artículo son independientes.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
currency string No EUR Es la moneda en el formato estándar ISO 4217 de tres letras.

Si se define, se ignora currency a nivel de evento.

No se admiten varias monedas por evento. Cada artículo debe tener definida la misma moneda.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

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

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

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

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No L_12345 Es la ubicación asociada al artículo. Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.

Si se define, se ignora location_id a nivel de evento.
Si no se define, se usa location_id a nivel de evento, si está presente.
price number No 9.99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

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

Es la cantidad de artículos.

Enviar el 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": 12.21,
        "affiliation": "Google Store",
        "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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

refund

Este evento indica que se ha emitido un reembolso.

Parámetros

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

Si se define, se ignora currency a nivel de artículo.
Si no se define, se usa la moneda del primer artículo en items.

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

* Por lo general, value es necesario para registrar información significativa. Si marcas el evento como una conversión, es recomendable que definas value.
* currency es obligatorio si defines value.
affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.

Los parámetros de affiliation a nivel de evento y de artículo son independientes.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al evento.

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

* items es obligatorio para los reembolsos parciales, pero puede omitirse en caso de reembolsos completos.

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.

Los parámetros de affiliation a nivel de evento y de artículo son independientes.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
currency string No EUR Es la moneda en el formato estándar ISO 4217 de tres letras.

Si se define, se ignora currency a nivel de evento.

No se admiten varias monedas por evento. Cada artículo debe tener definida la misma moneda.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

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

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

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

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No L_12345 Es la ubicación asociada al artículo. Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.

Si se define, se ignora location_id a nivel de evento.
Si no se define, se usa location_id a nivel de evento, si está presente.
price number No 9.99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

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

Es la cantidad de artículos.

Enviar el 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": 12.21,
        "affiliation": "Google Store",
        "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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

remove_from_cart

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

Parámetros

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

Si se define, se ignora currency a nivel de artículo.
Si no se define, se usa la moneda del primer artículo en items.

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

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

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.

Los parámetros de affiliation a nivel de evento y de artículo son independientes.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
currency string No EUR Es la moneda en el formato estándar ISO 4217 de tres letras.

Si se define, se ignora currency a nivel de evento.

No se admiten varias monedas por evento. Cada artículo debe tener definida la misma moneda.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

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

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

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

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No L_12345 Es la ubicación asociada al artículo. Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.

Si se define, se ignora location_id a nivel de evento.
Si no se define, se usa location_id a nivel de evento, si está presente.
price number No 9.99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

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

Es la cantidad de artículos.

Enviar el 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": 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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

Usa este evento para contextualizar las operaciones de búsqueda. Este evento te puede servir para identificar el contenido más popular de tu aplicación.

Parámetros

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

Enviar el 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 indica que un usuario ha seleccionado contenido de un determinado tipo, lo que te puede servir para identificar el contenido popular y las categorías de contenido de tu aplicación.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
content_type string No product Es el tipo de contenido seleccionado.
item_id string No I_12345 Es el identificador del artículo que se ha seleccionado.

Enviar el 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",
        "item_id": "I_12345"
      }
    }]
  })
});

select_item

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

Parámetros

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

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

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

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

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.

Los parámetros de affiliation a nivel de evento y de artículo son independientes.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
currency string No EUR Es la moneda en el formato estándar ISO 4217 de tres letras.

Si se define, se ignora currency a nivel de evento.

No se admiten varias monedas por evento. Cada artículo debe tener definida la misma moneda.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

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

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

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

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No L_12345 Es la ubicación asociada al artículo. Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.

Si se define, se ignora location_id a nivel de evento.
Si no se define, se usa location_id a nivel de evento, si está presente.
price number No 9.99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

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

Es la cantidad de artículos.

Enviar el 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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

select_promotion

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

Parámetros

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

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

Se ignora si se define a nivel de artículo.
location_id string No L_12345 Es el ID de la ubicación.

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

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

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

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.

Los parámetros de affiliation a nivel de evento y de artículo son independientes.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
currency string No EUR Es la moneda en el formato estándar ISO 4217 de tres letras.

Si se define, se ignora currency a nivel de evento.

No se admiten varias monedas por evento. Cada artículo debe tener definida la misma moneda.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

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

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

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

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No L_12345 Es la ubicación asociada al artículo. Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.

Si se define, se ignora location_id a nivel de evento.
Si no se define, se usa location_id a nivel de evento, si está presente.
price number No 9.99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

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

Es la cantidad de artículos.

Enviar el 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",
        "location_id": "L_12345",
        "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": "L_12345",
            "price": 9.99,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 1
          }
        ]
      }
    }]
  })
});

share

Usa este evento cuando un usuario comparta contenido.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
method string No Twitter Es el método a través del cual se ha compartido el contenido.
content_type string No image Es el tipo de contenido que se ha compartido.
item_id string No C_12345 Es el ID del contenido que se ha compartido.

Enviar el 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 ha registrado para crear una cuenta. Úsalo para conocer los comportamientos de los usuarios con la sesión iniciada y sin iniciar.

Parámetros

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

Enviar el 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 registra la venta de productos virtuales en tu aplicación y te puede servir para identificar cuáles son los más populares.

Parámetros

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

Enviar el 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 incorporación. Úsalo en un embudo de conversión con tutorial_complete para saber cuántos usuarios empiezan el tutorial.

Parámetros

No hay parámetros sugeridos para este evento.

Este evento no tiene parámetros.

Enviar el evento

Prueba este evento en el creador de eventos de GA4.

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

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

tutorial_complete

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

Parámetros

No hay parámetros sugeridos para este evento.

Enviar el evento

Prueba este evento en el creador de eventos de GA4.

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

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

unlock_achievement

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

Parámetros

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

Enviar el 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 indica que un usuario ha visto su carrito.

Parámetros

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

Si se define, se ignora currency a nivel de artículo.
Si no se define, se usa la moneda del primer artículo en items.

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

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

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.

Los parámetros de affiliation a nivel de evento y de artículo son independientes.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
currency string No EUR Es la moneda en el formato estándar ISO 4217 de tres letras.

Si se define, se ignora currency a nivel de evento.

No se admiten varias monedas por evento. Cada artículo debe tener definida la misma moneda.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

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

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

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

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No L_12345 Es la ubicación asociada al artículo. Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.

Si se define, se ignora location_id a nivel de evento.
Si no se define, se usa location_id a nivel de evento, si está presente.
price number No 9.99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

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

Es la cantidad de artículos.

Enviar el 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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

view_item

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

Parámetros

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

Si se define, se ignora currency a nivel de artículo.
Si no se define, se usa la moneda del primer artículo en items.

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

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

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.

Los parámetros de affiliation a nivel de evento y de artículo son independientes.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
currency string No EUR Es la moneda en el formato estándar ISO 4217 de tres letras.

Si se define, se ignora currency a nivel de evento.

No se admiten varias monedas por evento. Cada artículo debe tener definida la misma moneda.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

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

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

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

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No L_12345 Es la ubicación asociada al artículo. Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.

Si se define, se ignora location_id a nivel de evento.
Si no se define, se usa location_id a nivel de evento, si está presente.
price number No 9.99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

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

Es la cantidad de artículos.

Enviar el 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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ],
      }
    }]
  })
});

view_item_list

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

Parámetros

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

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

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

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.

Los parámetros de affiliation a nivel de evento y de artículo son independientes.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
currency string No EUR Es la moneda en el formato estándar ISO 4217 de tres letras.

Si se define, se ignora currency a nivel de evento.

No se admiten varias monedas por evento. Cada artículo debe tener definida la misma moneda.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

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

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

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

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No L_12345 Es la ubicación asociada al artículo. Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.

Si se define, se ignora location_id a nivel de evento.
Si no se define, se usa location_id a nivel de evento, si está presente.
price number No 9.99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

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

Es la cantidad de artículos.

Enviar el 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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

view_promotion

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

Parámetros

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

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

Se ignora si se define a nivel de artículo.
location_id string No L_12345 Es el ID de la ubicación.

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

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

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

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

Parámetros de artículo

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

Es el ID del artículo.

* Es obligatorio usar item_id o item_name.

item_name string Sí* Camiseta Stan and Friends

Es el nombre del artículo.

* Es obligatorio usar item_id o item_name.

affiliation string No Google Store Es la afiliación de producto que se usa para designar una empresa suministradora o la ubicación de una tienda física tradicional.

Los parámetros de affiliation a nivel de evento y de artículo son independientes.
coupon string No FELICIDAD_VERANIEGA Es el nombre o código de cupón asociado al artículo.

Los parámetros de coupon a nivel de evento y de artículo son independientes.
currency string No EUR Es la moneda en el formato estándar ISO 4217 de tres letras.

Si se define, se ignora currency a nivel de evento.

No se admiten varias monedas por evento. Cada artículo debe tener definida la misma moneda.
creative_name string No banner_verano2 Es el nombre de la creatividad promocional.

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

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

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

Si se define, se ignora item_list_name a nivel de evento.
Si no se define, se usa item_list_name a nivel de evento, si está presente.
item_variant string No Verde Es la variante, el código único o la descripción de un artículo que proporciona más información u opciones del artículo.
location_id string No L_12345 Es la ubicación asociada al artículo. Se recomienda usar el ID de sitio de Google que corresponde al artículo asociado, pero también se puede usar un ID de ubicación personalizada.

Si se define, se ignora location_id a nivel de evento.
Si no se define, se usa location_id a nivel de evento, si está presente.
price number No 9.99 Es el valor monetario del artículo, expresado en las unidades del parámetro de moneda especificado.
promotion_id string No P_12345 Es el ID de la promoción asociada al artículo.

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

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

Es la cantidad de artículos.

Enviar el 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",
        "location_id": "L_12345",
        "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": "L_12345",
            "price": 9.99,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 1
          }
        ]
      }
    }]
  })
});

view_search_results

Registra este evento cuando se muestren los resultados de una búsqueda al usuario.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
search_term string No Ropa Es el término que se ha usado para hacer la búsqueda.
items Array<Item> Son los artículos del evento.

Enviar el 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"
      }
    }]
  })
});