Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Eventos recomendados de Google Analytics

A continuación, se incluye una lista de los eventos recomendados. También puedes crear y enviar tus propios eventos personalizados.

Cuando crees nombres de eventos personalizados, debes hacer lo siguiente:

Sigue las reglas para asignar nombres a los eventos.
Evita los prefijos y nombres reservados.
Mantente dentro de los límites de recopilación de eventos, como el límite de 40 caracteres para los nombres de eventos y parámetros.

Consulta Cómo comenzar para obtener más detalles.

Si vas a actualizar desde el Protocolo de medición, consulta Actualiza desde el Protocolo de medición para obtener instrucciones.

Para todas las propiedades

`ad_impression`

Este evento solo está disponible para los flujos de aplicaciones.

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

Un ad_impression enviado a través del Measurement Protocol no se incluirá en las exportaciones a otras plataformas publicitarias, como Google Ads.
El envío de eventos ad_impression a través del Measurement Protocol puede generar impresiones duplicadas si configuraste el etiquetado o el SDK para tus productos publicitarios de Google vinculados. Solo envía un evento ad_impression con Measurement Protocol si el etiquetado o el SDK no capturaron el evento.

Campos del evento

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	No	USD	Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras. * Si estableces `conversion_value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`conversion_value`	`number`	No	3.99	Es el valor de la impresión del anuncio. * Por lo general, se requiere `conversion_value` para generar informes significativos. * `currency` es obligatorio si configuras `conversion_value`.

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`ad_platform`	`string`	No	MoPub	Es la plataforma de anuncios.
`ad_source`	`string`	No	AdColony	Es la fuente del anuncio.
`ad_format`	`string`	No	Banner	Es el formato del anuncio.
`ad_unit_name`	`string`	No	Banner_03	Es el nombre de la unidad de anuncios.

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento ad_impression con la API de DataManager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "ad_impression",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 3.99,
      "additionalEventParameters": [
        {
          "parameterName": "ad_platform",
          "value": "MoPub"
        },
        {
          "parameterName": "ad_source",
          "value": "AdColony"
        },
        {
          "parameterName": "ad_format",
          "value": "Banner"
        },
        {
          "parameterName": "ad_unit_name",
          "value": "Banner_03"
        }
      ]
    }
  ]
}

Protocolo de medición

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({
    "app_instance_id": "app_instance_id",
    "events": [{
      "name": "ad_impression",
      "params": {
        "ad_platform": "MoPub",
        "ad_source": "AdColony",
        "ad_format": "Banner",
        "ad_unit_name": "Banner_03",
        "currency": "USD",
        "value": 3.99
      }
    }]
  })
});

`earn_virtual_currency`

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

Campos del evento

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`conversion_value`	`number`	No	5	Es el valor de la moneda virtual.

Parámetros

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento earn_virtual_currency con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "earn_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Protocolo de medición

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

`join_group`

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

Parámetros

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento join_group con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "join_group",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "group_id",
          "value": "G_12345"
        }
      ]
    }
  ]
}

Protocolo de medición

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

`login`

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

Parámetros

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento login con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "login",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Protocolo de medición

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

`screen_view`

Este evento solo está disponible para los flujos de aplicaciones.

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

Parámetros

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento screen_view con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "screen_view",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "additionalEventParameters": [
        {
          "parameterName": "screen_class",
          "value": "MainActivity"
        },
        {
          "parameterName": "screen_name",
          "value": "About"
        }
      ]
    }
  ]
}

Protocolo de medición

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({
    "app_instance_id": "app_instance_id",
    "events": [{
      "name": "screen_view",
      "params": {
        "screen_class": "MainActivity",
        "screen_name": "About"
      }
    }]
  })
});

`search`

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

Parámetros

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento search con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "search",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "t-shirts"
        }
      ]
    }
  ]
}

Protocolo de medición

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 seleccionó contenido de un tipo determinado. Este evento puede ayudarte a identificar el contenido y las categorías de contenido populares en tu sitio web o aplicación.

Parámetros

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento select_content con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_content",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "content_type",
          "value": "product"
        },
        {
          "parameterName": "content_id",
          "value": "C_12345"
        }
      ]
    }
  ]
}

Protocolo de medición

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

`share`

Usa este evento cuando un usuario haya compartido contenido.

Campos del evento

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`cart_data.items`	`Item[]`	No		Son los elementos del evento. Configura el campo `cart_data.items` en el objeto `Event`.

Campos de artículos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí	I_12345	Es un identificador único del elemento. Configura el campo `item_id` en el objeto `Item`.
`unit_price`	`number`	Sí	27.67	Es el precio unitario sin impuestos, envío ni descuentos a nivel de la transacción (con alcance del evento) para este artículo. Si el artículo tiene un descuento a nivel del artículo, usa el precio por unidad con descuento. Por ejemplo, si un artículo tiene un precio por unidad de 27.67 y un descuento por unidad de 6.66, establece `unitPrice` en 21.01.
`quantity`	`number`	Sí	1	Es la cantidad de unidades compradas de este artículo en particular.

Parámetros

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento share con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "share",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "C_12345",
            "quantity": 1,
            "unitPrice": 27.67
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Twitter"
        },
        {
          "parameterName": "content_type",
          "value": "image"
        }
      ]
    }
  ]
}

Protocolo de medición

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

`sign_up`

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

Parámetros

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento sign_up con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "sign_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Protocolo de medición

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

`spend_virtual_currency`

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

Campos del evento

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`conversion_value`	`number`	Sí	5	Es el valor de la moneda virtual.
`cart_data.items`	`Item[]`	No		Son los elementos del evento. Configura el campo `cart_data.items` en el objeto `Event`.

Campos de artículos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí	I_12345	Es un identificador único del elemento. Configura el campo `item_id` en el objeto `Item`.
`unit_price`	`number`	Sí	27.67	Es el precio unitario sin impuestos, envío ni descuentos a nivel de la transacción (con alcance del evento) para este artículo. Si el artículo tiene un descuento a nivel del artículo, usa el precio por unidad con descuento. Por ejemplo, si un artículo tiene un precio por unidad de 27.67 y un descuento por unidad de 6.66, establece `unitPrice` en 21.01.
`quantity`	`number`	Sí	1	Es la cantidad de unidades compradas de este artículo en particular.

Parámetros de elementos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_name`	`string`	No	Starter Boost	Es el nombre del elemento para el que se usa la moneda virtual.

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`virtual_currency_name`	`string`	Sí	Gems	Indica el nombre de la moneda virtual.

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento spend_virtual_currency con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "spend_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "I_12345",
            "quantity": 1,
            "unitPrice": 27.67,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Starter Boost"
              }
            ]
          }
        ]
      },
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Protocolo de medición

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 con tutorial_complete para comprender cuántos usuarios completan el instructivo.

