Acara

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 untuk melihat statistik peristiwa yang direkam.

Dasar-dasar peristiwa

API acara memberi Anda cara untuk menentukan dan mengumpulkan gameplay yang menarik metrik dan mengupload metrik tersebut ke Layanan game Google Play.

Peristiwa layanan game Google Play 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 Pemain Pelaporan Analytics.

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 acara

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

  1. Menambahkan 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 dan pilih untuk acara 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. Kepada menghapus acara di Konsol Google Play, klik tombol berlabel Hapus 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 progres peristiwa 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: