Terapkan pengujian A/B untuk game Unity dengan Firebase Remote Config

1. Pengantar

Dalam codelab ini, Anda akan mempelajari cara membuat eksperimen Remote Config menggunakan Pengujian A/B untuk game contoh, MechaHamster: Level Up with Firebase edition, yang telah Anda ubah di Menginstrumentasikan game dengan Firebase Remote Config.

Pengujian A/B dengan Remote Config memungkinkan Anda menguji perubahan pada UI, fitur, atau kampanye interaksi aplikasi pada audiens yang ditargetkan sebelum meluncurkannya ke audiens yang lebih luas. Anda juga dapat menggunakan hasil eksperimen untuk:

• Tentukan varian nilai parameter yang dapat meningkatkan metrik utama, seperti pendapatan dan retensi.
• Temukan subgrup pengguna mana yang memilih varian tertentu.
• Kumpulkan dan simpan data eksperimen untuk melakukan analisis tambahan tentang efek penetapan parameter value yang berbeda.

Inilah inti dari Pengujian A/B: pengujian ini memungkinkan Anda mendapatkan kode yang diinstrumentasi untuk Remote Config dan meluncurkan eksperimen yang mengontrol nilai yang diterima klien, berdasarkan kondisi Remote Config (termasuk properti pengguna Google Analytics), peluncuran persentase, peristiwa konversi Analytics, dan beberapa kombinasinya.

Pertama, Anda akan menerapkan kondisi yang membatasi siapa yang akan disertakan dalam eksperimen dengan menetapkan properti pengguna berdasarkan tindakan pengguna. Kemudian, Anda akan membuat eksperimen A/B Testing yang menggunakan properti pengguna Google Analytics untuk menentukan klien yang disertakan dalam eksperimen tersebut. Terakhir, Anda akan menggunakan data tersebut untuk lebih memahami audiens.

Yang akan Anda pelajari

• Cara menyiapkan A/B Testing menggunakan nilai Remote Config berinstrumen
• Cara menggunakan properti pengguna Google Analytics sebagai bagian dari ketentuan untuk masuk ke pengujian A/B

Prasyarat

• Menyelesaikan Melengkapi game dengan Firebase Remote Config

Yang Anda butuhkan

• Unity 2019.1.0f1 atau yang lebih tinggi dengan dukungan build iOS dan/atau Android

2. Mengaktifkan Menu Debug

Ada Menu Debug yang disembunyikan dalam project, dan tombol untuk mengakses menu ini ada dalam game, tetapi saat ini tidak diaktifkan. Anda harus mengaktifkan tombol untuk mengaksesnya dari prefab MainMenu.

1. Di editor Unity, pilih tab Project, lalu di bagian Assets, luaskan Hamster > Prefabs > Menus dan klik MainMenu.

2. Dalam hierarki prefab, temukan sub-objek yang dinonaktifkan bernama DebugMenuButton, lalu klik untuk membukanya di tab Inspector.

3. Dalam tab Inspector, centang kotak di sudut kiri atas di samping kolom teks yang berisi DebugMenuButton untuk mengaktifkannya.

4. Simpan prefab.

Jika Anda menjalankan game di editor atau di perangkat, menu kini seharusnya dapat diakses.

3. Mengaktifkan submenu Remote Config

1. Dari tab Project di Unity Editor, luaskan Assets > Hamster > Prefab > Menus dan klik dua kali objek DebugMenu untuk membukanya di tab Hierarchy editor.
   
   
2. Di tab Hierarchy, luaskan hierarki dan klik sub-objek di bagian DebugMenu > Panel, yang diberi label Tindakan Remote Config.

3. Di tab Inspector Unity, aktifkan Remote Config Actions dengan mencentang kotak di sebelah kiri kolom teks yang berisi nama objek.

Versi ini memiliki dua turunan GameObject bernama Set Bored Of Subtitle dan Set Enjoys Subtitle, yang keduanya dikonfigurasi untuk memanggil metode yang ada tetapi tidak diterapkan di DebugMenu.cs.

4. Reset penggantian subtitel ke default dalam aplikasi

Di codelab sebelumnya, Anda mengganti nilai default parameter sebagai JSON dan menggunakan kondisi untuk menayangkan varian yang berbeda. Sebagai bagian dari codelab ini, Anda akan menghapus kondisi yang Anda buat dan memperkenalkan kembali default dalam aplikasi, dan Anda hanya akan menggantinya dengan hasil A/B Testing.

Untuk mengaktifkan kembali setelan default dalam aplikasi:

1. Buka halaman Remote Config di Firebase console, lalu klik ikon pensil di samping parameter subtitle_override untuk membuka panel samping Edit parameter.
2. Klik ikon X di samping kondisi untuk menghapusnya.
3. Di samping nilai default yang tersisa, aktifkan tombol Gunakan default dalam aplikasi.