Parámetros

No se sugieren parámetros para este evento.

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento tutorial_begin con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_begin",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Protocolo de medición

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 completó tu proceso de incorporación. Úsalo en un embudo con tutorial_begin para comprender cuántos usuarios completan el instructivo.

Parámetros

No se sugieren parámetros para este evento.

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento tutorial_complete con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_complete",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Protocolo de medición

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

`view_search_results`

Registra este evento cuando se le hayan presentado al usuario los resultados de una búsqueda. Ten en cuenta que puedes habilitar la recopilación automática del evento view_search_results a través de la Medición mejorada de eventos en Google Analytics.

Parámetros

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento view_search_results con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_search_results",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "Clothing"
        }
      ]
    }
  ]
}

Protocolo de medición

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

`campaign_details`

Usa este evento para enviar detalles de la campaña que se aplicarán a los eventos con una marca de tiempo mayor o igual que la marca de tiempo del evento campaign_details.

Parámetros

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento campaign_details con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "campaign_details",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "campaign_id",
          "value": "google_1234"
        },
        {
          "parameterName": "campaign",
          "value": "Summer_fun"
        },
        {
          "parameterName": "source",
          "value": "google"
        },
        {
          "parameterName": "medium",
          "value": "cpc"
        },
        {
          "parameterName": "term",
          "value": "summer+travel"
        },
        {
          "parameterName": "content",
          "value": "logolink"
        }
      ]
    }
  ]
}

Protocolo de medición

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

Ventas en línea

`add_payment_info`

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

