El Protocolo de medición de Google Analytics te permite enviar datos sin conexión a tu flujo web o de aplicación, 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
timestamp_microsde los eventos y las propiedades del usuario se establece de forma predeterminada en la hora de la solicitud. Cuando envíes un evento o un cambio de propiedad del usuario que haya ocurrido en el pasado, anula la marca de tiempo como se describe en la guía para enviar eventos y en 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 tiempo de la solicitud | Requisito de timestamp_micros |
|---|---|---|---|
| Asigna el User-ID a los eventos | Obligatorio | <= final del día hábil de inicio de la sesión | >= inicio de la sesión y <= finalización de la sesión |
| Atribución de sesiones | Obligatorio | <= inicio de la sesión + 24 horas | >= inicio de la sesión y <= finalización de la sesión |
| Exporta eventos a plataformas publicitarias | No es obligatorio | <= día de la última 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 crear públicos | No es 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 el User-ID a los eventos
Usa el Protocolo de medición para proporcionar eventos en línea o sin conexión con un ID de usuario.
Estos son algunos ejemplos de casos de uso para agregar un ID de usuario a un evento:
Tu medición en línea carece de la información necesaria para buscar el ID de usuario de los eventos en línea, pero tienes una canalización de procesamiento de eventos que puede asociar una sesión en línea con un ID de usuario.
En este caso, usas el Protocolo de medición para proporcionar eventos en línea con un ID de usuario.
No tienes el ID de usuario para 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 de Measurement Protocol 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 de Measurement Protocol el mismo día hábil que la sesión en línea.
- Si anulas
timestamp_micros, configúralo en una marca de tiempo entre la hora de inicio y de finalización de la sesión en línea. - Si tu objetivo es proporcionar el ID de usuario para los eventos en línea, establece el
user_iden la solicitud. - Si tu objetivo es que cada evento del Protocolo de medición tenga el ID de usuario
de su sesión en línea correspondiente, no es necesario que configures
user_id.
Atribución de sesiones
Los eventos del Protocolo de medición que cumplen con requisitos específicos aparecen en los informes con los mismos atributos de sesión (como la información geográfica, la fuente, el medio y la campaña) que los eventos en línea de la misma sesión.
Estos son los requisitos para la atribución de sesiones:
- 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ó el lunes a las 11:15 a.m. en la zona horaria de tu propiedad, envía la solicitud antes del martes a las 11:15 a.m.
Si anulas
timestamp_micros, configúralo en una marca de tiempo entre la hora de inicio y de finalización de la sesión en línea.
Exporta eventos a plataformas publicitarias
Google Analytics incluye los eventos que envías con el Protocolo de medición en las exportaciones a productos publicitarios vinculados, como Google Ads o Campaign Manager 360.
Estos son algunos casos de uso comunes en los que esto es útil:
- Tu empresa tiene eventos sin conexión que deseas incluir en la atribución y los informes de publicidad.
- Tienes eventos adicionales en un sistema que no está disponible para el etiquetado o el SDK de Firebase, pero quieres incluirlos 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 establecer la 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 Protocolo de medición a más tardar el 3 de mayo.Si anulas
timestamp_micros, establécelo en una marca de tiempo de las últimas 72 horas.
Envía eventos o propiedades del usuario para crear públicos
Los eventos y las propiedades del usuario que se envían con 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 Protocolo de medición a más tardar el 31 de marzo.Envía la solicitud a un flujo de aplicación 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 de Measurement Protocol a más tardar el 12 de abril.Si anulas
timestamp_micros, establécelo en una marca de tiempo de las últimas 72 horas.