Eventos recomendados de Google Analytics

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

Cuando crees nombres de eventos personalizados, debes tener en cuenta lo siguiente:

  1. Sigue las reglas para asignar nombres a los eventos.
  2. Evita los prefijos y nombres reservados.
  3. Respeta 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 actualizas 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 apps.

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

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

Campos del evento

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string No USD Indica la moneda de los artículos asociados con el evento, en formato ISO 4217 de 3 letras.

* Si estableces conversion_value, debes establecer 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 de 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 de anuncios.
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 Data Manager. Si actualizas desde el Protocolo de medición, 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 cuándo 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 Indica 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 actualizas desde el Protocolo de medición, 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 actualizas desde el Protocolo de medición, 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 app.

Parámetros

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento login con la API de Data Manager. Si actualizas desde el Protocolo de medición, 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 apps.

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

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
screen_class string No MainActivity Es la clase de la pantalla.
screen_name string No 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 actualizas desde el Protocolo de medición, 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"
      }
    }]
  })
});

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

Parámetros

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

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento search con la API de Data Manager. Si actualizas desde el Protocolo de medición, 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 app.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
content_type string No producto Es el tipo de contenido seleccionado.
content_id string No C_12345 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 actualizas desde el Protocolo de medición, 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 artículos 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 para el artículo. Configura el campo item_id en el objeto Item.
unit_price number Sí 27.67 Es el precio unitario de este artículo, sin incluir los impuestos, el envío ni los descuentos con alcance de evento (a nivel de la transacción).

Si el artículo tiene un descuento con alcance de artículo, usa el precio unitario 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 Indica 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 actualizas desde el Protocolo de medición, 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 usa para registrarse.

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento sign_up con la API de Data Manager. Si actualizas desde el Protocolo de medición, 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 Indica el valor de la moneda virtual.
cart_data.items Item[] No Son los artículos 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 para el artículo. Configura el campo item_id en el objeto Item.
unit_price number Sí 27.67 Es el precio unitario de este artículo, sin incluir los impuestos, el envío ni los descuentos con alcance de evento (a nivel de la transacción).

Si el artículo tiene un descuento con alcance de artículo, usa el precio unitario 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 Indica 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 actualizas desde el Protocolo de medición, 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. Usa este evento 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 actualizas desde el Protocolo de medición, 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ó el proceso de integración. Usa este evento 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 actualizas desde el Protocolo de medición, 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 presenten al usuario los resultados de una búsqueda. Ten en cuenta que puedes habilitar el evento view_search_results para la recopilación automática a través de la medición de eventos optimizada en Google Analytics.

Parámetros

Nombre Tipo Obligatorio Valor de ejemplo Descripción
search_term string No Ropa 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 actualizas desde el Protocolo de medición, 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 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 o campaña estratégica específica.
source string No google Es la fuente de tráfico de la campaña (p.ej., Google, correo electrónico, etc.).
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 utiliza 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 actualizas desde el Protocolo de medición, 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 la compra de comercio electrónico.

Campos del evento

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Indica la 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, debes establecer 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 en la suma de (price * quantity) para todos los artículos en items. No incluyas shipping ni tax.
* Por lo general, se requiere conversion_value para generar informes significativos. Si marcas el evento como un evento clave, te recomendamos que configures conversion_value.
* currency es obligatorio si configuras conversion_value.
cart_data.items Item[] Sí Son los artículos 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.
* Este parámetro 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 para el artículo. Configura el campo item_id en el objeto Item.
unit_price number Sí 27.67 Es el precio unitario de este artículo, sin incluir los impuestos, el envío ni los descuentos con alcance de evento (a nivel de la transacción).

Si el artículo tiene un descuento con alcance de artículo, usa el precio unitario 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 Indica 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 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 actualizas desde el Protocolo de medición, 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 la compra de comercio electrónico.

Campos del evento

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Indica la 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, debes establecer 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 en la suma de (price * quantity) para todos los artículos en items. No incluyas shipping ni tax. Por lo general, se requiere
* conversion_value para generar informes significativos. Si marcas el evento como un evento clave, te recomendamos que configures conversion_value.
* currency es obligatorio si configuras conversion_value.
cart_data.items Item[] Sí Son los artículos 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.
* Este parámetro 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 para el artículo. Configura el campo item_id en el objeto Item.
unit_price number Sí 27.67 Es el precio unitario de este artículo, sin incluir los impuestos, el envío ni los descuentos con alcance de evento (a nivel de la transacción).

