Sprawdzanie danych personalizacji w BigQuery

Remote Config personalizacji rejestruje zdarzenie personalization_assignment Analytics, gdy personalizacja jest przypisywana do użytkownika, co umożliwia sprawdzanie i analizowanie zdarzeń personalizacji oraz powiązanych zdarzeń za pomocą BigQuery.

W kolejnych sekcjach opisujemy, jak włączyć BigQueryeksport zdarzeńAnalytics, jak są przechowywane zdarzenia personalizacji oraz podajemy kilka podstawowych zapytań, które pomogą Ci zacząć.

Włącz eksportowanie BigQuery w przypadku Google Analytics w zakresie Firebase

Jeśli korzystasz z pakietu Spark, możesz używać BigQuerypiaskownicy, aby uzyskać dostęp do BigQuery bezpłatnie, z zastrzeżeniem limitów piaskownicy. Więcej informacji znajdziesz w sekcji Ceny i piaskownica BigQuery.

Najpierw upewnij się, że eksportujesz dane Analytics doBigQuery:

  1. Otwórz kartę Integracje, do której możesz przejść, klikając  > Ustawienia projektuFirebase konsoli.
  2. Jeśli korzystasz już z BigQuery w innych usługach Firebase, kliknij Zarządzaj. W przeciwnym razie kliknij Połącz.
  3. Zapoznaj się z informacjami w sekcji Informacje o łączeniu Firebase z BigQuery, a potem kliknij Dalej.
  4. W sekcji Skonfiguruj integrację włącz przełącznik Google Analytics.
  5. Wybierz region i ustawienia eksportu.

  6. Kliknij Połącz z BigQuery.

W zależności od sposobu eksportowania danych udostępnienie tabel może potrwać do 1 dnia. Więcej informacji o eksportowaniu danych projektu doBigQuery znajdziesz w artykule Eksportowanie danych projektu do BigQuery.

Teraz otwórzmy i sprawdźmy zdarzenia personalizacji w BigQuery.

Dostęp do danych personalizacji Remote Config za pomocą BigQuery

Aby wysłać zapytanie o dane analityczne eksperymentu:

  1. Otwórz BigQuery w Google Cloudkonsoli. Możesz też otworzyć go bezpośrednio z sekcji Analytics Zdarzenia, klikając link wyświetl surowe zdarzenia w BigQuery u dołu strony.
  2. Wybierz i rozwiń projekt Firebase, a następnie rozwiń wpis analytics_ANALYTICS_PROPERTY_ID i kliknij events_.

    Dostęp do zdarzeń personalizacji w konsoli Cloud

  3. W menu Zapytanie wybierz W nowej karcie.

    Pojawi się automatycznie wygenerowane przykładowe zapytanie.

  4. Aby wyświetlić zdarzenia personalizacji i powiązane z nimi dane, zaktualizuj zapytanie, aby wybrać personalization_assignment events. To przykładowe zapytanie zwróci pełne zdarzenie przypisania personalizacji dla określonego fragmentu daty, ograniczając wyniki do 10:

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

    Wskazówka: aby przeszukać wszystkie tabele zdarzeń zamiast tabeli podzielonej na fragmenty, możesz zastąpić datę tabeli zdarzeń gwiazdką (np. PROJECT_NAME.analytics_ANALYTICS_PROPERTY_ID.events_*). Nie jest to zalecane w przypadku scenariuszy innych niż testowe ani w przypadku dużych zbiorów danych.

  5. W narzędziu do tworzenia zapytań kliknij Uruchom zapytanie. Wyniki pojawią się w dolnym panelu.

W następnej sekcji omówimy szczegółowo, co obejmuje zdarzenie przypisania personalizacji.

Jakie dane personalizacji są eksportowane do BigQuery?

Dane personalizacji są uwzględniane w tabelach Google AnalyticsBigQuery i przechowywane w zdarzeniach personalization_assignment.

Podstawowe pola podawane w zdarzeniu personalizacji są takie same jak w przypadku dowolnego zdarzenia, co opisano w artykule [GA4] BigQuery Schemat eksportu.Analytics Najbardziej interesujące będą Cię parametry user_pseudo_id i(którego można używać do rozróżniania poszczególnych użytkowników), sygnatury czasowe zdarzeń i inne właściwości użytkownika.

Szczegóły dotyczące personalizacji są przechowywane w polu event_params i opisane w tej tabeli:

Parametr Typ danych Opis
personalization_id CIĄG ZNAKÓW Zawiera unikalny identyfikator uniwersalny (UUID) przypisanej personalizacji.
grupa CIĄG ZNAKÓW Wskazuje, czy użytkownik został przypisany do grupy personalizacji (P13N) czy do grupy kontrolnej (BASELINE).
arm_index LICZBA CAŁKOWITA Reprezentuje alternatywną wartość przypisaną do użytkownika, czyli liczbę całkowitą z zakresu od 0 do 4.
arm_key CIĄG ZNAKÓW Zawiera nazwę parametru używanego przez personalizację.
arm_value CIĄG ZNAKÓW Zawiera ciąg znaków wartości alternatywnej przypisany przez personalizację.
engaged_session_event LICZBA CAŁKOWITA Obejmuje liczbę sesji, w których użytkownik jest zaangażowany. Więcej informacji znajdziesz w artykule Sesje.
firebase_event_origin CIĄG ZNAKÓW Wskazuje źródło zdarzenia. W przypadku zdarzeń personalization_assignment zawsze będzie to fp.
firebase_screen_class CIĄG ZNAKÓW Zawiera nazwę klasy ekranu, na którym użytkownik był aktywny w momencie przypisania personalizacji. Więcej informacji znajdziesz w artykule Zdarzenia zbierane automatycznie.
firebase_screen_id LICZBA CAŁKOWITA Wyświetla identyfikator ekranu, na którym użytkownik był w momencie przypisania personalizacji. Więcej informacji znajdziesz w artykule Zdarzenia zbierane automatycznie.
first_open_time CIĄG ZNAKÓW Zawiera sygnaturę czasową (w milisekundach UTC) pierwszego otwarcia aplikacji przez użytkownika. Więcej informacji znajdziesz w artykule Zdarzenia zbierane automatycznie.
ga_session_id LICZBA CAŁKOWITA Zawiera Google Analyticsidentyfikator sesji. Więcej informacji znajdziesz w artykule Sesje. Możesz użyć tego parametru, aby powiązać zdarzenie personalization_assignment z innymi zdarzeniami Analytics.
ga_session_number LICZBA CAŁKOWITA Podaje numer sesji Google Analytics. Więcej informacji znajdziesz w artykule Sesje.

Przykładowe zapytania

Aby wyodrębnić parametry związane z personalizacją ze zdarzeń personalization_assignment, możesz użyć instrukcji SQL podobnej do tej:

    # 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