Casos de uso del Protocolo de medición

El Measurement Protocol de Google Analytics te permite enviar datos sin conexión a tu flujo web o de apps, además de los datos que ya recopilas con el etiquetado o el SDK de Firebase.

En esta guía, se describen los casos de uso comunes del Protocolo de medición de Google Analytics y sus requisitos.

Resumen de los requisitos

En esta tabla, se proporciona una referencia rápida de los requisitos para cada caso de uso. Ten en cuenta las siguientes prácticas recomendadas:

  1. El valor predeterminado de timestamp_micros de los eventos y las propiedades del usuario es la hora de la solicitud. Cuando envíes un evento o un cambio en la propiedad del usuario que ocurrió en el pasado, anula la marca de tiempo como se describe en la guía para enviar eventos y la guía de propiedades del usuario.

  2. Para obtener informes en tiempo real y métricas de participación precisos, incluye el parámetro de evento engagement_time_msec establecido en los milisegundos transcurridos desde el evento anterior.

Caso de uso ID de sesión Requisito de hora de la solicitud Requisito de timestamp_micros
Asigna un ID de usuario a los eventos Obligatorio <= fin del día hábil de inicio de la sesión >= inicio de la sesión y <= fin de la sesión
Atribución de la sesión Obligatorio <= inicio de la sesión + 24 horas >= inicio de la sesión y <= fin de la sesión
Exporta eventos a plataformas publicitarias No obligatorio <= último día de la sesión + 63 días >= hora de la solicitud menos 72 horas y <= hora de la solicitud
Envía eventos o propiedades del usuario para la creación de públicos No obligatorio Web: <= hora del evento en línea más reciente + 30 días
App: <= hora del evento en línea más reciente + 42 días
>= hora de la solicitud menos 72 horas y <= hora de la solicitud

Asigna un ID de usuario a los eventos

Usa el Measurement Protocol para proporcionar eventos en línea o eventos sin conexión con un User-ID.

Estos son algunos ejemplos de casos de uso para agregar un ID de usuario a un evento:

  1. Tu medición en línea no tiene la información necesaria para buscar el ID de usuario de los eventos en línea, pero tienes un canal de procesamiento de eventos que puede establecer la asociación entre una sesión en línea y un ID de usuario.

    En este caso, usas el Measurement Protocol para proporcionar eventos en línea con un User-ID.

  2. No tienes el ID de usuario de los eventos que envías con el Protocolo de medición, pero quieres que esos eventos se asocien con un ID de usuario si el usuario accedió a su cuenta en línea durante la sesión.

    En este caso, usas eventos en línea para proporcionar eventos del Protocolo de medición con un ID de usuario.

Estos son los requisitos para agregar un ID de usuario a un evento:

  • Incluye el session_id en la lista de parámetros del evento.
  • Envía los eventos del Measurement Protocol en el mismo día hábil que la sesión en línea.
  • Si anulas timestamp_micros, establécelo en una marca de tiempo entre la hora de inicio y la hora de finalización de la sesión en línea.
  • Si tu objetivo es proporcionar un ID de usuario para los eventos en línea, establece el user_id en la solicitud.
  • Si tu objetivo es que cada evento del Measurement Protocol tenga el User-ID de su sesión en línea correspondiente, no necesitas establecer user_id.

Atribución de la sesión

Los eventos de Measurement Protocol que cumplen con requisitos específicos aparecen en los informes con los mismos atributos de sesión (como información geográfica, fuente, medio y campaña) que los eventos en línea de la misma sesión.

Estos son los requisitos para la atribución de la sesión:

  • Incluye el session_id en la lista de parámetros del evento.
  • Envía la solicitud a más tardar 24 horas después del inicio de la sesión en línea.

    Por ejemplo, si la sesión comenzó a las 11:15 a.m. del lunes en la zona horaria de tu propiedad, envía la solicitud antes de las 11:15 a.m. del martes.

  • Si anulas timestamp_micros, establécelo en una marca de tiempo entre la hora de inicio y la hora de finalización de la sesión en línea.

Exporta eventos a plataformas publicitarias

Google Analytics incluye los eventos que envías con Measurement Protocol en las exportaciones a productos publicitarios vinculados, como Google Ads o Campaign Manager 360.

Algunas situaciones comunes en las que esto es útil incluyen las siguientes:

  • Tu empresa tiene eventos sin conexión que quieres incluir en la atribución y los informes publicitarios.
  • Tienes eventos adicionales en un sistema que no está disponible para el etiquetado o el SDK de Firebase, pero quieres incluir esos eventos en los productos vinculados.

Estos son los requisitos para exportar eventos a plataformas publicitarias:

  • Envía la solicitud a más tardar 63 días después del evento en línea más reciente, incluso si la ventana de atribución del evento clave es de más de 63 días. El evento también debe llegar dentro de la ventana de atribución del evento clave. Consulta cómo configurar los parámetros de configuración de la ventana de atribución.

    Por ejemplo, si el evento en línea más reciente para el client_id o el app_instance_id ocurrió el 1 de marzo, envía el evento del Measurement Protocol a más tardar el 3 de mayo.

  • Si anulas timestamp_micros, establécelo en una marca de tiempo dentro de las últimas 72 horas.

Envía eventos o propiedades del usuario para la creación de públicos

Los eventos y las propiedades del usuario que se envían con el Measurement Protocol se incluyen en la evaluación de las condiciones del público si cumples con algunos requisitos.

Estos son los requisitos para enviar eventos o propiedades del usuario para la creación de públicos:

  • Envía la solicitud a un flujo web a más tardar 30 días después del evento en línea más reciente para el mismo client_id.

    Por ejemplo, si el evento en línea más reciente para el client_id ocurrió el 1 de marzo, envía el evento del Measurement Protocol a más tardar el 31 de marzo.

  • Envía la solicitud a un flujo de apps a más tardar 42 días después del evento en línea más reciente para el mismo app_instance_id.

    Por ejemplo, si el evento en línea más reciente para el app_instance_id ocurrió el 1 de marzo, envía el evento del Measurement Protocol a más tardar el 12 de abril.

  • Si anulas timestamp_micros, establécelo en una marca de tiempo dentro de las últimas 72 horas.