Casi d'uso di Measurement Protocol

Google Analytics Measurement Protocol 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 Google Analytics Measurement Protocol 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.

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 obbligatoria <= ultimo giorno della sessione + 63 giorni >= momento della richiesta meno 72 ore e <= momento della richiesta
Invio di eventi o proprietà utente per la creazione di segmenti di pubblico Non obbligatoria Web: <= ultimo evento online + 30 giorni
App: <= ultimo evento online + 42 giorni		 >= momento della richiesta meno 72 ore 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 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.

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

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

Ecco i requisiti per esportare gli eventi su 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.

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