4. Klik Simpan untuk menyimpan perubahan, lalu klik Publikasikan perubahan untuk memublikasikan perubahan.

5. Menetapkan Properti Pengguna dalam fungsi Debug

Sekarang Anda akan menulis isi fungsi untuk beberapa fungsi Google Analytics yang telah dikonfigurasi sebelumnya, tetapi belum diterapkan di DebugMenu.cs (yang dapat ditemukan di Aset > Hamster > Skrip > Status).

Fungsi ini menetapkan properti pengguna, yang merupakan cara untuk mendeskripsikan segmen basis pengguna Anda dan digunakan untuk mencatat perasaan pengguna tentang subtitel game.

Implementasikan SetUserBoredOfSubtitle dan SetUserEnjoysSubtitle dengan menemukan versi yang sudah ada di DebugMenu.cs dan menimpa versi tersebut sebagai berikut:

void SetUserBoredOfSubtitle()
{
  Firebase.Analytics.FirebaseAnalytics.SetUserProperty("subtitle_sentiment", "bored");
}

void SetUserEnjoysSubtitle()
{
  Firebase.Analytics.FirebaseAnalytics.SetUserProperty("subtitle_sentiment", "enjoys");
}

Jika aplikasi Anda dikonfigurasi dengan benar dengan Google Analytics, Anda dapat memanggil salah satu fungsi ini untuk menyediakan properti ke kondisi Remote Config. Untuk memanggil SetUserBoredOfSubtitle dari perangkat seluler, mulai game dan tekan tombol Debug Menu di menu utama, lalu tekan Set Bored of Subtitle.

Catatan: Jika Anda telah menerapkan Remote Config Real-time menggunakan OnConfigUpdateListener, mengubah evaluasi kondisi tidak akan menyebabkan klien mengambil ulang nilai kondisional baru. Fungsi real-time harus selalu melengkapi perilaku pengambilan dan pengaktifan yang ada, bukan menggantinya, sehingga Anda masih harus menggunakan FetchRemoteConfig class MainGame di Assets/Hamster/Scripts/States/MainMenu.cs dan Assets/Hamster/Scripts/States/BaseLevelSelect.cs ke FetchAndActivate nilai kondisional baru.

6. Membuat Dimensi Kustom

Selanjutnya, Anda akan menyiapkan berbagai varian subtitel untuk subtitle_override guna melihat subtitel mana yang paling efektif. Namun, dalam pengujian A/B, Anda hanya akan menayangkan varian ini kepada pengguna yang perasaannya tentang subtitel saat ini (seperti yang dicatat di subtitle_sentiment) menyertakan kata "bosan".

Anda akan menggunakan dimensi kustom untuk membuat dan melacak parameter kustom pada peristiwa Analytics. Lihat Dimensi dan metrik kustom untuk mengetahui informasi selengkapnya.

Untuk membuat dimensi kustom baru:

1. Buka Firebase console, luaskan menu Analytics, dan pilih Definisi kustom.
2. Dari halaman Definisi kustom, klik Buat dimensi kustom.
3. Di jendela New custom dimension, tetapkan Nama dimensi ke "Subtitle Sentiment" dan, dari menu drop-down Scope, pilih User.
4. Untuk kolom User property, pilih subtitle_sentiment.

Catatan: Karena perlu waktu beberapa jam agar properti pengguna diterapkan dari Google Analytics ke Firebase, subtitle_sentiment mungkin tidak langsung tersedia dari menu drop-down Properti Pengguna. Dalam hal ini, Anda dapat mengetik atau menempelkannya ke kolom secara manual.

7. Menyiapkan eksperimen A/B Testing

Selanjutnya, buat eksperimen A/B Testing untuk menetapkan nilai yang berbeda agar subtitle_override dapat diuji satu sama lain guna mengoptimalkan retensi pengguna dua hingga tiga hari.

1. Pertama, pilih Edit pada parameter subtitle_override di halaman Remote Config Firebase console:

2. Dari dialog Edit parameter yang muncul, klik Add new.

3. Dari daftar yang muncul, pilih Eksperimen.

4. Masukkan nama dan deskripsi untuk eksperimen Anda.

5. Selanjutnya, pilih kondisi penargetan. Pertama, pilih Aplikasi Anda dari menu drop-down.

6. Selanjutnya, klik Dan untuk menambahkan kondisi baru, lalu pilih Properti Pengguna dan pilih subtitle_sentiment. Jika tidak muncul, masukkan secara manual.
7. Karena Anda hanya ingin menyetel {i>subtitle<i} untuk mereka yang memiliki sentimen {i>subtitle<i} saat ini termasuk "bosan," pilih contains dan ketik bored.
8. Secara opsional, pilih persentase audiens yang cocok dengan kriteria di atas untuk diekspos ke pengujian. Pilih 100% untuk menghindari keacakan yang tidak dapat Anda kontrol dengan mudah.

