Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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 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.
Para obtener informes en tiempo real y métricas de participación precisos, incluye el parámetro de evento engagement_time_msec configurado 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
<= final del día hábil del inicio de la sesión
>= inicio de la sesión y <= final de la sesión
Atribución de sesiones
Obligatorio
<= inicio de la sesión + 24 horas
>= inicio de la sesión y <= final de la sesión
Exporta eventos a plataformas publicitarias
No obligatorio
<= día hábil de la última sesión + 63 días
Mayor o igual que la hora de la solicitud menos dos días hábiles y menor o igual que la 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
Mayor o igual que la hora de la solicitud menos dos días hábiles y menor o igual que la hora de la 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 no tiene 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 este caso, utilizas 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 Measurement, pero quieres que esos eventos se asocien con un User-ID 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 User-ID.
Estos son los requisitos para agregar un User-ID a un evento:
Incluye 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 como 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 los eventos en línea, configura user_id en la solicitud.
Si tu objetivo es que cada evento del Protocolo de Measurement tenga el User-ID de su sesión en línea correspondiente, no es necesario que establezcas 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 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, configúralo como 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 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 resulta ú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 o 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 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.
Por ejemplo, si el evento en línea más reciente para client_id o 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 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 la creación de 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 para 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 una secuencia de la app 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 para 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 dentro de los últimos 3 días hábiles.
[null,null,["Última actualización: 2025-07-29 (UTC)"],[[["\u003cp\u003eThe Google Analytics Measurement Protocol allows you to send offline data, supplementing your existing online data collection.\u003c/p\u003e\n"],["\u003cp\u003eThis protocol enables you to assign User IDs to events, attribute sessions, export events for advertising, and leverage data for audience creation within Google Analytics.\u003c/p\u003e\n"],["\u003cp\u003eSpecific requirements, including session IDs and timestamps, must be met for each use case to ensure data accuracy and integration with online data.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the provided tables and guidelines for detailed requirements and best practices for each use case, such as session attribution and audience creation.\u003c/p\u003e\n"],["\u003cp\u003eAdhering to these guidelines ensures accurate reporting, attribution, and audience creation based on both online and offline data within your Google Analytics property.\u003c/p\u003e\n"]]],["The Google Analytics Measurement Protocol allows sending offline data to web or app streams. Key actions include: assigning User-IDs to events (requiring a `session_id`, same-day processing, and specific `timestamp_micros`), attributing sessions (requiring `session_id` and submission within 24 hours of session start), exporting events to advertising platforms (no `session_id` required, must be sent within 63 days of the last online event), and using data for audience creation (no `session_id`, web data must be sent within 30 days and app data within 42 days of the last event).\n"],null,["# Measurement protocol use cases\n\nThe Google Analytics Measurement Protocol lets you send offline data to your Web or App stream, in\naddition to the data you're already collecting with tagging or the Firebase SDK.\n\nThis guide describes common Google Analytics Measurement Protocol use cases and their requirements.\n| **Key Term:** In this guide, \"business day\" is the business day of an event or session in the [time zone of your property](//support.google.com/adsense/answer/9830725).\n\nSummary of requirements\n-----------------------\n\nThis table provides a quick reference of the requirements for each use\ncase. Keep the following best practices in mind:\n\n1. The `timestamp_micros` of events and user properties defaults to the request\n time. When sending an event or user property change that occurred in the\n past, override the timestamp as described in the [sending events](/analytics/devguides/collection/protocol/ga4/sending-events) guide and\n the [user properties](/analytics/devguides/collection/protocol/ga4/user-properties) guide.\n\n2. For accurate Realtime reports and engagement metrics, include the\n `engagement_time_msec` event parameter set to the milliseconds elapsed since\n the preceding event.\n\n| Use case | Session ID | Request time requirement | `timestamp_micros` requirement |\n|------------------------------------------------------|--------------|-----------------------------------------------------------------------------------------|---------------------------------------------------------------|\n| Assign User-ID to events | Required | \\\u003c= end of the session start's business day | \\\u003e= session start and \\\u003c= session end |\n| Session attribution | Required | \\\u003c= session start + 24 hours | \\\u003e= session start and \\\u003c= session end |\n| Export events to advertising platforms | Not required | \\\u003c= last session business day + 63 days | \\\u003e= request time minus two business days and \\\u003c= request time |\n| Send events or user properties for audience creation | Not required | Web: \\\u003c= latest online event time + 30 days App: \\\u003c= latest online event time + 42 days | \\\u003e= request time minus two business days and \\\u003c= request time |\n\nAssign User-ID to events\n------------------------\n\nUse the Measurement Protocol to provide online or offline events with a\n[User-ID](//support.google.com/analytics/answer/9213390).\n\nHere are some example use cases for adding a User-ID to an event:\n\n1. Your online measurement lacks the information needed to look up the\n User-ID for online events, but you have an event-processing pipeline that\n is able to make the association between an online session and a User-ID.\n\n In this scenario, you are using the Measurement Protocol to provide\n *online* events with a User-ID.\n2. You don't have the User-ID for events you are sending with the\n Measurement Protocol, but you want those events to be associated with a\n User-ID if the user logged in online over the course of the session.\n\n In this scenario, you are using online events to provide\n *Measurement Protocol* events with a User-ID.\n\nHere are the requirements to add a User-ID to an event:\n\n- Include the `session_id` in the event's parameter list.\n- Send the Measurement Protocol events on the *same business day* as the online session.\n- If you override `timestamp_micros`, set it to a timestamp between the start and end time of the online session.\n- If your goal is to provide User-ID for online events, set the `user_id` in the request.\n- If your goal is for each Measurement Protocol event to have the User-ID from its corresponding online session, you don't need to set `user_id`.\n\nSession attribution\n-------------------\n\nMeasurement Protocol events that meet specific requirements appear in reports\nwith the same session attributes (such as geographic information, source,\nmedium, and campaign) as online events from the same session.\n\nHere are the requirements for session attribution:\n\n- Include the `session_id` in the event's parameter list.\n- Send the request no later than 24 hours after the start of the online\n session.\n\n For example, if the session started at 11:15 AM on Monday in your property's\n time zone, send the request before 11:15 AM on Tuesday.\n- If you override `timestamp_micros`, set it to a timestamp between the\n start and end time of the online session.\n\nExport events to advertising platforms\n--------------------------------------\n\nGoogle Analytics includes the events you send using Measurement Protocol\nin exports to linked advertising products such as Google Ads or Campaign Manager\n360.\n| **Tip:** This use case doesn't require `session_id`.\n\nA few common scenarios where this is useful include:\n\n- Your business has offline events that you want included in advertising attribution and reporting.\n- You have additional events in a system that is not available to tagging or the Firebase SDK, but you still want to include those events in linked products.\n\nHere are the requirements to export events to advertising platforms:\n\n- Send the request no later than the end of the business day 63 days after\n the latest online event, even if the key event's attribution window is more\n than 63 days.\n\n For example, if the latest online event for the `client_id` or\n `app_instance_id` occurred on March 1, send the Measurement Protocol\n event no later than the end of the business day on May 3.\n- If you override `timestamp_micros`, set it to a timestamp within the last\n three business days.\n\nSend events or user properties for audience creation\n----------------------------------------------------\n\nEvents and user properties sent using Measurement Protocol are included in\nthe evaluation of [audience conditions](//support.google.com/analytics/answer/9267572) if you adhere to a few requirements.\n| **Tip:** This use case doesn't require `session_id`.\n\nHere are the requirements to send events or user properties for audience\ncreation:\n\n- Send the request to a Web stream no later than the end of the business day\n 30 days after the latest online event for the same `client_id`.\n\n For example, if the latest online event for the `client_id` occurred on\n March 1, send the Measurement Protocol event no later than the end of the\n business day on March 31.\n- Send the request to an App stream no later than the end of the business day\n 42 days after the latest online event for the same `app_instance_id`.\n\n For example, if the latest online event for the `app_instance_id` occurred\n on March 1, send the Measurement Protocol event no later than the end of\n the business day on April 12.\n- If you override `timestamp_micros`, set it to a timestamp within the last 3\n business days."]]
