Ispeziona i dati di personalizzazione con BigQuery

La personalizzazione di Remote Config registra un personalization_assignment Analytics evento quando viene assegnata una personalizzazione a un utente, consentendoti di da utilizzare BigQuery per ispezionare e analizzare gli eventi di personalizzazione e gli eventi associati.

Suggerimento: puoi anche visualizzare gli eventi personalization_assignment nella pagina Firebase Analytics Eventi e un grafico dettagliato dei risultati nella Remote Config pagina dei risultati della personalizzazione.

Le seguenti sezioni descrivono come attivare l'esportazione di BigQuery per Analytics eventi, come vengono archiviati gli eventi di personalizzazione e ne fornisci alcuni query di base per iniziare.

Attivare l'esportazione di BigQuery per Google Analytics per Firebase

Se hai sottoscritto il piano Spark, puoi utilizzare la sandbox BigQuery per accedere a BigQuery senza costi, rispettando i limiti della sandbox. Per ulteriori informazioni, consulta Prezzi e sandbox di BigQuery.

Innanzitutto, assicurati di esportare i dati di Analytics in BigQuery:

1. Apri la scheda Integrazioni, a cui puoi accedere utilizzando > Impostazioni progetto nella console Firebase.
2. Se utilizzi già BigQuery con altri servizi Firebase, fai clic su Gestisci. In caso contrario, fai clic su Collega.
3. Consulta Informazioni sul collegamento di Firebase a BigQuery e fai clic su Avanti.
4. Nella sezione Configura integrazione, attiva il pulsante di attivazione/disattivazione Google Analytics.

5. Seleziona una regione e scegli le impostazioni di esportazione.

   Nota: per ulteriori informazioni su Google Analytics per le impostazioni Firebase, consulta la sezione Raccolta dei dati.

6. Fai clic su Collega a BigQuery.

A seconda di come hai scelto di esportare i dati, l'aggiornamento delle tabelle può richiedere fino a un giorno. Per ulteriori informazioni sull'esportazione dei dati del progetto in BigQuery, consulta Esporta i dati del progetto in BigQuery.

Ora accediamo ed esaminiamo i nostri eventi di personalizzazione in BigQuery.

Accedere ai dati di personalizzazione di Remote Config utilizzando BigQuery

Per eseguire una query sui dati di analisi per un esperimento:

1. Apri BigQuery in Console Google Cloud. Puoi anche aprire direttamente da Analytics eventi utilizzando il link visualizza gli eventi non elaborati in BigQuery in basso della pagina.

2. Seleziona il progetto Firebase ed espandilo, quindi espandi il analytics_ANALYTICS_PROPERTY_ID e fai clic su events_.

   

3. Nel menu a discesa Query, seleziona In una nuova scheda.

   Viene visualizzata una query di esempio generata automaticamente.

4. Per visualizzare gli eventi di personalizzazione e i dati associati, aggiorna la query in modo da selezionare gli eventi personalization_assignment. La seguente query di esempio restituisce un evento di assegnazione di personalizzazione completo per una data specifica shard e i risultati sono limitati a 10:

   # Select all personalization_assignment events
   SELECT *
   FROM `PROJECT_NAME.analytics_ANALYTICS_PROPERTY_ID.events_DATE_SHARD`
   WHERE event_name = 'personalization_assignment'
   LIMIT 10
   

   Suggerimento:per cercare in tutte le tabelle degli eventi anziché nella tabella con sharding, puoi sostituisci la data della tabella degli eventi con un asterisco (ad esempio, PROJECT_NAME.analytics_ANALYTICS_PROPERTY_ID.events_*). Questa opzione è sconsigliata in scenari non di test o per set di dati di grandi dimensioni.

5. In Query Composer, seleziona Esegui query. I risultati vengono visualizzati nel riquadro inferiore.

