Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Measurement Protocol di Google Analytics ti consente di inviare dati offline al tuo stream web o app, in
aggiunta ai dati che stai già raccogliendo con il tagging o l'SDK Firebase.
Questa guida descrive i casi d'uso comuni di Measurement Protocol di Google Analytics e i relativi requisiti.
Riepilogo dei requisiti
Questa tabella fornisce una rapida panoramica dei requisiti per ciascun caso d'uso. Tieni a mente le seguenti best practice:
Il timestamp_micros di eventi e proprietà utente è impostato per impostazione predefinita sul momento della richiesta. Quando invii una modifica a un evento o una proprietà utente verificatasi in passato, sostituisci il timestamp come descritto nella guida sull'invio di eventi e nella guida relativa alle proprietà utente.
Per report in tempo reale e metriche sul coinvolgimento accurati, includi il
parametro evento engagement_time_msec impostato sui millisecondi trascorsi dall'evento precedente.
Caso d'uso
ID sessione
Requisito del momento della richiesta
Requisito timestamp_micros
Assegnazione di User-ID agli eventi
Obbligatorio
<= fine del giorno lavorativo dell'inizio della sessione
>= inizio della sessione e <= fine della sessione
Attribuzione della sessione
Obbligatorio
<= inizio della sessione + 24 ore
>= inizio della sessione e <= fine della sessione
Esportazione di eventi su piattaforme pubblicitarie
Non obbligatorio
<= ultimo giorno lavorativo della sessione + 63 giorni
>= momento della richiesta meno due giorni lavorativi e <= momento della richiesta
Invio di eventi o proprietà utente per la creazione di segmenti di pubblico
Non obbligatorio
Web: <= ultimo evento online + 30 giorni
App: <= ultimo evento online + 42 giorni
>= momento della richiesta meno due giorni lavorativi e <= momento della richiesta
Assegnazione di User-ID agli eventi
Utilizza Measurement Protocol per fornire agli eventi online o offline un
User-ID.
Ecco alcuni casi d'uso di esempio per l'aggiunta di un User-ID a un evento:
La misurazione online non dispone delle informazioni necessarie per cercare lo User-ID per gli eventi online, ma hai una pipeline di elaborazione degli eventi in grado di stabilire l'associazione tra una sessione online e uno User-ID.
In questo scenario, utilizzi Measurement Protocol per fornire eventi online con uno User-ID.
Non disponi dello User-ID per gli eventi che invii con il
Measurement Protocol, ma vuoi che questi eventi siano associati a un
User-ID se l'utente ha eseguito l'accesso online nel corso della sessione.
In questo scenario, utilizzi gli eventi online per fornire
eventi Measurement Protocol con un ID utente.
Di seguito sono riportati i requisiti per aggiungere un User-ID a un evento:
Includi session_id nell'elenco dei parametri dell'evento.
Invia gli eventi Measurement Protocol nello stesso giorno lavorativo della sessione online.
Se esegui l'override di timestamp_micros, impostalo su un timestamp compreso tra
l'ora di inizio e di fine della sessione online.
Se il tuo obiettivo è fornire User-ID per gli eventi online, imposta user_id nella richiesta.
Se il tuo obiettivo è che ogni evento Measurement Protocol abbia l'ID utente
della sessione online corrispondente, non devi impostare user_id.
Attribuzione della sessione
Gli eventi Measurement Protocol che soddisfano requisiti specifici vengono visualizzati nei report
con gli stessi attributi di sessione (ad esempio informazioni geografiche, sorgente,
mezzo e campagna) degli eventi online della stessa sessione.
Di seguito sono riportati i requisiti per l'attribuzione della sessione:
Includi session_id nell'elenco dei parametri dell'evento.
Invia la richiesta non oltre 24 ore dopo l'inizio della sessione online.
Ad esempio, se la sessione è iniziata alle 11:15 di lunedì nel fuso orario della tua proprietà, invia la richiesta prima delle 11:15 di martedì.
Se esegui l'override di timestamp_micros, impostalo su un timestamp compreso tra
l'ora di inizio e di fine della sessione online.
Esportazione di eventi su piattaforme pubblicitarie
Google Analytics include gli eventi che invii utilizzando Measurement Protocol
nelle esportazioni nei prodotti pubblicitari collegati, come Google Ads o Campaign Manager
360.
Alcuni scenari comuni in cui questa funzionalità è utile includono:
La tua attività ha eventi offline che vuoi includere nell'attribuzione e nei report pubblicitari.
Hai eventi aggiuntivi in un sistema non disponibile per il tagging o
l'SDK Firebase, ma vuoi comunque includerli nei prodotti collegati.
Di seguito sono riportati i requisiti per esportare gli eventi sulle piattaforme pubblicitarie:
Invia la richiesta entro la fine del giorno lavorativo 63 giorni dopo
l'ultimo evento online, anche se la finestra di attribuzione dell'evento chiave è superiore
a 63 giorni.
Ad esempio, se l'ultimo evento online per client_id o
app_instance_id si è verificato il 1° marzo, invia l'evento Measurement Protocol
entro la fine della giornata lavorativa del 3 maggio.
Se esegui l'override di timestamp_micros, impostalo su un timestamp risalente agli ultimi
tre giorni lavorativi.
Invio di eventi o proprietà utente per la creazione di segmenti di pubblico
Gli eventi e le proprietà utente inviati utilizzando Measurement Protocol vengono inclusi nella
valutazione delle condizioni del segmento di pubblico se rispetti alcuni requisiti.
Di seguito sono riportati i requisiti per l'invio di eventi o proprietà utente per la creazione di segmenti di pubblico:
Invia la richiesta a uno stream web entro la fine della giornata lavorativa
30 giorni dopo l'ultimo evento online per lo stesso client_id.
Ad esempio, se l'ultimo evento online per client_id si è verificato il
1° marzo, invia l'evento Measurement Protocol entro la fine della
giornata lavorativa del 31 marzo.
Invia la richiesta a uno stream di app entro la fine della giornata lavorativa
42 giorni dopo l'ultimo evento online per lo stesso app_instance_id.
Ad esempio, se l'ultimo evento online per app_instance_id si è verificato
il 1° marzo, invia l'evento Measurement Protocol entro la fine
della giornata lavorativa del 12 aprile.
Se esegui l'override di timestamp_micros, impostalo su un timestamp compreso negli ultimi 3
giorni lavorativi.
[null,null,["Ultimo aggiornamento 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."]]
