Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Measurement Protocol do Google Analytics permite enviar dados off-line para seu fluxo da Web ou de app, além dos dados que você já coleta com inclusão de tags ou o SDK do Firebase.
Este guia descreve casos de uso comuns do Measurement Protocol do Google Analytics e os requisitos deles.
Resumo dos requisitos
Esta tabela oferece uma referência rápida dos requisitos para cada caso de uso. Considere as práticas recomendadas a seguir:
O timestamp_micros de eventos e propriedades do usuário é definido como o horário da solicitação por padrão. Ao enviar um evento ou uma mudança de propriedade do usuário que ocorreu no
passado, substitua o carimbo de data/hora conforme descrito nos guias Envio de eventos e
Propriedades do usuário.
Para ter relatórios de tempo real e métricas de engajamento precisos, inclua o parâmetro de evento engagement_time_msec definido como os milissegundos decorridos desde o evento anterior.
Caso de uso
ID da sessão
Requisito de tempo de solicitação
Requisito do timestamp_micros
Atribuir User-ID a eventos
Obrigatório
<= fim do dia útil do início da sessão
>= início da sessão e <= fim da sessão
Atribuição de sessão
Obrigatório
<= início da sessão + 24 horas
>= início da sessão e <= fim da sessão
Exportar eventos para plataformas de publicidade
Não obrigatório
<= último dia útil da sessão + 63 dias
>= tempo da solicitação menos dois dias úteis e <= tempo da solicitação
Enviar eventos ou propriedades do usuário para a criação de públicos-alvo
Não obrigatório
Web: <= horário do último evento on-line + 30 dias
App: <= horário do último evento on-line + 42 dias
>= tempo da solicitação menos dois dias úteis e <= tempo da solicitação
Atribuir User-ID a eventos
Use o Measurement Protocol para fornecer eventos on-line ou off-line com um User-ID.
Confira alguns exemplos de casos de uso para adicionar um User-ID a um evento:
Sua medição on-line não tem as informações necessárias para pesquisar o User-ID de eventos on-line, mas você tem um pipeline de processamento de eventos que pode fazer a associação entre uma sessão on-line e um User-ID.
Nesse cenário, você usa o Measurement Protocol para fornecer eventos on-line com um User-ID.
Você não tem o User-ID para eventos enviados com o
protocolo de medição, mas quer que eles sejam associados a um
User-ID se o usuário fizer login on-line durante a sessão.
Nesse cenário, você usa eventos on-line para fornecer eventos do Measurement Protocol com um User-ID.
Confira os requisitos para adicionar um User-ID a um evento:
Inclua o session_id na lista de parâmetros do evento.
Envie os eventos do Measurement Protocol no mesmo dia útil da sessão on-line.
Se você substituir timestamp_micros, defina-o como um carimbo de data/hora entre o
horário de início e término da sessão on-line.
Se o objetivo for fornecer um User-ID para eventos on-line, defina o user_id na solicitação.
Se a meta for que cada evento do Measurement Protocol tenha o User-ID da sessão on-line correspondente, não será necessário definir user_id.
Atribuição de sessão
Os eventos do Measurement Protocol que atendem a requisitos específicos aparecem nos relatórios com os mesmos atributos de sessão (como informações geográficas, origem, mídia e campanha) dos eventos on-line da mesma sessão.
Confira os requisitos para a atribuição de sessão:
Inclua o session_id na lista de parâmetros do evento.
Envie a solicitação em até 24 horas após o início da sessão on-line.
Por exemplo, se a sessão começou às 11h15 de segunda-feira no fuso horário da sua propriedade, envie a solicitação antes das 11h15 de terça-feira.
Se você substituir timestamp_micros, defina-o como um carimbo de data/hora entre o
horário de início e término da sessão on-line.
Exportar eventos para plataformas de publicidade
O Google Analytics inclui os eventos enviados usando o Measurement Protocol
em exportações para produtos de publicidade vinculados, como o Google Ads ou o Campaign Manager
360.
Alguns cenários comuns em que isso é útil incluem:
Sua empresa tem eventos off-line que você quer incluir na atribuição e nos relatórios de publicidade.
Você tem outros eventos em um sistema que não está disponível para inclusão de tags ou para o SDK do Firebase, mas ainda quer incluir esses eventos em produtos vinculados.
Confira os requisitos para exportar eventos para plataformas de publicidade:
Envie a solicitação até o final do dia útil 63 dias após o evento on-line mais recente, mesmo que a janela de atribuição do evento principal seja maior que 63 dias.
Por exemplo, se o evento on-line mais recente para o client_id ou
app_instance_id ocorreu em 1º de março, envie o evento do Measurement Protocol
até o final do dia útil de 3 de maio.
Se você substituir timestamp_micros, defina um carimbo de data/hora nos últimos três dias úteis.
Enviar eventos ou propriedades do usuário para criar públicos-alvo
Os eventos e as propriedades do usuário enviados usando o Measurement Protocol são incluídos na avaliação das condições de público-alvo se você seguir alguns requisitos.
Confira os requisitos para enviar eventos ou propriedades do usuário para a criação de público-alvo:
Envie a solicitação para um fluxo da Web até o final do dia útil
30 dias após o evento on-line mais recente para o mesmo client_id.
Por exemplo, se o evento on-line mais recente do client_id ocorreu em
1º de março, envie o evento do Measurement Protocol até o final do
dia útil de 31 de março.
Envie a solicitação para um stream de app até o final do dia útil
42 dias após o último evento on-line para o mesmo app_instance_id.
Por exemplo, se o evento on-line mais recente do app_instance_id ocorreu em 1º de março, envie o evento do Measurement Protocol até o fim do dia útil de 12 de abril.
Se você substituir timestamp_micros, defina um carimbo de data/hora nos últimos três dias úteis.
[null,null,["Última atualização 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."]]
