Halaman ini diterjemahkan oleh Cloud Translation API.

Statistik pemain untuk game Android

Panduan ini menunjukkan cara menggunakan API statistik pemain untuk Layanan game Google Play. Anda dapat menggunakan API statistik pemain untuk mengambil data tentang aktivitas pemain dalam game.

API statistik pemain memungkinkan Anda menyesuaikan pengalaman game dengan segmen pemain tertentu dan beragam tahapan siklus proses pemain. Anda dapat membangun pengalaman yang disesuaikan untuk setiap segmen pemain berdasarkan progres, belanja, dan interaksi mereka. Misalnya, Anda bisa menggunakan API ini untuk mengambil tindakan proaktif guna mendorong pemain yang kurang aktif untuk berinteraksi kembali dengan game Anda, misalnya dengan menampilkan dan mempromosikan item di game baru saat pemain login.

API ini dapat ditemukan dalam paket com.google.android.gms.games.stats dan com.google.android.gms.games.

Jenis data pemain yang dapat diambil antara lain:

Durasi sesi rata-rata: Durasi sesi rata-rata dari pemain dalam menit. Durasi sesi ditentukan oleh waktu yang digunakan pemain saat login ke layanan game Google Play.
Jumlah hari sejak terakhir bermain: Perkiraan jumlah hari sejak pemain terakhir bermain.
Jumlah pembelian: Perkiraan jumlah pembelian dalam aplikasi yang dilakukan oleh pemain.
Jumlah sesi: Perkiraan jumlah sesi pemain. Sesi ditentukan oleh berapa kali pemain login ke layanan game Google Play.
Persentil sesi: Perkiraan persentil sesi untuk pemain yang ditentukan sebagai nilai desimal antara 0 hingga 1 inklusif. Nilai ini menunjukkan jumlah sesi yang telah dimainkan oleh pemain saat ini dibandingkan dengan komunitas pemain game ini yang lainnya. Jumlah yang lebih tinggi menunjukkan bahwa sesi yang dimainkan oleh pemain ini lebih banyak.
Persentil belanja: Perkiraan persentil belanja pemain, yang ditentukan sebagai nilai desimal antara 0 hingga 1 inklusif. Nilai ini menunjukkan jumlah belanja pemain saat ini dibandingkan dengan komunitas pemain game ini yang lainnya. Jumlah yang lebih tinggi menunjukkan bahwa pemain ini lebih banyak berbelanja.

Jenis data pemain berikut tidak digunakan lagi dan selalu menampilkan konstanta nilai yang tidak ditetapkan:

Probabilitas churn: Prediksi apakah pemain akan berhenti menggunakan aplikasi pada hari berikutnya yang ditentukan sebagai nilai desimal antara 0 (probabilitas churn rendah) hingga 1 (probabilitas churn inggi) inklusif. Churn didefinisikan sebagai 7 hari tidak aktif.
Probabilitas belanja: Perkiraan probabilitas pemain dalam memilih untuk belanja dalam game ini yang ditentukan sebagai nilai desimal antara 0 (probabilitas belanja rendah) hingga 1 (probabilitas belanja tinggi) inklusif.
Total belanja selama 28 hari berikutnya: Perkiraan total belanja pemain yang diharapkan selama 28 hari berikutnya dalam game ini.
Probabilitas pembeli setia: Perkiraan probabilitas bahwa selama 28 hari berikutnya pemain akan membelanjakan sebesar 95% persentil atau lebih tinggi untuk komunitas pemain game ini. Nilai ini ditunjukkan sebagai nilai desimal antara 0 (probabilitas rendah untuk menjadi pembeli setia) hingga 1 (probabilitas tinggi untuk menjadi pembeli setia).

Sebelum memulai

Sebelum Anda mulai menggunakan API statistik pemain:

Download dan tinjau contoh kode.
Pahami rekomendasi yang dijelaskan dalam Checklist Kualitas.

Mendapatkan klien

Untuk mulai menggunakan API statistik pemain, game Anda harus telah terlebih dahulu mendapatkan objek PlayerStatsClient. Anda dapat melakukannya dengan memanggil metode Games.getPlayerStatsClient() dan meneruskan aktivitas.