Campos del evento

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras. * Las métricas de valor en el evento `view_item` no contribuyen a los ingresos. * Si estableces `conversion_value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`conversion_value`	`number`	Sí*	30.03	Es el valor monetario del evento. * Establece `conversion_value` como la suma de `(price * quantity)` para todos los elementos de `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requiere `conversion_value` para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas `conversion_value`. * `currency` es obligatorio si configuras `conversion_value`.
`cart_data.items`	`Item[]`	Sí		Son los elementos del evento. Configura el campo `cart_data.items` en el objeto `Event`.
`cart_data.coupon_codes`	`string[]`	No	SUMMER_FUN	Es el código del cupón asociado con el evento. Configura el campo `coupon_codes` en el objeto `CartData`. * Proporciona solo un código de cupón en esta lista. * Esto es independiente de los códigos de cupón a nivel del artículo.

Campos de artículos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí	I_12345	Es un identificador único del elemento. Configura el campo `item_id` en el objeto `Item`.
`unit_price`	`number`	Sí	27.67	Es el precio unitario sin impuestos, envío ni descuentos a nivel de la transacción (con alcance del evento) para este artículo. Si el artículo tiene un descuento a nivel del artículo, usa el precio por unidad con descuento. Por ejemplo, si un artículo tiene un precio por unidad de 27.67 y un descuento por unidad de 6.66, establece `unitPrice` en 21.01.
`quantity`	`number`	Sí	1	Es la cantidad de unidades compradas de este artículo en particular.

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`payment_type`	`string`	No	Credit Card	Es la forma de pago elegida.

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento add_payment_info con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_payment_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "payment_type",
          "value": "Credit Card"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocolo de medición

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

`add_shipping_info`

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

Campos del evento

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras. * Las métricas de valor en el evento `view_item` no contribuyen a los ingresos. * Si estableces `conversion_value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`conversion_value`	`number`	Sí*	30.03	Es el valor monetario del evento. * Establece `conversion_value` como la suma de `(price * quantity)` para todos los elementos de `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requiere `conversion_value` para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas `conversion_value`. * `currency` es obligatorio si configuras `conversion_value`.
`cart_data.items`	`Item[]`	Sí		Son los elementos del evento. Configura el campo `cart_data.items` en el objeto `Event`.
`cart_data.coupon_codes`	`string[]`	No	SUMMER_FUN	Es el código del cupón asociado con el evento. Configura el campo `coupon_codes` en el objeto `CartData`. * Proporciona solo un código de cupón en esta lista. * Esto es independiente de los códigos de cupón a nivel del artículo.

Campos de artículos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí	I_12345	Es un identificador único del elemento. Configura el campo `item_id` en el objeto `Item`.
`unit_price`	`number`	Sí	27.67	Es el precio unitario sin impuestos, envío ni descuentos a nivel de la transacción (con alcance del evento) para este artículo. Si el artículo tiene un descuento a nivel del artículo, usa el precio por unidad con descuento. Por ejemplo, si un artículo tiene un precio por unidad de 27.67 y un descuento por unidad de 6.66, establece `unitPrice` en 21.01.
`quantity`	`number`	Sí	1	Es la cantidad de unidades compradas de este artículo en particular.

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`shipping_tier`	`string`	No	Suelo	Indica el nivel de envío (p.ej., `Ground`, `Air`, `Next-day`) seleccionado para la entrega del artículo comprado.

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento add_shipping_info con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_shipping_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping_tier",
          "value": "Ground"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocolo de medición

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

`add_to_cart`

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

Campos del evento

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

Campos de artículos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí	I_12345	Es un identificador único del elemento. Configura el campo `item_id` en el objeto `Item`.
`unit_price`	`number`	Sí	27.67	Es el precio unitario sin impuestos, envío ni descuentos a nivel de la transacción (con alcance del evento) para este artículo. Si el artículo tiene un descuento a nivel del artículo, usa el precio por unidad con descuento. Por ejemplo, si un artículo tiene un precio por unidad de 27.67 y un descuento por unidad de 6.66, establece `unitPrice` en 21.01.
`quantity`	`number`	Sí	1	Es la cantidad de unidades compradas de este artículo en particular.

Parámetros de elementos

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

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento add_to_cart con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocolo de medición

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

`add_to_wishlist`

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

Campos del evento

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