Si el artículo tiene un descuento con alcance de artículo, usa el precio unitario 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 Indica 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 actualizas desde el Protocolo de medición, 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 Indica la 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, debes establecer 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 en la suma de (price * quantity) para todos los artículos en items. No incluyas shipping ni tax.
* Por lo general, se requiere conversion_value para generar informes significativos. Si marcas el evento como un evento clave, te recomendamos que configures conversion_value.
* currency es obligatorio si configuras conversion_value.
cart_data.items Item[] Sí Son los artículos 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 para el artículo. Configura el campo item_id en el objeto Item.
unit_price number Sí 27.67 Es el precio unitario de este artículo, sin incluir los impuestos, el envío ni los descuentos con alcance de evento (a nivel de la transacción).

Si el artículo tiene un descuento con alcance de artículo, usa el precio unitario 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 Indica 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 una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: affiliation solo está disponible en el alcance del elemento.
coupon string No SUMMER_FUN Indica el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
item_category3 string No Camisas Es la 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 establece, 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 establece, 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 Indica la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponda al artículo 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 actualizas desde el Protocolo de medición, 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 artículo 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 Indica la 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, debes establecer 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 en la suma de (price * quantity) para todos los artículos en items. No incluyas shipping ni tax.
* Por lo general, se requiere conversion_value para generar informes significativos. Si marcas el evento como un evento clave, te recomendamos que configures conversion_value.
* currency es obligatorio si configuras conversion_value.
cart_data.items Item[] Sí Son los artículos 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 para el artículo. Configura el campo item_id en el objeto Item.
unit_price number Sí 27.67 Es el precio unitario de este artículo, sin incluir los impuestos, el envío ni los descuentos con alcance de evento (a nivel de la transacción).

Si el artículo tiene un descuento con alcance de artículo, usa el precio unitario 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 Indica 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 una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: affiliation solo está disponible en el alcance del elemento.
coupon string No SUMMER_FUN Indica el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
item_category3 string No Camisas Es la 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 establece, 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 establece, 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 Indica la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponda al artículo 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 actualizas desde el Protocolo de medición, 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ó la confirmación de la compra.

Campos del evento

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Indica la 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, debes establecer 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 en la suma de (price * quantity) para todos los artículos en items. No incluyas shipping ni tax.
* Por lo general, se requiere conversion_value para generar informes significativos. Si marcas el evento como un evento clave, te recomendamos que configures conversion_value.
* currency es obligatorio si configuras conversion_value.
cart_data.items Item[] Sí Son los artículos 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.
* Este parámetro 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 para el artículo. Configura el campo item_id en el objeto Item.
unit_price number Sí 27.67 Es el precio unitario de este artículo, sin incluir los impuestos, el envío ni los descuentos con alcance de evento (a nivel de la transacción).

Si el artículo tiene un descuento con alcance de artículo, usa el precio unitario 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 Indica 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 una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: affiliation solo está disponible en el alcance del elemento.
coupon string No SUMMER_FUN Indica el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
item_category3 string No Camisas Es la 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 establece, 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 establece, 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 Indica la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponda al artículo 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 actualizas desde el Protocolo de medición, 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 apps.

Usa este evento cuando un usuario realice una compra directa desde la app.

Campos del evento

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Es la moneda del conversion_value del evento, en formato ISO 4217 de 3 letras.

* Si estableces conversion_value, debes establecer 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 un evento clave, te recomendamos que configures conversion_value.
* currency es obligatorio si configuras conversion_value.
transaction_id string No 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.
cart_data.items Item[] No Son los artículos 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 para el artículo. Configura el campo item_id en el objeto Item.
unit_price number Sí 27.67 Es el precio unitario de este artículo, sin incluir los impuestos, el envío ni los descuentos con alcance de evento (a nivel de la transacción).

