Casi d'uso di Measurement Protocol

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:

1. 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.

2. Per report in tempo reale e metriche sul coinvolgimento accurati, includi il parametro evento engagement_time_msec impostato sui millisecondi trascorsi dall'evento precedente.

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:

1. 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.

2. 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.