Campos de artículos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí	I_12345	Es un identificador único del elemento. Configura el campo `item_id` en el objeto `Item`.
`unit_price`	`number`	Sí	27.67	Es el precio unitario sin impuestos, envío ni descuentos a nivel de la transacción (con alcance del evento) para este artículo. Si el artículo tiene un descuento a nivel del artículo, usa el precio por unidad con descuento. Por ejemplo, si un artículo tiene un precio por unidad de 27.67 y un descuento por unidad de 6.66, establece `unitPrice` en 21.01.
`quantity`	`number`	Sí	1	Es la cantidad de unidades compradas de este artículo en particular.

Parámetros de elementos

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

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento add_to_wishlist con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_wishlist",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocolo de medición

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

`begin_checkout`

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

Campos del evento

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras. * Las métricas de valor en el evento `view_item` no contribuyen a los ingresos. * Si estableces `conversion_value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`conversion_value`	`number`	Sí*	30.03	Es el valor monetario del evento. * Establece `conversion_value` como la suma de `(price * quantity)` para todos los elementos de `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requiere `conversion_value` para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas `conversion_value`. * `currency` es obligatorio si configuras `conversion_value`.
`cart_data.items`	`Item[]`	Sí		Son los elementos del evento. Configura el campo `cart_data.items` en el objeto `Event`.
`cart_data.coupon_codes`	`string[]`	No	SUMMER_FUN	Es el código del cupón asociado con el evento. Configura el campo `coupon_codes` en el objeto `CartData`. * Proporciona solo un código de cupón en esta lista. * Esto es independiente de los códigos de cupón a nivel del artículo.

Campos de artículos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí	I_12345	Es un identificador único del elemento. Configura el campo `item_id` en el objeto `Item`.
`unit_price`	`number`	Sí	27.67	Es el precio unitario sin impuestos, envío ni descuentos a nivel de la transacción (con alcance del evento) para este artículo. Si el artículo tiene un descuento a nivel del artículo, usa el precio por unidad con descuento. Por ejemplo, si un artículo tiene un precio por unidad de 27.67 y un descuento por unidad de 6.66, establece `unitPrice` en 21.01.
`quantity`	`number`	Sí	1	Es la cantidad de unidades compradas de este artículo en particular.

Parámetros de elementos

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

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento begin_checkout con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "begin_checkout",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocolo de medición

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

`in_app_purchase`

Este evento solo está disponible para los flujos de aplicaciones.

Usa este evento cuando un usuario realiza una compra en la aplicación.

Campos del evento

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

Campos de artículos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí	I_12345	Es un identificador único del elemento. Configura el campo `item_id` en el objeto `Item`.
`unit_price`	`number`	Sí	27.67	Es el precio unitario sin impuestos, envío ni descuentos a nivel de la transacción (con alcance del evento) para este artículo. Si el artículo tiene un descuento a nivel del artículo, usa el precio por unidad con descuento. Por ejemplo, si un artículo tiene un precio por unidad de 27.67 y un descuento por unidad de 6.66, establece `unitPrice` en 21.01.
`quantity`	`number`	Sí	1	Es la cantidad de unidades compradas de este artículo en particular.

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`product_id`	`string`	No	ABC123456789	Es el ID del producto.
`subscription`	`boolean`	No	verdadero	Indica si la compra es una suscripción. Si no se establece, el valor predeterminado es `false`.
`free_trial`	`boolean`	No	verdadero	Indica si el evento es para una prueba gratuita de una suscripción. Si no se establece, el valor predeterminado es `false`.
`price_is_discounted`	`boolean`	No	falso	Indica si el `price` tiene descuento. Si no se establece, el valor predeterminado es `false`.

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento in_app_purchase con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "in_app_purchase",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "cartData": {
        "items": [
          {
            "itemId": "ABC123456789",
            "quantity": 3,
            "unitPrice": 10.01
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "subscription",
          "value": true
        },
        {
          "parameterName": "free_trial",
          "value": false
        },
        {
          "parameterName": "price_is_discounted",
          "value": false
        }
      ]
    }
  ]
}

