Panduan Menyusun Event Dictionary untuk Analitik Game

Event dictionary adalah dokumen yang mencatat semua event dan properti yang dikirim dari game ke sistem analitik. Tanpa dokumen ini, tim sering menemukan event bernama level_start di satu tempat dan levelStart di tempat lain, sehingga analisis jadi lambat. Panduan menyusun event dictionary ini menunjukkan langkah yang bisa langsung dipakai tim data dan developer.

Mulai dari daftar event yang sudah ada

Sebelum menambah aturan baru, kumpulkan semua event yang sudah terkirim. Cara termudah: ekspor daftar event dari dashboard analytics atau dari file konfigurasi SDK. Jika belum ada, minta developer menelusuri kode pemanggilan event di klien game. Setelah daftar terkumpul, kelompokkan berdasarkan kategori seperti progresi, monetisasi, sosial, dan error.

Untuk memastikan daftar ini lengkap, bandingkan dengan sumber data lain yang sudah berjalan. Membandingkan sumber data game analytics untuk pemula bisa menjadi langkah awal untuk melihat event mana yang mungkin terlewat dari satu sumber.

Tentukan konvensi penamaan

Pilih satu gaya penamaan dan pakai di seluruh event. Contoh yang umum: huruf kecil semua dengan pemisah garis bawah (snake_case), misalnya level_start, item_purchase, ad_watched. Hindari campuran gaya karena akan memecah data saat query.

Aturan penamaan sebaiknya mencakup:

Format nama event: kata benda + kata kerja, misalnya level_complete, bukan complete_level.
Properti: gunakan nama yang deskriptif seperti level_id, item_price, currency_type.
Tipe data: tentukan apakah properti berupa string, integer, float, atau boolean, dan jangan berubah di tengah jalan.
Nilai yang diizinkan: untuk properti kategorikal, buat daftar nilai yang valid agar tidak ada variasi tak terkontrol.

Susun struktur dokumen event dictionary

Event dictionary yang baik mudah dibaca dan diubah. Gunakan tabel dengan kolom minimal: nama event, deskripsi, pemicu, properti, tipe properti, dan contoh nilai. Berikut contoh format yang bisa langsung dipakai:

| Nama Event     | Deskripsi                  | Pemicu                          | Properti                  | Tipe     | Contoh Nilai               |
|----------------|----------------------------|---------------------------------|---------------------------|----------|----------------------------|
| level_start    | Pemain memulai level       | Layar level dimuat              | level_id, difficulty      | int, str | 12, "hard"                 |
| level_complete | Pemain menyelesaikan level | Level selesai tanpa kalah       | level_id, duration_sec    | int, int | 12, 95                    |
| item_purchase  | Pembelian item in-game     | Transaksi berhasil              | item_id, price, currency  | str, float, str | "sword_01", 4.99, "USD" |

Simpan dokumen di repositori yang bisa diakses tim, misalnya folder bersama atau wiki internal. Setiap perubahan harus melalui review agar tidak ada properti yang hilang tanpa pencatatan.

Validasi event sebelum rilis

Setelah dictionary selesai, uji event di lingkungan pengembangan. Kirim event dari build internal dan periksa apakah data yang masuk sesuai dengan definisi. Langkah ini menangkap kesalahan seperti properti yang salah tipe atau nilai di luar daftar yang diizinkan.

Untuk audit yang lebih menyeluruh, panduan langkah demi langkah audit game analytics bisa membantu memeriksa konsistensi event dari klien hingga database. Lakukan validasi ini setiap kali ada event baru atau perubahan properti.

Jaga konsistensi setelah rilis

Event dictionary bukan dokumen sekali jadi. Setiap fitur baru berpotensi menambah event atau properti. Tetapkan proses sederhana: developer mengusulkan event baru, tim data meninjau dampaknya, lalu dictionary diperbarui sebelum kode masuk ke produksi.

Beberapa kebiasaan yang membantu:

Sematkan versi dictionary di repositori kode agar developer mudah merujuk.
Catat tanggal perubahan dan alasan di kolom terpisah.
Larang penggunaan event tanpa dokumentasi, meskipun hanya untuk eksperimen.

Jika tim mulai kewalahan dengan jumlah event, pertimbangkan untuk meninjau ulang metrik yang benar-benar dipakai. 7 metrik game analytics untuk menilai kualitas data bisa menjadi bahan diskusi untuk memangkas event yang tidak memberi informasi.

Ringkasan

Menyusun event dictionary dimulai dari mendata event yang sudah ada, menetapkan konvensi penamaan, membuat dokumen terstruktur, memvalidasi sebelum rilis, dan menjaga konsistensi setelahnya. Dokumen ini mempercepat analisis karena semua orang merujuk nama dan properti yang sama.

Pertanyaan yang Sering Diajukan

Siapa yang sebaiknya memiliki event dictionary?

Tim data dan developer game bekerja bersama. Tim data biasanya menjaga isi dan validasi, sementara developer memastikan implementasi di kode sesuai dokumen.

Apakah event dictionary sama dengan data dictionary?

Tidak sepenuhnya. Data dictionary mencakup semua tabel dan kolom di gudang data, sedangkan event dictionary khusus mendefinisikan event dan properti yang dikirim dari game. Keduanya bisa saling melengkapi.

Bagaimana jika event lama sudah tidak dipakai?

Tandai sebagai usang di dokumen, jangan langsung dihapus. Hentikan pengiriman event dari klien, lalu simpan catatan agar analisis historis tetap bisa dipahami.