Class PlayerStatsClient menggunakan class Task layanan Google Play untuk menampilkan hasil secara asinkron. Untuk mempelajari lebih lanjut cara menggunakan tugas untuk mengelola tugas berangkai, lihat panduan developer Tasks API.

Mengambil data

Untuk mengambil data statistik pemain dari pemain yang saat ini login, ikuti langkah-langkah berikut:

Panggil metode PlayerStatsClient.loadPlayerStats().
Jika panggilan berhasil, Layanan game Google Play akan menampilkan objek Task yang secara asinkron memuat objek PlayerStats . Gunakan metode objek ini untuk mengambil data aktivitas pemain yang login di aplikasi Anda.

Berikut contohnya:

public void checkPlayerStats() {
  PlayGames.getPlayerStatsClient(this)
      .loadPlayerStats(true)
      .addOnCompleteListener(new OnCompleteListener<AnnotatedData<PlayerStats>>() {
        @Override
        public void onComplete(@NonNull Task<AnnotatedData<PlayerStats>> task) {
          if (task.isSuccessful()) {
            // Check for cached data.
            if (task.getResult().isStale()) {
              Log.d(TAG, "using cached data");
            }
            PlayerStats stats = task.getResult().get();
            if (stats != null) {
              Log.d(TAG, "Player stats loaded");
              if (stats.getDaysSinceLastPlayed() > 7) {
                Log.d(TAG, "It's been longer than a week");
              }
              if (stats.getNumberOfSessions() > 1000) {
                Log.d(TAG, "Veteran player");
              }
              if (stats.getChurnProbability() == 1) {
                Log.d(TAG, "Player is at high risk of churn");
              }
            }
          } else {
            int status = CommonStatusCodes.DEVELOPER_ERROR;
            if (task.getException() instanceof ApiException) {
              status = ((ApiException) task.getException()).getStatusCode();
            }
            Log.d(TAG, "Failed to fetch Stats Data status: "
                + status + ": " + task.getException());
          }
        }
      });
}

Tips

Play Stats API memudahkan Anda mengidentifikasi berbagai jenis pemain berdasarkan interaksi dan perilaku belanja mereka, serta menerapkan strategi yang sesuai untuk meningkatkan pengalaman mereka bermain game.

Tabel berikut menampilkan beberapa contoh segmen pemain dan strategi interaksi yang direkomendasikan:

Segmen Pemain	Strategi Interaksi
Pemain aktif dengan jumlah sesi yang tinggi dan persentil belanja yang baik, tetapi belum bermain dalam seminggu terakhir atau lebih.	Kirim notifikasi diskon atau bonus khusus saat pemain kembali bermain. Tampilkan pesan sambutan yang mengumumkan pencapaian yang mengesankan, dan berikan penghargaan berupa badge yang didesain untuk mendorong pemain kembali bermain.
Pemain yang sangat aktif dengan persentil belanja rendah.	Berikan bonus khusus untuk mendorong mereka mengajak temannya menginstal dan memainkan game Anda. Pendekatan ini akan meningkatkan kesenangan bermain game untuk merekrut pemain baru.
Pemain dengan jumlah belanja tinggi yang menunjukkan tanda kejenuhan dan mulai jarang bermain.	Berikan bonus khusus untuk menarik kembali minat mereka, misalnya dengan menawarkan senjata atau perlengkapan berdurasi singkat yang bernilai tinggi, atau diskon. Saat pemain login kembali, tampilkan video yang mengarahkannya ke fitur komunitas, seperti serangan klan, yang mendorong interaksi lebih sering dan lebih lama.
Pemain dengan probabilitas belanja sangat tinggi atau sangat rendah.	Kemungkinan tidak berbelanja: Berikan opsi untuk menonton video iklan. Tampilkan item yang telah diturunkan harganya yang dapat dibeli. Kemungkinan akan berbelanja: Arahkan pemain ke toko dalam game lebih awal, dan berikan promosi khusus untuk mendorong mereka berbelanja.