Protocolo de medición

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({
    "app_instance_id": "app_instance_id",
    "events":[{
      "name":"in_app_purchase",
      "params":{
        "currency": "USD",
        "value": 30.03,
        "quantity": 3,
        "product_id": "ABC123456789",
        "subscription": true,
        "free_trial": false,
        "price_is_discounted": false
      }
    }]
  })
});

`purchase`

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

Campos del evento

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras. * Las métricas de valor en el evento `view_item` no contribuyen a los ingresos. * Si estableces `conversion_value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`conversion_value`	`number`	Sí*	30.03	Es el valor monetario del evento. * Establece `conversion_value` como la suma de `(price * quantity)` para todos los elementos de `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requiere `conversion_value` para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas `conversion_value`. * `currency` es obligatorio si configuras `conversion_value`.
`transaction_id`	`string`	Sí	T_12345	Es el identificador único de una transacción. El parámetro `transaction_id` te ayuda a evitar recibir eventos duplicados por una compra. Configura el campo `transaction_id` en el objeto `Event`.
`user_properties.customer_type`	`CustomerType`	No	`NEW`	Indica si la conversión proviene de un cliente de `NEW` o `RETURNING`.
`cart_data.items`	`Item[]`	Sí		Son los elementos del evento. Configura el campo `cart_data.items` en el objeto `Event`.
`cart_data.coupon_codes`	`string[]`	No	SUMMER_FUN	Es el código del cupón asociado con el evento. Configura el campo `coupon_codes` en el objeto `CartData`. * Proporciona solo un código de cupón en esta lista. * Esto es independiente de los códigos de cupón a nivel del artículo.

Campos de artículos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí	I_12345	Es un identificador único del elemento. Configura el campo `item_id` en el objeto `Item`.
`unit_price`	`number`	Sí	27.67	Es el precio unitario sin impuestos, envío ni descuentos a nivel de la transacción (con alcance del evento) para este artículo. Si el artículo tiene un descuento a nivel del artículo, usa el precio por unidad con descuento. Por ejemplo, si un artículo tiene un precio por unidad de 27.67 y un descuento por unidad de 6.66, establece `unitPrice` en 21.01.
`quantity`	`number`	Sí	1	Es la cantidad de unidades compradas de este artículo en particular.

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`shipping`	`number`	No	3.33	Es el costo de envío asociado a una transacción.
`tax`	`number`	No	1.11	Es el costo de impuestos asociado con una transacción.

Parámetros de elementos

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

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento purchase con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "purchase",
      "transactionId": "TRANSACTION_ID",
      "conversionValue": 83.99,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "userProperties": {
        "customerType": "RETURNING"
      },
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 3,
            "unitPrice": 10.01,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Stan and Friends Tee"
              },
              {
                "parameterName": "affiliation",
                "value": "Google Merchandise Store"
              },
              {
                "parameterName": "discount",
                "value": "2.22"
              },
              {
                "parameterName": "index",
                "value": "0"
              },
              {
                "parameterName": "item_brand",
                "value": "Google"
              },
              {
                "parameterName": "item_category",
                "value": "Apparel"
              },
              {
                "parameterName": "item_category2",
                "value": "Adult"
              },
              {
                "parameterName": "item_category3",
                "value": "Shirts"
              },
              {
                "parameterName": "item_category4",
                "value": "Crew"
              },
              {
                "parameterName": "item_category5",
                "value": "Short sleeve"
              },
              {
                "parameterName": "item_list_id",
                "value": "related_products"
              },
              {
                "parameterName": "item_list_name",
                "value": "Related Products"
              },
              {
                "parameterName": "item_variant",
                "value": "green"
              },
              {
                "parameterName": "location_id",
                "value": "ChIJIQBpAG2ahYAR_6128GcTUEo"
              },
              {
                "parameterName": "google_business_vertical",
                "value": "retail"
              }
            ]
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": "3.33"
        },
        {
          "parameterName": "tax",
          "value": "1.11"
        }
      ]
    }
  ]
}

Protocolo de medición

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

`refund`

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