Si el artículo tiene un descuento con alcance de artículo, usa el precio unitario 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 Indica 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 se aplica un descuento al price.
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 actualizas desde el Protocolo de medición, 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",
      "transactionId": "T_12345",
      "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,
        "transaction_id": "T_12345",
        "product_id": "ABC123456789",
        "subscription": true,
        "free_trial": false,
        "price_is_discounted": false
      }
    }]
  })
});

purchase

Este evento indica que un usuario compró uno o más artículos.

Campos del evento

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Indica la 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, debes establecer 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 en la suma de (price * quantity) para todos los artículos en items. No incluyas shipping ni tax.
* Por lo general, se requiere conversion_value para generar informes significativos. Si marcas el evento como un evento clave, te recomendamos que configures 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 NEW o RETURNING.
cart_data.items Item[] Sí Son los artículos 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.
* Este parámetro 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 para el artículo. Configura el campo item_id en el objeto Item.
unit_price number Sí 27.67 Es el precio unitario de este artículo, sin incluir los impuestos, el envío ni los descuentos con alcance de evento (a nivel de la transacción).

Si el artículo tiene un descuento con alcance de artículo, usa el precio unitario 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 Indica 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 Indica el costo de envío asociado a una transacción.
tax number No 1.11 Indica 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 una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: affiliation solo está disponible en el alcance del elemento.
coupon string No SUMMER_FUN Indica el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
item_category3 string No Camisas Es la 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 establece, 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 establece, 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 Indica la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponda al artículo 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 actualizas desde el Protocolo de medición, 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 que se reembolsaron uno o más artículos a un usuario.

Campos del evento

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Indica la 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, debes establecer 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 en la suma de (price * quantity) para todos los artículos en items. No incluyas shipping ni tax. Por lo general, se requiere
* conversion_value para generar informes significativos. Si marcas el evento como un evento clave, te recomendamos que configures 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 artículos 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.
* Este parámetro 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 para el artículo. Configura el campo item_id en el objeto Item.
unit_price number Sí 27.67 Es el precio unitario de este artículo, sin incluir los impuestos, el envío ni los descuentos con alcance de evento (a nivel de la transacción).

Si el artículo tiene un descuento con alcance de artículo, usa el precio unitario 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 Indica 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 Indica el costo de envío asociado a una transacción.
tax number No 1.11 Indica 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 una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: affiliation solo está disponible en el alcance del elemento.
coupon string No SUMMER_FUN Indica el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
item_category3 string No Camisas Es la 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 establece, 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 establece, 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 Indica la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponda al artículo 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 actualizas desde el Protocolo de medición, 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 Indica la 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, debes establecer 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 en la suma de (price * quantity) para todos los artículos en items. No incluyas shipping ni tax.
* Por lo general, se requiere conversion_value para generar informes significativos. Si marcas el evento como un evento clave, te recomendamos que configures conversion_value.
* currency es obligatorio si configuras conversion_value.
cart_data.items Item[] Sí Son los artículos 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 para el artículo. Configura el campo item_id en el objeto Item.
unit_price number Sí 27.67 Es el precio unitario de este artículo, sin incluir los impuestos, el envío ni los descuentos con alcance de evento (a nivel de la transacción).

Si el artículo tiene un descuento con alcance de artículo, usa el precio unitario 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 Indica 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 una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: affiliation solo está disponible en el alcance del elemento.
coupon string No SUMMER_FUN Indica el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
item_category3 string No Camisas Es la 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 establece, 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 establece, 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 Indica la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponda al artículo 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 actualizas desde el Protocolo de medición, 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 artículos del evento.

* Se espera que el array items tenga un solo elemento, que represente el elemento seleccionado. Si se proporcionan varios elementos, solo se usará el primero en 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 establece a nivel del elemento.
item_list_name string No Productos relacionados El nombre de la lista en la que se presentó el artículo al usuario

Se ignora si se establece a nivel del elemento.

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 una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: affiliation solo está disponible en el alcance del elemento.
coupon string No SUMMER_FUN Indica el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
item_category3 string No Camisas Es la 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 establece, 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 establece, 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 Indica la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponda al artículo 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 actualizas desde el Protocolo de medición, 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 artículos 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 para el artículo. Configura el campo item_id en el objeto Item.
unit_price number Sí 27.67 Es el precio unitario de este artículo, sin incluir los impuestos, el envío ni los descuentos con alcance de evento (a nivel de la transacción).

