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.

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

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

    Accedere agli eventi di personalizzazione nella console Cloud

  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.

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 assegnata 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