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:
El valor predeterminado de
timestamp_microsde 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.Para obtener informes en tiempo real y métricas de participación precisos, incluye el parámetro de evento
engagement_time_msecestablecido 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:
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.
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_iden 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_iden 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_iden 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_ido elapp_instance_idocurrió 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_idocurrió 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_idocurrió 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.