9. Berikutnya, pilih sasaran yang akan dimaksimalkan oleh pengujian. Pilih Retention (2-3 days).

10. Berikutnya, siapkan parameter eksperimen dan buat varian subjudul yang berbeda . Varian ini adalah berbagai nilai yang akan ditayangkan Pengujian A/B kepada pengguna yang subtitle_sentiment-nya berisi 'bosan', dan Pengujian A/B akan menentukan varian mana yang terbaik untuk memaksimalkan retensi.
11. Masukkan nilai parameter berikut untuk Varian A:

    {"text":"A: A game about a mechanical hamster","fontSize":8,"textColor":{"r":0.0,"g":255.0,"b":0.0,"a":255.0}}
    

12. Masukkan nilai parameter berikut untuk Varian B:

    {"text":"B: A game about a mechanical hamster","fontSize":14,"textColor":{"r":255.0,"g":0.0,"b":0.0,"a":255.0}}
    

13. Tetapkan rasio varian dengan bilangan bulat sebagai berikut:
    • Dasar pengukuran: 1
    • Varian A: 100
    • Varian B: 100
    Ini akan menghasilkan bobot total 0,5% untuk Dasar Pengukuran, 49,8% untuk Varian A, dan 49,8% untuk Varian B.Varian ini menentukan bahwa satu dari 201 kali, A/B Testing berfungsi secara default bagi mereka yang bosan dengan subtitel, tetapi 200/201 kali, pengujian ini akan menampilkan salah satu dari dua nilai baru dan mengganti layar judul.
14. Simpan dan kirim dengan mengklik Start experiment, lalu klik Start di pop-up konfirmasi.

8. Jalankan metode Set User Property dan muat ulang

Sekarang Anda telah menetapkan berbagai properti tentang pengguna, yang kemudian dapat digunakan untuk mengarahkan logika atau presentasi game Anda.

Jika sebelumnya Anda belum menjalankan metode SetUserProperty atau telah menetapkannya ke enjoys, Anda masih akan melihat subtitel default saat membuka game.

Jika telah menetapkannya ke bored (sebelum mengambil ulang), Anda akan melihat salah satu nilai baru dengan rasio sekitar 50/50.

Setelah perangkat dimasukkan ke eksperimen A/B Testing, nilai yang diterima dari eksperimen tersebut tidak akan berubah dan bersifat persisten per penginstalan. Akibatnya, untuk menerima salah satu nilai eksperimental lainnya, Anda harus membuat penginstalan baru dengan menginstal ulang game ke perangkat/simulator yang sama atau menginstal game ke perangkat/simulator baru.

Dalam pengujian A/B sebenarnya yang diluncurkan di seluruh basis pengguna, Anda harus memberikan bobot yang serupa dengan varian lainnya. Namun dalam kasus ini, Anda menetapkan probabilitas yang sangat condong untuk memvalidasi bahwa eksperimen berfungsi. Jika (dalam kasus 1/201), Anda masih menerima nilai default, coba instal ulang game ke perangkat/simulator Anda.

Efek lain dari hal ini adalah mengalihkan properti pengguna kembali ke enjoys tidak akan mengubah nilai kembali ke dasar pengukuran, tetapi sekali lagi, Anda dapat melakukannya dengan beralih ke enjoys dan menginstal ulang.

Catatan: Jika ingin menguji setiap nilai varian dalam eksperimen, Anda dapat menambahkan Firebase Installation SDK, mengambil token penginstalan, dan menempatkan perangkat secara manual ke dalam grup eksperimen.

9. Selamat!

Anda telah menggunakan A/B Testing Remote Config untuk bereksperimen dengan berbagai nilai Remote Config dan menentukan pengaruh masing-masing terhadap metrik Analytics.

Yang telah kita bahas

• Cara menyiapkan A/B Testing menggunakan nilai Remote Config berinstrumen
• Cara menggunakan Properti Pengguna Google Analytics sebagai bagian dari kondisi untuk masuk ke eksperimen Pengujian A/B

Langkah Berikutnya

Setelah eksperimen berakhir, Anda dapat memilih satu eksperimen dari daftar eksperimen di project Anda untuk memutuskan tindakan yang ingin dilakukan dengan eksperimen tersebut. Apa Anda mau memilih salah satunya sebagai "pemenang" atau melakukan lebih banyak eksperimen?

Jika ingin menerapkan analisis Anda sendiri pada hasil, pertimbangkan untuk mengekspor ke BigQuery.

Jika Anda lebih memilih agar Firebase menerapkan machine learning secara otomatis pada penyesuaian kustom eksperimen persisten untuk setiap pengguna, pertimbangkan personalisasi Remote Config.