Si el artículo tiene un descuento con alcance de artículo, usa el precio unitario 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 Indica 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 Indica 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 con el evento.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada al 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 una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: affiliation solo está disponible en el alcance del elemento.
coupon string No SUMMER_FUN Indica el nombre o código del cupón asociado con el artículo.

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

El valor predeterminado es a nivel del evento creative_name si no se establece.
creative_slot string No featured_app_1 Indica el nombre del espacio para la creatividad de promoción asociado al artículo.

El valor predeterminado es a nivel del evento creative_slot si no se establece.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
item_category3 string No Camisas Es la 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 establece, 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 establece, 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 Indica la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponda al artículo 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 artículo.

Si no se establece, el valor predeterminado es a nivel del evento promotion_id.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada con el artículo.

Si no se establece, el valor predeterminado es a nivel del evento promotion_name.
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 actualizas desde el Protocolo de medición, 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 Indica la 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, debes establecer 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 en la suma de (price * quantity) para todos los artículos en items. No incluyas shipping ni tax.
* Por lo general, se requiere conversion_value para generar informes significativos. Si marcas el evento como un evento clave, te recomendamos que configures conversion_value.
* currency es obligatorio si configuras conversion_value.
cart_data.items Item[] Sí Son los artículos 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 para el artículo. Configura el campo item_id en el objeto Item.
unit_price number Sí 27.67 Es el precio unitario de este artículo, sin incluir los impuestos, el envío ni los descuentos con alcance de evento (a nivel de la transacción).

Si el artículo tiene un descuento con alcance de artículo, usa el precio unitario 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 Indica 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 una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: affiliation solo está disponible en el alcance del elemento.
coupon string No SUMMER_FUN Indica el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
item_category3 string No Camisas Es la 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 establece, 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 establece, 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 Indica la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponda al artículo 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 actualizas desde el Protocolo de medición, 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ó algún 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 Indica la 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, debes establecer 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 en la suma de (price * quantity) para todos los artículos en items. No incluyas shipping ni tax.
* Por lo general, se requiere conversion_value para generar informes significativos. Si marcas el evento como un evento clave, te recomendamos que configures conversion_value.
* currency es obligatorio si configuras conversion_value.
cart_data.items Item[] Sí Son los artículos 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 para el artículo. Configura el campo item_id en el objeto Item.
unit_price number Sí 27.67 Es el precio unitario de este artículo, sin incluir los impuestos, el envío ni los descuentos con alcance de evento (a nivel de la transacción).

Si el artículo tiene un descuento con alcance de artículo, usa el precio unitario 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 Indica 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 una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: affiliation solo está disponible en el alcance del elemento.
coupon string No SUMMER_FUN Indica el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
item_category3 string No Camisas Es la 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 establece, 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 establece, 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 Indica la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponda al artículo 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 actualizas desde el Protocolo de medición, 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 presente al usuario una lista de artículos de una categoría determinada.

Campos del evento

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Indica la 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, debes establecer currency para que las métricas de ingresos se calculen con precisión.
cart_data.items Item[] Sí Son los artículos 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 para el artículo. Configura el campo item_id en el objeto Item.
unit_price number Sí 27.67 Es el precio unitario de este artículo, sin incluir los impuestos, el envío ni los descuentos con alcance de evento (a nivel de la transacción).

Si el artículo tiene un descuento con alcance de artículo, usa el precio unitario 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 Indica 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 una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: affiliation solo está disponible en el alcance del elemento.
coupon string No SUMMER_FUN Indica el nombre o código del cupón asociado con el artículo.

Los parámetros coupon a nivel del evento y del artículo son independientes.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
item_category3 string No Camisas Es la 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 establece, 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 establece, 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 Indica la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponda al artículo 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 actualizas desde el Protocolo de medición, 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 de una lista.

Campos del evento

Nombre Tipo Obligatorio Valor de ejemplo Descripción
cart_data.items Item[] Sí* Son los artículos del evento.

* Se espera que el array items tenga un solo elemento, que represente el artículo asociado con la promoción. Si se proporcionan varios elementos, solo se usará el primero en 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 para el artículo. Configura el campo item_id en el objeto Item.
unit_price number Sí 27.67 Es el precio unitario de este artículo, sin incluir los impuestos, el envío ni los descuentos con alcance de evento (a nivel de la transacción).

