Sprawdzanie danych personalizacji w BigQuery

Remote Config Personalization rejestruje zdarzenie personalization_assignment Analytics, gdy personalizacja jest przypisana do użytkownika, co pozwala na użycie BigQuery do sprawdzania i analizowania zdarzeń personalizacji i powiązanych zdarzeń.

W sekcjach poniżej opisano, jak włączyć eksportowanie zdarzeń Analytics do BigQuery, jak przechowywane są zdarzenia związane z osobą, oraz podano kilka podstawowych zapytań, które pomogą Ci zacząć.

Włącz eksport danych usługi BigQuery z: Google Analytics, Firebase

Jeśli korzystasz z abonamentu Spark, możesz używać piaskownicy BigQuery, aby bezpłatnie korzystać z BigQuery, z zastrzeżeniem limitów piaskownicy. Więcej informacji znajdziesz w artykule Ceny i piaskownica BigQuery.

Najpierw upewnij się, że eksportujesz dane Analytics do BigQuery:

  1. W konsoli Firebase kliknij Ustawienia > Integracje.

  2. Na karcie BigQuery kliknij Połącz. Jeśli używasz już BigQuery z innymi usługami Firebase, kliknij Zarządzaj.

  3. Zapoznaj się z informacjami w sekcji Łączenie Firebase z BigQuery, a następnie 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 wybranego sposobu eksportowania danych tabele mogą stać się dostępne dopiero po upływie doby. Więcej informacji o eksportowaniu danych projektu do BigQuery znajdziesz w artykule Eksportowanie danych projektu do BigQuery.

Następnie możesz uzyskać dostęp do zdarzeń personalizacji i sprawdzić je w BigQuery.

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

Aby wysłać zapytanie dotyczące danych analitycznych eksperymentu:

  1. Otwórz BigQuery w konsoli Google Cloud. Możesz też otworzyć BigQuery bezpośrednio z konsoli Firebase, przechodząc do panelu Analytics > Zdarzenia i klikając link Wyświetl nieprzetworzone zdarzenia w BigQuery u dołu strony.

  2. Wybierz projekt Firebase i rozwiń go, a następnie rozwiń wpis analytics_ANALYTICS_PROPERTY_ID i kliknij events_.

    Uzyskiwanie dostępu 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ć zdarzenia personalization_assignment. 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_ID.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_ID.analytics_ANALYTICS_PROPERTY_ID.events_*). Nie zalecamy tego 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 znajdziesz szczegółowe informacje o tym, co zawiera zdarzenie przypisania personalizacji.

Jakie dane personalizacji są eksportowane do usługi BigQuery?

Dane personalizacji są zawarte w tabelach Google Analytics w BigQuery i przechowywane w zdarzeniach personalization_assignment.

Podstawowe pola podawane w zdarzeniu personalizacji są takie same jak w przypadku każdego zdarzenia Analytics opisanego w artykule Dane Google Analytics dla Firebase eksportowane do BigQuery. Najważniejsze będą dla Ciebie user_pseudo_id (które mogą służyć 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 Podaje 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 wartość alternatywną przypisaną użytkownikowi, 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 Podaje nazwę klasy ekranu, na którym użytkownik był aktywny, gdy nastąpiło przypisanie personalizacji. Więcej informacji znajdziesz w artykule Zdarzenia zbierane automatycznie.
firebase_screen_id LICZBA CAŁKOWITA Wyświetla identyfikator ekranu, na którym znajdował się użytkownik, gdy nastąpiło przypisanie personalizacji. Więcej informacji znajdziesz w artykule Zdarzenia zbierane automatycznie.
first_open_time CIĄG ZNAKÓW Podaje sygnaturę czasową (w milisekundach, czas UTC) pierwszego uruchomienia aplikacji przez użytkownika. Więcej informacji znajdziesz w artykule Zdarzenia zbierane automatycznie.
ga_session_id LICZBA CAŁKOWITA Podaje identyfikator sesji Google Analytics. Więcej informacji znajdziesz w artykule Sesje. Możesz go użyć, 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ć ze zdarzeń personalization_assignment parametry związane z personalizacją, 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_ID.analytics_ANALYTICS_ACCOUNT_ID.events_DATE_SHARD`
    WHERE event_name = 'personalization_assignment'
    LIMIT 10