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.

Sebelum memulai

Sebelum Anda mulai menggunakan API statistik pemain:

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

Mendapatkan klien statistik pemain

Untuk mulai menggunakan API statistik pemain, game Anda harus telah terlebih dahulu mendapatkan objek PlayerStatsClient. Anda dapat melakukannya dengan memanggil metode PlayerStatsClient.getPlayersClient() 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.

Dasar-dasar statistik pemain

Anda dapat menggunakan API statistik pemain untuk mengambil data tentang aktivitas dalam game pemain. 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:

Mengambil data statistik pemain

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

1. Panggil metode PlayerStatsClient.loadPlayerStats().

2. Jika panggilan berhasil, Layanan game Google Play akan menampilkan objek Task yang secara asinkron memuat objek PlayerStats . Gunakan metode objek ini untuk mengambil data tentang 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 menggunakan data statistik pemain

Play Stats API memungkinkan 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: