Android oyunları için oyuncu istatistikleri

Bu kılavuzda, Google Play Games Hizmetleri için oyuncu istatistikleri API'sinin nasıl kullanılacağı gösterilmektedir. Bir oyuncunun oyun içi etkinliğiyle ilgili verileri almak için oyuncu istatistikleri API'sini kullanabilirsiniz.

Oyuncu istatistikleri API'si, oyun deneyimlerini belirli oyuncu segmentlerine ve oyuncu yaşam döngüsünün farklı aşamalarına göre uyarlamanıza olanak tanır. Oyuncuların ilerleme durumuna, harcamalarına ve etkileşimlerine göre her oyuncu segmenti için özel deneyimler oluşturabilirsiniz. Örneğin, daha az aktif olan bir oyuncuyu oyununuzla yeniden etkileşime geçmeye teşvik etmek için proaktif işlemler yapmak amacıyla bu API'yi kullanabilirsiniz. Örneğin, oyuncu oturum açtığında yeni oyun içi öğeleri gösterebilir ve tanıtabilirsiniz.

API'leri com.google.android.gms.games.stats ve com.google.android.gms.games paketlerinde bulabilirsiniz.

Başlamadan önce

Oyuncu istatistikleri API'sini kullanmaya başlamadan önce:

• Kod örneğini indirip inceleyin.
• Kalite Kontrol Listesi'nde açıklanan önerileri inceleyin.

Oyuncu istatistikleri istemcisini alma

Oyuncu istatistikleri API'sini kullanmaya başlamak için oyununuzun önce bir PlayerStatsClient nesnesi alması gerekir. Bunu, PlayerStatsClient.getPlayersClient() yöntemini çağırıp etkinliği ileterek yapabilirsiniz.

PlayerStatsClient sınıfı, sonuçları eşzamansız olarak döndürmek için Google Play Hizmetleri Task sınıfından yararlanır. Görevleri kullanarak mesaj dizili çalışmaları yönetme hakkında daha fazla bilgi edinmek için Tasks API geliştirici kılavuzunu inceleyin.

Oyuncu istatistikleri hakkında temel bilgiler

Oyuncu istatistikleri API'sini kullanarak bir oyuncunun oyun içi etkinliğiyle ilgili verileri alabilirsiniz. Ayıklayabileceğiniz oyuncu verisi türleri şunlardır:

• Ortalama oturum süresi: Oynatıcının dakika cinsinden ortalama oturum süresi. Oturum süresi, oyuncunun Google Play Oyun Hizmetleri'nde oturum açtığı süreye göre belirlenir.

• Son oynama tarihinden bu yana geçen gün sayısı: Oyuncunun son oynama tarihinden bu yana geçen yaklaşık gün sayısı.

• Satın alma sayısı: Oyuncu için yaklaşık uygulama içi satın alma işlemi sayısı.

• Oturum sayısı: Oynatıcının yaklaşık oturum sayısı. Oturumlar, bir oyuncunun Google Play Games Hizmetleri'nde oturum açma sayısının toplamına göre belirlenir.

• Oturum yüzdesi: Oyuncu için oturum yüzdesinin yaklaşık değeridir. 0 ile 1 (dahil) arasında bir ondalık değer olarak verilir. Bu değer, mevcut oyuncunun oyunun oyuncu tabanının geri kalanına kıyasla kaç oturum oynadığını gösterir. Daha yüksek sayılar, bu oyuncunun daha fazla oturum oynadığını gösterir.

• Harcama yüzdesi: Oynatıcının yaklaşık harcama yüzdesi. 0 ile 1 arasında bir ondalık değer olarak gösterilir. Bu değer, mevcut oyuncunun oyunun oyuncu tabanının geri kalanına kıyasla ne kadar harcama yaptığını gösterir. Daha yüksek sayılar, bu oyuncunun daha fazla harcama yaptığını gösterir.

Aşağıdaki oynatıcı verisi türleri için destek sonlandırılmıştır ve her zaman ayarlanmamış bir değer sabit değeri döndürürler:

Oyuncu istatistikleri verilerini alma

Oturum açmış oyuncunun oyuncu istatistikleri verilerini almak için aşağıdaki adımları uygulayın:

1. PlayerStatsClient.loadPlayerStats() yöntemini çağırın.

2. Arama başarılı olursa Google Play Games Hizmetleri, PlayerStats sınıfından bir nesneyi eşzamansız olarak yükleyen bir Task sınıfından nesne döndürür. Oturum açmış oyuncunun uygulamanızdaki etkinlikleriyle ilgili verileri almak için bu nesnenin yöntemlerini kullanın.

Aşağıda bununla ilgili bir örnek verilmiştir:

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());
          }
        }
      });
}

Oyuncu istatistikleri verilerini kullanmayla ilgili ipuçları

Play Stats API, etkileşim ve harcama davranışlarına göre çeşitli oyuncu türlerini belirlemenize ve oyun deneyimlerini iyileştirmek için uygun stratejiler uygulamanıza olanak tanır.

Aşağıdaki tabloda, bazı örnek oyuncu segmentleri ve önerilen etkileşim stratejileri listelenmiştir: