Se usó la API de Cloud Translation para traducir esta página.

Envía eventos del Protocolo de medición a Google Analytics

En esta guía, se explica cómo puedes enviar campañas de medición de Google Analytics Protocolo web y de flujo de aplicaciones eventos a un servidor de Google Analytics, para que puedas ver los eventos del Protocolo de medición en tus informes de Google Analytics.

Elige la plataforma que deseas ver en esta guía:

Cómo darle formato a la solicitud

El Protocolo de medición para Google Analytics 4 solo admite HTTP POST solicitudes.

Para enviar un evento, usa el siguiente formato:

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

Debes proporcionar lo siguiente en la URL de la solicitud:

api_secret: Es el SECRET de API generado en la IU de Google Analytics.

Para crear un secreto nuevo, navega a Administrador > Flujos de datos > elegir tus novedades > Protocolo de medición > Crear.

firebase_app_id: Es el ID de la app de Firebase, que se encuentra en Firebase console en Configuración del proyecto > General > Tus apps > ID de la app:

El firebase_app_id no es el mismo que el app_instance_id. El firebase_app_id identifica tu app, mientras que app_instance_id identifica una sola instalación de la app.

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

Debes proporcionar la siguiente información en el cuerpo de la solicitud:

app_instance_id: Es un identificador único para una instancia de app de Firebase. Este es diferente de un client_id web:

user_id: Opcional Es un identificador único para un usuario. Solo puede contener utf-8. caracteres. Consulta User-ID para el análisis multiplataforma si deseas obtener más información. sobre este identificador.
consent: Opcional Más información sobre cómo configurar el consentimiento Configuración.
events: Es un array de elementos de evento. Puedes incluir varios eventos en uno para cada solicitud.

Para que la actividad del usuario aparezca en informes como En tiempo real, engagement_time_msec y session_id deben suministrarse como parte del params para una event. El parámetro engagement_time_msec debe reflejar tiempo de participación del evento en milisegundos.

Por ejemplo:

  {
   "app_instance_id": "12345678901234567890123456789012",
   "events": [
     {
        "name": "campaign_details",
        "params": {
          "campaign_id": "google_1234",
          "campaign": "Summer_fun",
          "source": "google",
          "medium": "cpc",
          "term": "summer+travel",
          "content": "logolink",
          "session_id": "123",
          "engagement_time_msec": "100"
        }
     }
   ]
  }

Mientras que session_start es un evento reservado nombre, Si creas un session_id nuevo, se crea una sesión nueva sin necesidad de enviar session_start Conoce las sesiones contadas.

Probar

Este es un ejemplo que puedes usar para enviar un evento tutorial_begin a tu Servidor de Google Analytics:

const firebase_app_id = `1:1234567890:android:321abc456def7890`;
const api_secret = `<secret_value>`;

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

El formato de firebase_app_id es específico de la plataforma. Consulta ID de aplicación. en Objetos y archivos de configuración de Firebase.

Limitaciones

Se aplican las siguientes limitaciones al envío de eventos del Protocolo de medición a Google Análisis:

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 del usuario.
Los nombres de las propiedades del usuario deben tener 24 caracteres o menos.
Los valores de propiedad del usuario deben tener 36 caracteres o menos.
Los nombres de eventos deben tener 40 caracteres o menos y solo pueden contener caracteres alfanuméricos caracteres y guiones bajos, y debe comenzar con un carácter alfabético.
Los nombres de parámetros, incluidos los parámetros de artículos, deben tener 40 caracteres o menos. solo puede contener caracteres alfanuméricos y guiones bajos, y debe comenzar con caracteres alfabéticos.
Los valores de los parámetros, incluidos los valores del parámetro del artículo, deben tener 100 caracteres o menos para una propiedad Google Analytics 4 estándar y 500 caracteres o menos para una propiedad de Google Analytics 360.
Los parámetros de artículos pueden tener un máximo de 10 parámetros personalizados.
El cuerpo de la entrada debe tener un tamaño inferior a 130 KB.
La atribución a nivel del evento de los eventos del Protocolo de medición se admite hasta 63 días después del evento de etiquetado en línea más reciente para la exportación de conversiones a de Google Ads y otras integraciones de medios, incluso si la ventana de conversión de la de conversión es superior a 63 días. En cambio, las métricas a nivel del evento la atribución para etiquetar eventos en línea se admite para toda la conversión en la ventana modal.
Para fines de remarketing, puede unirse a eventos del Protocolo de medición hasta el después del evento en línea más reciente con una ID de dispositivo o cookie asociada:
- Flujo web: 30 días
- Flujo de aplicaciones: 42 días
No se propagan los eventos del Protocolo de medición de aplicaciones enviados a Google Analytics 4 Públicos de búsqueda en Google Ads para usuarios de aplicaciones.