Measurement Protocol di Google Analytics ti consente di inviare dati offline al tuo stream web o di app in oltre ai dati che stai già raccogliendo con il tagging o con 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 un riferimento rapido dei requisiti per ciascun utilizzo per verificare se è così. Tieni presenti le seguenti best practice:
Il valore
timestamp_micros
degli eventi e delle proprietà utente viene impostato in modo predefinito sulla richiesta nel tempo. Quando invii un evento o una modifica della proprietà utente che si è verificata nella passato, sostituisci il timestamp come descritto nella guida agli eventi di invio e consulta la guida alle proprietà utente.Per report In tempo reale e metriche sul coinvolgimento accurati, includi il Parametro evento
engagement_time_msec
impostato sui millisecondi trascorsi dal l'evento precedente.
Caso d'uso | ID sessione | Requisito di tempo per la richiesta | Requisito timestamp_micros |
---|---|---|---|
Assegnare uno User-ID agli eventi | Obbligatorio | <= fine della giornata lavorativa di inizio della sessione | >= inizio sessione e <= fine sessione |
Attribuzione della sessione | Obbligatorio | <= inizio sessione + 24 ore | >= inizio sessione e <= fine sessione |
Esportare gli eventi nelle piattaforme pubblicitarie | Non obbligatorio | <= giorno lavorativo ultima sessione + 63 giorni | Ora della richiesta <= |
Invia eventi o proprietà utente per il pubblico creazione | Non obbligatorio | Web: <= ora dell'ultimo evento online + 30 giorni App: <= ora ultimo evento online + 42 giorni |
Ora della richiesta <= |
Assegnare uno User-ID agli eventi
Utilizza Measurement Protocol per fornire eventi online o offline con un User-ID.
Di seguito sono riportati alcuni casi d'uso di esempio per l'aggiunta di uno User-ID a un evento:
Nella tua misurazione online mancano le informazioni necessarie per cercare User-ID per gli eventi online, ma hai una pipeline di elaborazione degli eventi che è in grado di creare l'associazione tra una sessione online e uno User-ID.
In questo scenario, utilizzi Measurement Protocol per fornire online con uno User-ID.
Non hai lo User-ID per gli eventi che stai inviando con la 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, utilizzerai eventi online per fornire Eventi Measurement Protocol con uno User-ID.
Di seguito sono riportati i requisiti per aggiungere uno User-ID a un evento:
- Includi
session_id
nell'elenco di parametri dell'evento. - Invia gli eventi Measurement Protocol lo stesso giorno lavorativo della sessione online.
- Se esegui l'override di
timestamp_micros
, imposta un timestamp compreso tra le ore di inizio e di fine della sessione online. - Se il tuo obiettivo è fornire uno User-ID per gli eventi online, imposta
user_id
in la richiesta. - Se l'obiettivo è che ogni evento di Measurement Protocol disponga dello User-ID
dalla 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 (come informazioni geografiche, medio e campagna) come eventi online della stessa sessione.
Di seguito sono riportati i requisiti per l'attribuzione delle sessioni:
- Includi
session_id
nell'elenco di parametri dell'evento. Invia la richiesta non oltre 24 ore dopo l'inizio del durante la sessione.
Ad esempio, se la sessione è iniziata alle 11:15 di lunedì nel fuso orario, invia la richiesta prima delle 11:15 di martedì.
Se esegui l'override di
timestamp_micros
, imposta un timestamp compreso tra le ore di inizio e di fine della sessione online.
Esportare gli eventi nelle piattaforme pubblicitarie
Google Analytics include gli eventi che invii utilizzando Measurement Protocol nelle esportazioni verso prodotti pubblicitari collegati, come Google Ads o Campaign Manager 360°.
Ecco alcuni scenari comuni in cui questa funzionalità è utile:
- La tua attività ha eventi offline che vuoi includere nella pubblicità l'attribuzione e la generazione di report.
- Sono presenti altri eventi in un sistema che non è disponibile per il tagging o l'SDK Firebase, ma vuoi comunque includere questi eventi nelle prodotti di big data e machine learning.
Di seguito sono riportati i requisiti per esportare gli eventi nelle piattaforme pubblicitarie:
Invia la richiesta non oltre la fine del giorno lavorativo 63 giorni dopo l'evento online più recente, anche se la finestra di attribuzione dell'evento chiave è più per più di 63 giorni.
Ad esempio, se l'ultimo evento online per
client_id
oapp_instance_id
si è verificato il 1° marzo; invia Measurement Protocol dell'evento non oltre la fine della giornata lavorativa del 3 maggio.Se sostituisci
timestamp_micros
, imposta un timestamp inferiore o uguale a all'ora della richiesta.
Inviare eventi o proprietà utente per la creazione del segmento di pubblico
Gli eventi e le proprietà utente inviati utilizzando Measurement Protocol sono inclusi in la valutazione delle condizioni relative ai segmenti di pubblico se rispetti alcuni requisiti.
Di seguito sono riportati i requisiti per inviare eventi o proprietà utente per il pubblico creazione:
Inviare la richiesta a uno stream web non oltre 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 giorno Il 1° marzo, invia l'evento Measurement Protocol entro la fine del giorno lavorativo del 31 marzo.Invia la richiesta a uno stream di app non oltre la fine della giornata lavorativa 42 giorni dopo l'ultimo evento online per lo stesso
app_instance_id
.Ad esempio, se si è verificato l'ultimo evento online per
app_instance_id
Il 1° marzo, invia l'evento Measurement Protocol entro la fine del il giorno lavorativo del 12 aprile.Se sostituisci
timestamp_micros
, imposta un timestamp inferiore o uguale a all'ora della richiesta.