Memeriksa data personalisasi dengan BigQuery

Personalisasi Remote Config mencatat peristiwa Analytics personalization_assignment ke dalam log saat personalisasi ditetapkan kepada pengguna, sehingga Anda dapat menggunakan BigQuery untuk memeriksa dan menganalisis peristiwa personalisasi serta peristiwa terkaitnya.

Bagian berikut menjelaskan cara mengaktifkan ekspor BigQuery untuk peristiwa Analytics, cara peristiwa personalisasi disimpan, dan memberikan beberapa kueri dasar untuk membantu Anda memulai.

Mengaktifkan ekspor BigQuery untuk Google Analytics untuk Firebase

Jika Anda menggunakan paket Spark, Anda dapat menggunakan sandbox BigQuery untuk mengakses BigQuery tanpa biaya, dengan tunduk pada Batas sandbox. Lihat Harga dan sandbox BigQuery untuk mengetahui informasi selengkapnya.

Pertama, pastikan Anda mengekspor data Analytics ke BigQuery:

  1. Buka tab Integrations, yang dapat diakses menggunakan > Setelan project di Firebase console.
  2. Jika Anda sudah menggunakan BigQuery dengan layanan Firebase lainnya, klik Manage. Jika belum, klik Link.
  3. Tinjau About Linking Firebase to BigQuery, lalu klik Next.
  4. Di bagian Configure integration, aktifkan tombol Google Analytics.
  5. Pilih region dan pilih setelan ekspor.

  6. Klik Tautkan ke BigQuery.

Bergantung pada cara Anda memilih untuk mengekspor data, mungkin perlu waktu hingga satu hari sampai tabel tersedia. Untuk mengetahui informasi lebih lanjut tentang cara mengekspor data project ke BigQuery, baca Mengekspor data project ke BigQuery.

Selanjutnya, mari kita akses dan periksa peristiwa personalisasi di BigQuery.

Mengakses data personalisasi Remote Config menggunakan BigQuery

Untuk membuat kueri data analisis eksperimen:

  1. Buka BigQuery di Google Cloud console. Anda juga dapat membukanya langsung dari Analytics Events menggunakan link view your raw events in BigQuery di bagian bawah halaman.
  2. Pilih project Firebase Anda dan luaskan, lalu luaskan entri analytics_ANALYTICS_PROPERTY_ID dan klik events_.

    Mengakses peristiwa personalisasi di Konsol Cloud

  3. Dari drop-down Query, pilih In a new tab.

    Contoh kueri yang dibuat otomatis akan muncul.

  4. Untuk melihat peristiwa personalisasi dan data terkait, perbarui kueri untuk memilih peristiwa personalization_assignment. Contoh kueri berikut akan menampilkan peristiwa penetapan personalisasi yang lengkap untuk shard tanggal tertentu, sehingga membatasi hasil hingga 10:

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

    Tips: Untuk menelusuri semua tabel peristiwa, bukan tabel yang di-sharding, Anda dapat mengganti tanggal tabel peristiwa dengan tanda bintang (misalnya, PROJECT_NAME.analytics_ANALYTICS_PROPERTY_ID.events_*). Ini tidak direkomendasikan dalam skenario non-pengujian atau untuk set data yang besar.

  5. Di komposer kueri, pilih Run query. Hasilnya akan muncul di panel bawah.

Di bagian berikutnya, kita akan membahas hal yang disertakan dalam peristiwa penetapan personalisasi secara lebih mendetail.

Data personalisasi apa yang diekspor ke BigQuery?

Data personalisasi disertakan dalam tabel Google Analytics di BigQuery dan disimpan dalam peristiwa personalization_assignment.

Kolom dasar yang diberikan dalam peristiwa personalisasi sama seperti peristiwa Analytics apa pun seperti yang dijelaskan dalam [GA4] skema BigQuery Export. Anda akan lebih memerhatikan user_pseudo_id (yang dapat digunakan untuk membedakan pengguna), stempel waktu peristiwa, dan properti pengguna lainnya.

Detail khusus personalisasi disimpan di kolom event_params dan dijelaskan dalam tabel berikut:

Parameter Jenis data Deskripsi
personalization_id STRING Memberikan ID unik universal (UUID) yang ditetapkan untuk personalisasi.
grup STRING Menunjukkan apakah pengguna ditetapkan ke grup personalisasi (P13N) atau grup dasar pengukuran (BASELINE).
arm_index INTEGER Mewakili nilai alternatif yang ditetapkan untuk pengguna, yaitu bilangan bulat antara 0 dan 4.
arm_key STRING Berisi nama parameter yang digunakan oleh personalisasi.
arm_value STRING Berisi string nilai alternatif yang ditetapkan oleh personalisasi.
engaged_session_event INTEGER Termasuk jumlah sesi yang diikuti pengguna. Lihat Tentang sesi untuk informasi selengkapnya.
firebase_event_origin STRING Menunjukkan asal peristiwa. Ini akan selalu berupa fp untuk peristiwa personalization_assignment.
firebase_screen_class STRING Memberikan nama class pada layar tempat pengguna aktif saat penetapan personalisasi terjadi. Lihat Peristiwa yang dikumpulkan secara otomatis untuk informasi selengkapnya.
firebase_screen_id INTEGER Menampilkan ID layar tempat pengguna berada saat penetapan personalisasi terjadi. Lihat Peristiwa yang dikumpulkan secara otomatis untuk informasi selengkapnya.
first_open_time STRING Memberikan stempel waktu, dalam milidetik UTC, saat pertama kali pengguna membuka aplikasi. Lihat Peristiwa yang dikumpulkan secara otomatis untuk informasi selengkapnya.
ga_session_id INTEGER Memberikan ID sesi Google Analytics. Lihat Tentang sesi untuk informasi selengkapnya. Anda dapat menggunakan ini untuk menghubungkan peristiwa personalization_assignment dengan peristiwa Analytics lainnya.
ga_session_number INTEGER Memberikan nomor sesi Google Analytics. Lihat Tentang sesi untuk informasi selengkapnya.

Contoh kueri

Anda dapat menggunakan pernyataan SQL seperti berikut untuk mengekstrak parameter khusus personalisasi dari peristiwa 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