Ispeziona i dati di personalizzazione con BigQuery

La personalizzazione di 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 gli eventi associati.

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

Abilita l'esportazione di BigQuery per Google Analytics per Firebase

Se utilizzi il piano Spark, puoi utilizzare la sandbox di BigQuery per accedere a BigQuery senza costi, nel rispetto dei limiti della sandbox. Per saperne di più, consulta Prezzi e sandbox di BigQuery.

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

  1. Nella console Firebase, vai a Impostazioni > Integrazioni.

  2. Nella scheda BigQuery, fai clic su Collega. In alternativa, se utilizzi già BigQuery con altri servizi Firebase, fai clic su Gestisci.

  3. Leggi Informazioni sul collegamento di Firebase a BigQuery, poi fai clic su Avanti.

  4. Nella sezione Configura integrazione, attiva l'opzione Google Analytics.

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

  6. Fai clic su Collega a BigQuery.

A seconda di come hai scelto di esportare i dati, potrebbe essere necessario fino a un giorno prima che le tabelle diventino disponibili. Per saperne di più sull'esportazione dei dati di progetto in BigQuery, consulta Esporta i dati di progetto in BigQuery.

Successivamente, puoi accedere agli eventi di personalizzazione e ispezionarli in BigQuery.

Accedi ai dati di personalizzazione di Remote Config utilizzando BigQuery

Per eseguire query sui dati di analisi di un esperimento:

  1. Apri BigQuery nella console Google Cloud. Puoi anche aprire BigQuery direttamente dalla console Firebase andando alla dashboard Analytics > Eventi e utilizzando il link Visualizza gli eventi non elaborati in BigQuery nella parte inferiore della pagina.

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

    Accedi agli eventi di personalizzazione nella console Cloud

  3. Dal 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 per selezionare gli eventi personalization_assignment. La seguente query di esempio restituirà un evento di assegnazione della personalizzazione completo per uno shard di date specifico, limitando i risultati a 10:

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

    Suggerimento: per eseguire ricerche in tutte le tabelle degli eventi anziché nella tabella con sharding, puoi sostituire la data della tabella degli eventi con un asterisco (ad esempio, PROJECT_ID.analytics_ANALYTICS_PROPERTY_ID.events_*). Questa operazione non è consigliata in scenari non di test o per set di dati di grandi dimensioni.

  5. Nel compositore di query, seleziona Esegui query. I risultati vengono visualizzati nel riquadro inferiore.

La sezione successiva descrive in modo più dettagliato 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 evento Analytics, come descritto in Dati di Google Analytics for Firebase esportati in BigQuery. Ti interesseranno principalmente user_pseudo_id (che può essere utilizzato per distinguere utenti diversi), i timestamp degli eventi e altre proprietà utente.

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

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 compreso tra 0 e 4.
arm_key STRING Contiene il nome del parametro utilizzato dalla personalizzazione.
arm_value STRING Contiene la stringa del valore alternativo assegnata dalla personalizzazione.
engaged_session_event NUMERO INTERO Include il numero di sessioni in cui l'utente è coinvolto. Per saperne di più, consulta Informazioni sulle sessioni.
firebase_event_origin STRING Indica l'origine dell'evento. Questo valore sarà sempre fp per gli eventi personalization_assignment.
firebase_screen_class STRING Fornisce il nome della classe della schermata su cui l'utente era attivo quando è stata eseguita l'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 quando è stata eseguita l'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 saperne di più, consulta Eventi raccolti automaticamente.
ga_session_id NUMERO INTERO Fornisce l'ID sessione Google Analytics. Per saperne di più, 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 saperne di più, consulta Informazioni sulle sessioni.

Esempi di query

Puoi utilizzare un'istruzione SQL come la seguente per estrarre i parametri specifici della 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_ID.analytics_ANALYTICS_ACCOUNT_ID.events_DATE_SHARD`
    WHERE event_name = 'personalization_assignment'
    LIMIT 10