Si el artículo tiene un descuento con alcance de artículo, usa el precio unitario 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 Indica 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 Indica 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 con el evento.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada al 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 una afiliación de producto para designar una empresa proveedora o la ubicación de una tienda física.
Nota: affiliation solo está disponible en el alcance del elemento.
coupon string No SUMMER_FUN Indica el nombre o código del cupón asociado con el artículo.

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

El valor predeterminado es a nivel del evento creative_name si no se establece.
creative_slot string No featured_app_1 Indica el nombre del espacio para la creatividad de promoción asociado al artículo.

El valor predeterminado es a nivel del evento creative_slot si no se establece.
discount number No 2.22 Indica el valor de descuento monetario por unidad asociado con el artículo.
index number No 5 Es el índice o la posición del elemento en una lista.
item_brand string No Google Se refiere a la marca del artículo.
item_category string No Indumentaria La categoría del artículo Si se usa como parte de una jerarquía o taxonomía de categorías, esta será la primera categoría.
item_category2 string No Adultos Es la segunda jerarquía de categorías o taxonomía adicional del artículo.
item_category3 string No Camisas Es la 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 establece, 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 establece, 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 Indica la variante o el código único del artículo o la descripción para obtener opciones o detalles adicionales del artículo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (el ID de lugar de Google para San Francisco) Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponda al artículo 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 artículo.

Si no se establece, el valor predeterminado es a nivel del evento promotion_id.
promotion_name string No Ofertas de verano Es el nombre de la promoción asociada con el artículo.

Si no se establece, el valor predeterminado es a nivel del evento promotion_name.
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 actualizas desde el Protocolo de medición, 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 actualizas desde el Protocolo de medición, 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 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 actualizas desde el Protocolo de medición, 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 haya desbloqueado 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 actualizas desde el Protocolo de medición, 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 lead calificado se convierte correctamente en un cliente. Por lo general, esto significa el final del proceso de desarrollo de clientes potenciales, como 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 demostraciones, usa el evento generate_lead.

Campos del evento

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Es la moneda del conversion_value del evento, en formato ISO 4217 de 3 letras.

* Si estableces conversion_value, debes establecer 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 un evento clave, te recomendamos que configures 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 actualizas desde el Protocolo de medición, 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 cuándo se marca que un usuario 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 Es la moneda del conversion_value del evento, en formato ISO 4217 de 3 letras.

* Si estableces conversion_value, debes establecer 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 un evento clave, te recomendamos que configures 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 el cliente potencial no generó una conversión.

Ejemplo

En el siguiente ejemplo, se muestra cómo enviar un evento close_unconvert_lead con la API de Data Manager. Si actualizas desde el Protocolo de medición, 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 cuándo se marca a un usuario 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 Es la moneda del conversion_value del evento, en formato ISO 4217 de 3 letras.

* Si estableces conversion_value, debes establecer 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 un evento clave, te recomendamos que configures 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 busca 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 actualizas desde el Protocolo de medición, 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 cuándo se genera un cliente potencial (por ejemplo, a través de un formulario). Registra este evento para comprender la eficacia de tus campañas de marketing y cuántos clientes vuelven a interactuar con tu empresa después de que se les hace remarketing.

Campos del evento

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Es la moneda del conversion_value del evento, en formato ISO 4217 de 3 letras.

* Si estableces conversion_value, debes establecer 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 un evento clave, te recomendamos que configures 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 actualizas desde el Protocolo de medición, 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 cuándo se marca que un usuario cumple con los criterios para convertirse en un lead calificado.

Campos del evento

Nombre Tipo Obligatorio Valor de ejemplo Descripción
currency string Sí* USD Es la moneda del conversion_value del evento, en formato ISO 4217 de 3 letras.

* Si estableces conversion_value, debes establecer 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 un evento clave, te recomendamos que configures 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 actualizas desde el Protocolo de medición, 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 cuándo 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 Es la moneda del conversion_value del evento, en formato ISO 4217 de 3 letras.

* Si estableces conversion_value, debes establecer 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 un evento clave, te recomendamos que configures 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 actualizas desde el Protocolo de medición, 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"
      }
    }]
  })
});