Ispeziona i dati di personalizzazione con BigQuery

La personalizzazione Remote Config registra un evento personalization_assignment Analytics quando una personalizzazione viene assegnata a un utente, consentendoti di utilizzare BigQuery per ispezionare e analizzare gli eventi di personalizzazione e quelli 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 sezioni seguenti descrivono come attivare l'esportazione per gli eventi BigQuery, come vengono archiviati gli eventi di personalizzazione e forniscono alcune query di base per iniziare.Analytics

Abilita l'esportazione di BigQuery per Google Analytics per Firebase

Se utilizzi 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. Leggi l'articolo Informazioni sul collegamento di Firebase a BigQuery e poi 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 impostazioniFirebase, 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 gli eventi di personalizzazione in BigQuery.

Accedere ai dati di personalizzazione di Remote Config utilizzando BigQuery

Per eseguire query sui dati di analisi per un esperimento:

1. Apri BigQuery nella console Google Cloud. Puoi anche aprirlo direttamente da Analytics Eventi utilizzando il link Visualizza gli eventi non elaborati in BigQuery in fondo alla pagina.

2. Seleziona il progetto Firebase ed espandilo, poi espandi la voce 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 restituirà un evento di assegnazione della personalizzazione completo per uno specifico frammento di data, limitando i risultati 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 suddivisa in parti, puoi sostituire la data della tabella degli eventi con un asterisco (ad es. PROJECT_NAME.analytics_ANALYTICS_PROPERTY_ID.events_*). Questa operazione non è consigliata in scenari diversi dai test o per set di dati di grandi dimensioni.

5. Nel compositore di query, 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 nella pagina dell'esperimento potrebbero essere più aggiornati rispetto a quelli 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 qualsiasi eventoAnalytics, come descritto in [GA4] Schema di esportazione BigQuery. 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 (UUID) della personalizzazione assegnata.
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.
arm_key	STRING	Contiene il nome del parametro utilizzato dalla personalizzazione.
valore_braccio	STRING	Contiene la stringa del valore alternativo assegnato dalla personalizzazione.
engaged_session_event	NUMERO INTERO	Include il numero di sessioni in cui l'utente è coinvolto. Per ulteriori informazioni, consulta Informazioni sulle sessioni.
firebase_event_origin	STRING	Indica l'origine dell'evento. Sarà sempre fp per gli eventi personalization_assignment.
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.
firebase_screen_id	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 apertura dell'app da parte dell'utente. Per ulteriori informazioni, consulta Eventi raccolti automaticamente.
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. Per ulteriori informazioni, consulta Informazioni sulle sessioni.

Esempi di query

Puoi utilizzare un'istruzione SQL come la seguente per estrarre i parametri specifici per la personalizzazione dagli eventi personalization_assignment:

    # 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