Enviar eventos

Introducción

En esta guía se explica cómo dar formato a las solicitudes y cómo enviarlas al Protocolo de medición de Google Analytics.

Enviar eventos

Para enviar un evento, haz una solicitud HTTP POST al siguiente punto de acceso:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>

Parámetros obligatorios

Para que una solicitud sea válida, se necesitan dos conjuntos de parámetros que varían si usas Firebase o gtag.js:

  1. Parámetros de URL

    • api_secret: obligatorio. API SECRET generado en la interfaz de Google Analytics. Para crear un secreto, ve a:
      Administrador > Flujos de datos > (elegir un flujo) > Protocolo de medición > Crear.

    Consulta la referencia completa de los parámetros de consulta.

  2. Cuerpo del archivo JSON

    • user_id: opcional. Identificador único de un usuario. Consulta el artículo User-ID en análisis multiplataforma para obtener más información sobre este identificador.

    • events: obligatorio. Array de elementos de eventos.

    Consulta la referencia completa en el artículo CUERPO DE PUBLICACIÓN JSON.

Parámetros opcionales de los informes

Para que la actividad de usuario se muestre en informes estándar, como "En tiempo real", se debe proporcionar engagement_time_msec y session_id como parte de los params de un event.

Ejemplo:

{
"client_id": "x",
"events": [
  {
    "name": "offline_purchase",
    "params": {
      "engagement_time_msec": "100",
      "session_id": "123"
    }
  }
]
}

Aunque session_start es un nombre de evento reservado, al crear un session_id, se creará otra sesión sin necesidad de enviar session_start.

Enviar un evento

Para enviar un evento tutorial_begin, haz la siguiente solicitud:

Limitaciones

  • Las solicitudes pueden tener un máximo de 25 eventos.
  • Los eventos pueden tener un máximo de 25 parámetros.
  • Los eventos pueden tener un máximo de 25 propiedades de usuario.
  • Los nombres de las propiedades de usuario deben tener 24 caracteres como máximo.
  • Los valores de las propiedades de usuario deben tener 36 caracteres como máximo.
  • Los nombres de los eventos deben tener 40 caracteres como máximo (solo pueden contener caracteres alfanuméricos y guiones bajos) y deben empezar por un carácter alfabético.
  • Los nombres de los parámetros, incluidos los parámetros de artículo, deben tener 40 caracteres como máximo (solo pueden contener caracteres alfanuméricos y guiones bajos) y deben empezar por un carácter alfabético.
  • Los valores de los parámetros, incluidos los valores de los parámetros relativos a artículos, deben tener un máximo de 100 caracteres.
  • Cada parámetro de artículo puede tener un máximo de 10 parámetros personalizados.
  • El cuerpo de la publicación debe tener un tamaño inferior a 130 kB.