Casi d'uso di Measurement Protocol

Measurement Protocol di Google Analytics ti consente di inviare dati offline allo stream web o dell'app, oltre 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 valore timestamp_micros degli eventi e delle 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.

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 eventi online o offline con 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 associare una sessione online a uno User-ID.

    In questo scenario, utilizzi Measurement Protocol per fornire agli eventi online un User-ID.

  2. Non disponi dell'ID utente per gli eventi che invii con Measurement Protocol, ma vuoi che questi eventi vengano associati a un ID utente se l'utente ha eseguito l'accesso online nel corso della sessione.

    In questo scenario, utilizzi gli eventi online per fornire agli eventi Measurement Protocol 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 sostituisci timestamp_micros, impostalo su un timestamp compreso tra l'ora di inizio e quella di fine della sessione online.
  • Se il tuo obiettivo è fornire l'ID utente 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 è necessario impostare user_id.

Attribuzione della sessione

Gli eventi Measurement Protocol che soddisfano requisiti specifici vengono visualizzati nei report con gli stessi attributi della sessione (ad es. 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 sostituisci timestamp_micros, impostalo su un timestamp compreso tra l'ora di inizio e quella di fine della sessione online.

Esportazione di eventi su piattaforme pubblicitarie

Google Analytics include gli eventi inviati utilizzando Measurement Protocol nelle esportazioni verso i 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 nell'attribuzione pubblicitaria e nei report.
  • Hai eventi aggiuntivi in un sistema non disponibile per il tagging o per l'SDK Firebase, ma vuoi comunque includerli nei prodotti collegati.

Di seguito sono riportati i requisiti per esportare gli eventi nelle piattaforme pubblicitarie:

  • Invia la richiesta entro la fine del giorno lavorativo successivo a 63 giorni dall'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 del giorno lavorativo del 3 maggio.

  • Se sostituisci timestamp_micros, impostalo su un timestamp compreso tra gli 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 sono inclusi nella valutazione delle condizioni dei segmenti di pubblico se soddisfi 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 del giorno lavorativo successivo a 30 giorni dall'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 del giorno lavorativo del 31 marzo.

  • Invia la richiesta a uno stream di app entro la fine del giorno lavorativo 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 del giorno lavorativo del 12 aprile.

  • Se sostituisci timestamp_micros, impostalo su un timestamp compreso negli ultimi 3 giorni lavorativi.