Nota: se non stai eseguendo lo streaming dei dati Analytics, i dati Firebase in BigQuery vengono aggiornati solo una volta al giorno. Pertanto, i dati disponibili in la pagina dell'esperimento potrebbe essere più aggiornata rispetto ai dati disponibili nella Console BigQuery.

Nella sezione successiva, illustreremo più in dettaglio che cosa è incluso in un evento di assegnazione della personalizzazione.

Quali dati di personalizzazione vengono esportati in BigQuery?

I dati di personalizzazione sono inclusi nelle tabelle Google Analytics in BigQuery e archiviati negli eventi personalization_assignment.

I campi di base forniti in un evento di personalizzazione sono gli stessi di Analytics evento come descritto in [GA4] BigQuery Schema di esportazione. Dovrai concentrarti principalmente su user_pseudo_id i(che può essere utilizzato per distinguere utenti distinti), timestamp degli eventi e altre proprietà utente.

I dettagli specifici della personalizzazione vengono memorizzati nel campo event_params e sono descritti nella seguente tabella:

Parametro	Tipo di dati	Descrizione
personalization_id	STRING	Fornisce l'identificatore univoco universale della personalizzazione assegnata (UUID)
gruppo	STRING	Indica se l'utente è stato assegnato al gruppo di personalizzazione (P13N) o al gruppo di riferimento (BASELINE).
arm_index	NUMERO INTERO	Rappresenta il valore alternativo assegnato all'utente, un numero intero tra 0 e 4.
chiave_di_gruppo	STRING	Contiene il nome del parametro utilizzato dalla personalizzazione.
valore_braccio	STRING	Contiene la stringa di valori alternativi assegnata dalla personalizzazione.
engaged_session_event	NUMERO INTERO	Include il numero di sessioni in cui l'utente è coinvolto. Consulta: Informazioni sessioni per ulteriori informazioni.
firebase_event_origin	STRING	Indica l'origine dell'evento. Il valore sarà sempre fp per personalization_assignment eventi.
firebase_screen_class	STRING	Fornisce il nome della classe della schermata in cui l'utente era attivo al momento dell'assegnazione della personalizzazione. Per saperne di più, consulta Eventi raccolti automaticamente.
id_schermo_firebase	NUMERO INTERO	Mostra l'ID della schermata in cui si trovava l'utente al momento dell'assegnazione della personalizzazione. Per saperne di più, consulta Eventi raccolti automaticamente.
first_open_time	STRING	Fornisce il timestamp, in millisecondi UTC, della prima volta che l'utente ha aperto l'app. Consulta: Automaticamente raccolti per ulteriori informazioni.
ga_session_id	NUMERO INTERO	Fornisce l'ID sessione Google Analytics. Per ulteriori informazioni, consulta Informazioni sulle sessioni. Puoi utilizzarlo per correlare l'evento personalization_assignment con altri eventi Analytics.
ga_session_number	NUMERO INTERO	Fornisce il numero di sessione Google Analytics. Consulta: Informazioni sessioni per ulteriori informazioni.

Esempi di query

È possibile utilizzare un'istruzione SQL come la seguente per estrarre parametri specifici della personalizzazione da personalization_assignment eventi:

    # Expand nested personalization parameters
    SELECT
     timestamp_micros(event_timestamp) AS event_time,
     user_pseudo_id,
     (
       SELECT event_params.value.string_value
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'group'
     ) AS personalization_group,
     (
       SELECT event_params.value.string_value
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'personalization_id'
     ) AS personalization_id,
     (
       SELECT event_params.value.string_value,
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'arm_key'
     ) AS arm_key,
     (
       SELECT event_params.value.string_value
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'arm_value'
     ) AS arm_value,
     (
       SELECT event_params.value.int_value
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'ga_session_id'
     ) AS ga_session_id,
    FROM `PROJECT_NAME.analytics_ANALYTICS_ACCOUNT_ID.events_DATE_SHARD`
    WHERE event_name = 'personalization_assignment'
    LIMIT 10