Peristiwa

Dengan layanan peristiwa Google Play Game, Anda mengumpulkan data kumulatif yang dihasilkan oleh pemain selama gameplay dan menyimpannya di server Google untuk analisis game. Anda dapat menentukan data pemain yang harus dikumpulkan game secara fleksibel; dan data ini dapat mencakup metrik seperti seberapa sering:

  • Pemain menggunakan item tertentu
  • Pemain mencapai level tertentu
  • Pemain melakukan beberapa tindakan game tertentu

Anda dapat menggunakan data peristiwa sebagai masukan tentang cara meningkatkan game. Misalnya, Anda dapat menyesuaikan tingkat kesulitan level tertentu dalam game yang menurut pemain terlalu sulit untuk diselesaikan.

Untuk mempelajari cara menerapkan peristiwa untuk platform Anda, lihat Implementasi klien.

Mengintegrasikan peristiwa dalam game Anda

Alur kerja berikut menjelaskan cara menerapkan peristiwa dalam game:

  1. Menentukan peristiwa. Untuk menentukan peristiwa baru yang akan direkam dalam game:
    1. Buka halaman Peristiwa untuk game Anda di Konsol Google Play.
    2. Klik tombol Tambahkan peristiwa baru dan konfigurasikan properti peristiwa.
    3. Publikasikan definisi peristiwa Anda dengan mengikuti langkah-langkah yang dijelaskan dalam Memublikasikan perubahan game.

  2. Menerapkan rekaman peristiwa di game Anda menggunakan API peristiwa. Misalnya, dalam kode Android, panggil metode increment peristiwa setiap kali game Anda mendeteksi bahwa peristiwa yang penting untuk kode telah dipicu.

  3. Melihat data peristiwa. Buka halaman Peristiwa untuk game Anda di Konsol Google Play guna melihat statistik untuk peristiwa yang ditangkap.

Dasar-dasar peristiwa

API peristiwa memberi Anda cara untuk menentukan dan mengumpulkan metrik gameplay yang menarik serta mengupload metrik ini ke Play Game SDK.

Peristiwa SDK Play Game berisi properti utama berikut:

Properti Deskripsi
ID String unik yang dibuat oleh Konsol Google Play untuk peristiwa ini. Gunakan ID unik ini untuk merujuk ke peristiwa di klien game Anda.
Nama Nama pendek peristiwa. Nama dapat berisi maksimal 100 karakter. Nilai ini digunakan oleh Konsol Google Play dan dapat ditampilkan di game Anda.

Contoh:

  • "Zombi yang Terbunuh"
  • "Permata Merah yang Dikumpulkan"
Deskripsi Deskripsi peristiwa yang lebih lama (misalnya, "Berapa kali pemain membunuh zombie" atau "Total jumlah permata merah yang telah dihilangkan dan dicocokkan oleh pemain"). Deskripsi dapat berisi hingga 500 karakter. Nilai ini digunakan oleh Konsol Google Play dan dapat ditampilkan di game Anda.
Jenis peristiwa

Kolom yang mendeklarasikan jenis data yang dilacak oleh peristiwa. Nilai ini digunakan oleh Konsol Google Play untuk mendukung pelaporan Analisis Pemain.

Dua jenis peristiwa didukung:

Sumber mata uang premium
Pilih jenis ini untuk peristiwa yang melacak sumber mata uang premium. Misalnya:
  • “Koin emas yang diperoleh"
  • “Zamrud yang dibeli”
Penurunan nilai mata uang premium
Pilih jenis ini untuk peristiwa yang melacak penurunan atau penggunaan mata uang premium. Misalnya:
  • “Koin emas yang dibelanjakan”
  • "Zamrud yang digunakan"
Ikon Ikon persegi yang akan dikaitkan dengan peristiwa Anda.

Membuat peristiwa

Untuk membuat peristiwa baru untuk game Anda, ikuti langkah-langkah berikut:

  1. Tambahkan game Anda di Konsol Google Play, jika Anda belum melakukannya.
  2. Di Konsol Google Play, klik ikon Layanan game di sebelah kiri dan pilih entri untuk game Anda.
  3. Pilih tab Events di sebelah kiri, lalu klik tombol Add event.
  4. Isi detail untuk peristiwa yang ingin Anda buat.
  5. Klik Save. Jika tidak ada error, peristiwa Anda akan ditempatkan dalam status "Siap dipublikasikan". Anda dapat melanjutkan untuk memublikasikan perubahan game.

Mengedit peristiwa

Untuk mengedit peristiwa yang Anda buat:

  1. Di Konsol Google Play, buka tab Events lalu pilih entri untuk peristiwa yang ingin Anda edit. Anda akan melihat formulir yang sama dengan formulir yang digunakan saat membuat peristiwa.
  2. Buat perubahan.
  3. Setelah selesai mengedit peristiwa, klik tombol Save.
  4. Uji game Anda untuk memverifikasi peristiwa yang telah dimodifikasi. Jika game berfungsi dengan baik, publikasikan ulang perubahan game Anda.

Menghapus peristiwa

Anda dapat menghapus peristiwa yang berstatus draf atau yang telah dipublikasikan. Untuk menghapus peristiwa di Konsol Google Play, klik tombol berlabel Delete di bagian bawah formulir untuk peristiwa tersebut.

Mereset data peristiwa

Anda dapat mereset data progres pemain untuk penguji peristiwa.

  • Untuk mereset peristiwa draf di Konsol Google Play, klik tombol berlabel Reset event progress di bagian bawah formulir untuk peristiwa tersebut.
  • Untuk mereset data peristiwa secara terprogram, panggil metode Events Management API.

Implementasi klien

Untuk mempelajari cara menerapkan peristiwa untuk platform Anda, lihat referensi berikut: