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_micros
de 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 ocurrió 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_msec
establecido en los milisegundos transcurridos desde el evento anterior.
Caso de uso | ID de sesión | Requisito de tiempo de solicitud | Requisito de timestamp_micros |
---|---|---|---|
Asigna User-ID a los eventos | Obligatorio | <= Fin del día hábil del 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 |
Cómo exportar eventos a plataformas publicitarias | No obligatorio | <= último día hábil de la sesión + 63 días | >= fecha de solicitud menos dos días hábiles y <= fecha de solicitud |
Envía eventos o propiedades del usuario para la creación de públicos | No obligatorio | Web: <= hora del último evento en línea + 30 días App: <= hora del último evento en línea + 42 días | >= fecha de solicitud menos dos días hábiles y <= fecha de solicitud |
Asigna User-ID a los eventos
Utiliza el Protocolo de medición para proporcionar eventos en línea o sin conexión con un User-ID.
Estos son algunos ejemplos de casos de uso para agregar un User-ID a un evento:
Tu medición en línea carece de la información necesaria para buscar el ID del usuario de los eventos en línea, pero tienes una canalización de procesamiento de eventos que puede establecer la asociación entre una sesión en línea y un ID del usuario.
En esta situación, usas el Protocolo de medición para proporcionar eventos en línea con un User-ID.
No tienes el User-ID para los eventos que envías con el Protocolo de medición, pero deseas que esos eventos se asocien con un User-ID si el usuario accedió en línea durante la sesión.
En esta situación, 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 User-ID a un evento:
- Incluye el
session_id
en la lista de parámetros del evento. - Envía los eventos del Protocolo de medición 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 la hora de finalización de la sesión en línea. - Si tu objetivo es proporcionar el ID de usuario para eventos en línea, configura el
user_id
en la solicitud. - Si tu objetivo es que cada evento del Protocolo de medición tenga el User-ID 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_id
en la lista de parámetros del evento. Envía la solicitud en un plazo máximo de 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
, configúralo en una marca de tiempo entre la hora de inicio y la hora de finalización de la sesión en línea.
Cómo exportar 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 comunes en los que esto es útil:
- Tu empresa tiene eventos sin conexión que deseas incluir en la atribución y los informes publicitarios.
- Tienes eventos adicionales en un sistema que no está disponible para el etiquetado ni el SDK de Firebase, pero aún quieres incluir esos eventos en los productos vinculados.
Estos son los requisitos para exportar eventos a las plataformas publicitarias:
Envía la solicitud a más tardar al final del día hábil 63 días después del último evento en línea, incluso si la ventana de atribución del evento clave es de más de 63 días.
Por ejemplo, si el evento en línea más reciente de
client_id
oapp_instance_id
ocurrió el 1 de marzo, envía el evento del Protocolo de medición a más tardar al final del día hábil del 3 de mayo.Si anulas
timestamp_micros
, configúralo en una marca de tiempo dentro de los últimos tres días hábiles.
Envía eventos o propiedades del usuario para crear públicos
Los eventos y las propiedades del usuario que se envían con el Protocolo de medición 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 al final del día hábil, 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 de
client_id
ocurrió el 1 de marzo, envía el evento del Protocolo de medición a más tardar al final del día hábil del 31 de marzo.Envía la solicitud a un flujo de aplicaciones a más tardar al final del día hábil, 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 de
app_instance_id
ocurrió el 1 de marzo, envía el evento del Protocolo de medición a más tardar al final del día hábil del 12 de abril.Si anulas
timestamp_micros
, configúralo en una marca de tiempo de los últimos 3 días hábiles.