Casi d'uso di Measurement Protocol

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:

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

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

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

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