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 i tag 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 presente le seguenti best practice:

1. Il timestamp_micros dei valori predefiniti di eventi e proprietà utente al 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 paramento 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 uno 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 agli eventi online uno User-ID.

2. Non hai lo User-ID per gli eventi che invii con Measurement Protocol, ma vuoi che questi eventi siano associati a uno User-ID se l'utente ha eseguito l'accesso online durante la sessione.

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

Di seguito sono riportati i requisiti per aggiungere uno 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 l'ora di fine della sessione online.
• Se il tuo obiettivo è fornire uno User-ID per gli eventi online, imposta user_id nella richiesta.
• Se vuoi che ogni evento Measurement Protocol abbia lo User-ID 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, origine, 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 entro 24 ore dall'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 l'ora di fine della sessione online.

Esportazione di eventi su piattaforme pubblicitarie

Google Analytics include gli eventi che invii utilizzando Measurement Protocol nelle esportazioni ai 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 e nei report pubblicitari.
• Hai eventi aggiuntivi in un sistema non disponibile per i tag 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 63 giorni dall'ultimo evento online, anche se la finestra di attribuzione dell'evento chiave è superiore a 63 giorni. L'evento deve arrivare anche entro la finestra di attribuzione dell'evento chiave. Scopri come configurare le impostazioni della finestra di attribuzione.

  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 il 3 maggio.

• Se sostituisci timestamp_micros, impostalo su un timestamp compreso nelle ultime 72 ore.

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 in nella valutazione delle condizioni del segmento di pubblico se rispetti alcuni requisiti.

Di seguito sono riportati i requisiti per inviare eventi o proprietà utente per la creazione di segmenti di pubblico:

• Invia la richiesta a uno stream web entro 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 il 31 marzo.

• Invia la richiesta a uno stream dell'app entro 42 giorni dall'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 il 12 aprile.

• Se sostituisci timestamp_micros, impostalo su un timestamp compreso nelle ultime 72 ore.