Ispeziona i dati di personalizzazione con BigQuery

Remote Config la personalizzazione registra un evento personalization_assignment Analytics quando a un utente viene assegnata una personalizzazione, consentendoti di utilizzare BigQuery per esaminare 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.

Attivare l'esportazione BigQuery per Google Analytics per Firebase

Se hai il piano Spark, puoi utilizzare la BigQuery sandbox per accedere BigQuery senza costi, in base ai limiti della sandbox. Per ulteriori informazioni, consulta la pagina Prezzi e la sandbox di BigQuery.

Innanzitutto, assicurati di esportare i dati Analytics in BigQuery:

  1. Nella Firebase console, 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. Esamina la sezione Informazioni sul collegamento di Firebase a BigQuery e fai clic su Avanti.

  4. Nella sezione Configura integrazione, attiva il Google Analytics pulsante.

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

  6. Fai clic su Collega a BigQuery.

A seconda della modalità di esportazione dei dati scelta, potrebbero essere necessari fino a un giorno prima che le tabelle diventino disponibili. Per ulteriori informazioni sull'esportazione dei dati del progetto in BigQuery, consulta Esportare 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 di un esperimento:

  1. Apri BigQuery nella Google Cloud console. 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 progetto Firebase ed espandilo, poi espandi la analytics_ANALYTICS_PROPERTY_ID voce e fai clic su events_.

    Accedere 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 in modo da selezionare gli eventi personalization_assignment. La seguente query di esempio restituirà un evento di assegnazione di personalizzazione completo per uno shard di data specifico, 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 con shard, puoi sostituire la data della tabella degli eventi con un asterisco (ad esempio, PROJECT_NAME.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.

Nella sezione successiva, esamineremo più nel dettaglio i contenuti di un evento di assegnazione di 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 Analytics evento, come descritto in [GA4] BigQuery Schema di esportazione. Ti interesseranno principalmente user_pseudo_id(che può essere utilizzato per distinguere gli utenti distinti), i timestamp degli eventi e altre proprietà utente.

I dettagli specifici della personalizzazione vengono 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.
group STRING Indica se l'utente è stato assegnato al gruppo di personalizzazione (P13N) o al gruppo di base (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 ulteriori informazioni, consulta la sezione Informazioni sulle sessioni.
firebase_event_origin STRING Indica l'origine dell'evento. Per gli eventi personalization_assignment sarà sempre fp.
firebase_screen_class STRING Fornisce il nome della classe della schermata in cui l'utente era attivo quando si è verificata l'assegnazione della personalizzazione. Per ulteriori informazioni, consulta la sezione Eventi raccolti automaticamente.
firebase_screen_id NUMERO INTERO Visualizza l'ID della schermata in cui si trovava l'utente quando si è verificata l'assegnazione della personalizzazione Per ulteriori informazioni, consulta la sezione 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 la sezione Eventi raccolti automaticamente.
ga_session_id NUMERO INTERO Fornisce l'ID sessione Google Analytics. Per ulteriori informazioni, consulta la sezione Informazioni sulle sessioni. Puoi utilizzare questo parametro per correlare l' personalization_assignment evento con altri Analytics eventi.
ga_session_number NUMERO INTERO Fornisce il numero di sessione Google Analytics. Per ulteriori informazioni, consulta la sezione 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_NAME.analytics_ANALYTICS_ACCOUNT_ID.events_DATE_SHARD`
    WHERE event_name = 'personalization_assignment'
    LIMIT 10