Campos del evento

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras. * Las métricas de valor en el evento `view_item` no contribuyen a los ingresos. * Si estableces `conversion_value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`conversion_value`	`number`	Sí*	30.03	Es el valor monetario del evento. * Establece `conversion_value` como la suma de `(price * quantity)` para todos los elementos de `items`. No incluyas `shipping` ni `tax`. * Por lo general, se requiere `conversion_value` para generar informes significativos. Si marcas el evento como evento clave, te recomendamos que establezcas `conversion_value`. * `currency` es obligatorio si configuras `conversion_value`.
`transaction_id`	`string`	Sí	T_12345	Es el identificador único de una transacción.
`cart_data.items`	`Item[]`	No		Son los elementos del evento. Configura el campo `cart_data.items` en el objeto `Event`.
`cart_data.coupon_codes`	`string[]`	No	SUMMER_FUN	Es el código del cupón asociado con el evento. Configura el campo `coupon_codes` en el objeto `CartData`. * Proporciona solo un código de cupón en esta lista. * Esto es independiente de los códigos de cupón a nivel del artículo.

Campos de artículos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí	I_12345	Es un identificador único del elemento. Configura el campo `item_id` en el objeto `Item`.
`unit_price`	`number`	Sí	27.67	Es el precio unitario sin impuestos, envío ni descuentos a nivel de la transacción (con alcance del evento) para este artículo. Si el artículo tiene un descuento a nivel del artículo, usa el precio por unidad con descuento. Por ejemplo, si un artículo tiene un precio por unidad de 27.67 y un descuento por unidad de 6.66, establece `unitPrice` en 21.01.
`quantity`	`number`	Sí	1	Es la cantidad de unidades compradas de este artículo en particular.

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`shipping`	`number`	No	3.33	Es el costo de envío asociado a una transacción.
`tax`	`number`	No	1.11	Es el costo de impuestos asociado con una transacción.

Parámetros de elementos

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

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento refund con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "refund",
      "conversionValue": 30.03,
      "currency": "USD",
      "transactionId": "T_12345",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": 3.33
        },
        {
          "parameterName": "tax",
          "value": 1.11
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocolo de medición

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

`remove_from_cart`

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

Campos del evento

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

Campos de artículos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí	I_12345	Es un identificador único del elemento. Configura el campo `item_id` en el objeto `Item`.
`unit_price`	`number`	Sí	27.67	Es el precio unitario sin impuestos, envío ni descuentos a nivel de la transacción (con alcance del evento) para este artículo. Si el artículo tiene un descuento a nivel del artículo, usa el precio por unidad con descuento. Por ejemplo, si un artículo tiene un precio por unidad de 27.67 y un descuento por unidad de 6.66, establece `unitPrice` en 21.01.
`quantity`	`number`	Sí	1	Es la cantidad de unidades compradas de este artículo en particular.

Parámetros de elementos

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

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento remove_from_cart con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "remove_from_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocolo de medición

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

`select_item`

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

Campos del evento

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`cart_data.items`	`Item[]`	Sí*		Son los elementos del evento. * Se espera que el array `items` tenga un solo elemento, que representa el elemento seleccionado. Si se proporcionan varios elementos, solo se usará el primer elemento de `items`. Configura el campo `cart_data.items` en el objeto `Event`.

Parámetros

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

Parámetros de elementos

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

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento select_item con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_item",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocolo de medición

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

`select_promotion`

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

Campos del evento

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`cart_data.items`	`Item[]`	No		Son los elementos del evento. Configura el campo `cart_data.items` en el objeto `Event`.

Campos de artículos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí	I_12345	Es un identificador único del elemento. Configura el campo `item_id` en el objeto `Item`.
`unit_price`	`number`	Sí	27.67	Es el precio unitario sin impuestos, envío ni descuentos a nivel de la transacción (con alcance del evento) para este artículo. Si el artículo tiene un descuento a nivel del artículo, usa el precio por unidad con descuento. Por ejemplo, si un artículo tiene un precio por unidad de 27.67 y un descuento por unidad de 6.66, establece `unitPrice` en 21.01.
`quantity`	`number`	Sí	1	Es la cantidad de unidades compradas de este artículo en particular.

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad de promoción.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad de promoción asociado al evento.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada al evento.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada al evento.

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

Parámetros de elementos

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

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento select_promotion con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocolo de medición

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`view_cart`

Este evento indica que un usuario vio su carrito.

Campos del evento

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

Campos de artículos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí	I_12345	Es un identificador único del elemento. Configura el campo `item_id` en el objeto `Item`.
`unit_price`	`number`	Sí	27.67	Es el precio unitario sin impuestos, envío ni descuentos a nivel de la transacción (con alcance del evento) para este artículo. Si el artículo tiene un descuento a nivel del artículo, usa el precio por unidad con descuento. Por ejemplo, si un artículo tiene un precio por unidad de 27.67 y un descuento por unidad de 6.66, establece `unitPrice` en 21.01.
`quantity`	`number`	Sí	1	Es la cantidad de unidades compradas de este artículo en particular.

Parámetros de elementos

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

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento view_cart con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_cart",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocolo de medición

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

`view_item`

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

Campos del evento

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

Campos de artículos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí	I_12345	Es un identificador único del elemento. Configura el campo `item_id` en el objeto `Item`.
`unit_price`	`number`	Sí	27.67	Es el precio unitario sin impuestos, envío ni descuentos a nivel de la transacción (con alcance del evento) para este artículo. Si el artículo tiene un descuento a nivel del artículo, usa el precio por unidad con descuento. Por ejemplo, si un artículo tiene un precio por unidad de 27.67 y un descuento por unidad de 6.66, establece `unitPrice` en 21.01.
`quantity`	`number`	Sí	1	Es la cantidad de unidades compradas de este artículo en particular.

Parámetros de elementos

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

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento view_item con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocolo de medición

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

`view_item_list`

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

Campos del evento

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`currency`	`string`	Sí*	USD	Moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras. * Las métricas de valor en el evento `view_item` no contribuyen a los ingresos. * Si estableces `conversion_value`, se requiere `currency` para que las métricas de ingresos se calculen con precisión.
`cart_data.items`	`Item[]`	Sí		Son los elementos del evento. Configura el campo `cart_data.items` en el objeto `Event`.

Campos de artículos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí	I_12345	Es un identificador único del elemento. Configura el campo `item_id` en el objeto `Item`.
`unit_price`	`number`	Sí	27.67	Es el precio unitario sin impuestos, envío ni descuentos a nivel de la transacción (con alcance del evento) para este artículo. Si el artículo tiene un descuento a nivel del artículo, usa el precio por unidad con descuento. Por ejemplo, si un artículo tiene un precio por unidad de 27.67 y un descuento por unidad de 6.66, establece `unitPrice` en 21.01.
`quantity`	`number`	Sí	1	Es la cantidad de unidades compradas de este artículo en particular.

Parámetros de elementos

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

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento view_item_list con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item_list",
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocolo de medición

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

`view_promotion`

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

Campos del evento

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`cart_data.items`	`Item[]`	Sí*		Son los elementos del evento. * Se espera que el array `items` tenga un solo elemento, que representa el artículo asociado con la promoción. Si se proporcionan varios elementos, solo se usará el primer elemento de `items`. Configura el campo `cart_data.items` en el objeto `Event`.

Campos de artículos

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`item_id`	`string`	Sí	I_12345	Es un identificador único del elemento. Configura el campo `item_id` en el objeto `Item`.
`unit_price`	`number`	Sí	27.67	Es el precio unitario sin impuestos, envío ni descuentos a nivel de la transacción (con alcance del evento) para este artículo. Si el artículo tiene un descuento a nivel del artículo, usa el precio por unidad con descuento. Por ejemplo, si un artículo tiene un precio por unidad de 27.67 y un descuento por unidad de 6.66, establece `unitPrice` en 21.01.
`quantity`	`number`	Sí	1	Es la cantidad de unidades compradas de este artículo en particular.

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`creative_name`	`string`	No	summer_banner2	Es el nombre de la creatividad de promoción.
`creative_slot`	`string`	No	featured_app_1	Es el nombre del espacio para la creatividad de promoción asociado al evento.
`promotion_id`	`string`	No	P_12345	Es el ID de la promoción asociada al evento.
`promotion_name`	`string`	No	Ofertas de verano	Es el nombre de la promoción asociada al evento.

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

Parámetros de elementos

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

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento view_promotion con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Protocolo de medición

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

Videojuegos

`level_up`

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

Parámetros

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento level_up con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "level_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Protocolo de medición

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

`post_score`

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

Parámetros

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento post_score con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "post_score",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "score",
          "value": 10000
        },
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Protocolo de medición

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

`unlock_achievement`

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

Parámetros

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento unlock_achievement con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "unlock_achievement",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "achievement_id",
          "value": "A_12345"
        }
      ]
    }
  ]
}

Protocolo de medición

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

Generación de clientes potenciales

`close_convert_lead`

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

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

Campos del evento

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento close_convert_lead con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_convert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Protocolo de medición

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "close_convert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

`close_unconvert_lead`

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

Campos del evento

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`unconvert_lead_reason`	`string`	No	Nunca respondió	Es el motivo por el que no se generó una conversión del cliente potencial.

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento close_unconvert_lead con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_unconvert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "unconvert_lead_reason",
          "value": "Never responded"
        }
      ]
    }
  ]
}

Protocolo de medición

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "close_unconvert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "unconvert_lead_reason": "Never responded"
      }
    }]
  })
});

`disqualify_lead`

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

Campos del evento

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`disqualified_lead_reason`	`string`	No	No quiero comprar	Es el motivo por el que un cliente potencial se marcó como descalificado.

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento disqualify_lead con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "disqualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "disqualified_lead_reason",
          "value": "Not looking to buy"
        }
      ]
    }
  ]
}

Protocolo de medición

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "disqualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "disqualified_lead_reason": "Not looking to buy"
      }
    }]
  })
});

`generate_lead`

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

Campos del evento

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`lead_source`	`string`	No	Feria comercial	Es la fuente del cliente potencial.

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento generate_lead con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "generate_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_source",
          "value": "Trade show"
        }
      ]
    }
  ]
}

Protocolo de medición

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "generate_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_source": "Trade show"
      }
    }]
  })
});

`qualify_lead`

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

Campos del evento

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento qualify_lead con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "qualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Protocolo de medición

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "qualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

`working_lead`

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

Campos del evento

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

Parámetros

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
`lead_status`	`string`	No	Conversaciones iniciadas	Es el estado del cliente potencial.

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento working_lead con la API de Data Manager. Si vas a actualizar desde Measurement Protocol, usa las pestañas para migrar tus solicitudes a la API de Data Manager.

API de Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "working_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_status",
          "value": "Started conversations"
        }
      ]
    }
  ]
}

Protocolo de medición

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "working_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_status": "Started conversations"
      }
    }]
  })
});

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

Para todas las propiedades

ad_impression

Campos del evento

Parámetros

Ejemplo

API de Data Manager

Protocolo de medición

earn_virtual_currency

Campos del evento

Parámetros

Ejemplo

API de Data Manager

Protocolo de medición

join_group

Parámetros

Ejemplo

API de Data Manager

Protocolo de medición

login

Parámetros

Ejemplo

API de Data Manager

Protocolo de medición

screen_view

Parámetros

Ejemplo

API de Data Manager

Protocolo de medición

search

Parámetros

Ejemplo

API de Data Manager

Protocolo de medición

select_content

Parámetros

Ejemplo

API de Data Manager

Protocolo de medición

share

Campos del evento

Campos de artículos

Parámetros

Ejemplo

API de Data Manager

Protocolo de medición

sign_up

Parámetros

Ejemplo

API de Data Manager

Protocolo de medición

spend_virtual_currency

Campos del evento

Campos de artículos

Parámetros de elementos

Parámetros

Ejemplo

API de Data Manager

Protocolo de medición

tutorial_begin

Parámetros

Ejemplo

API de Data Manager

Protocolo de medición

tutorial_complete

Parámetros

Ejemplo

API de Data Manager

Protocolo de medición

view_search_results

Parámetros

Ejemplo

API de Data Manager

Protocolo de medición

campaign_details

Parámetros

Ejemplo

API de Data Manager

Protocolo de medición

Ventas en línea

Eventos recomendados de Google Analytics

`ad_impression`

`earn_virtual_currency`

`join_group`

`login`

`screen_view`

`search`

`select_content`

`share`

`sign_up`

`spend_virtual_currency`

`tutorial_begin`

`tutorial_complete`

`view_search_results`

`campaign_details`

`add_payment_info`

`add_shipping_info`

`add_to_cart`

`add_to_wishlist`

`begin_checkout`

`in_app_purchase`

`purchase`

`refund`

`remove_from_cart`

`select_item`