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. Şunları yapabilirsiniz: bir oyuncunun oyun içi etkinliğiyle ilgili verileri almak için oyuncu istatistikleri API'sini kullanma.

Oyuncu istatistikleri API'si, oyun deneyimlerinizi kitlenizin belirli segmentlerine farklı aşamalarına odaklanıyoruz. Kendi projenize göre özelleştirilmiş her bir oyuncu segmenti için, oyuncuların nasıl ilerlediklerine, harcama yaptıklarına, ve ilgi çekici hale getirmektir. Örneğin, aşağıdaki işlemler için proaktif önlemler almak üzere bu API'yi kullanabilirsiniz: Daha az aktif bir oyuncuyu oyununuzla yeniden etkileşimde bulunmaya teşvik edin. Örneğin, Oyuncu oturum açtığında yeni oyun içi öğeleri gösterme ve tanıtma.

API'leri com.google.android.gms.games.stats ve com.google.android.gms.games paketleri dahildir.

Alabileceğiniz oynatıcı verisi türleri şunlardır:

  • Ortalama oturum uzunluğu: Kullanıcının oturumdaki ortalama oturum uzunluğu. dakika. Oturum uzunluğu, oyuncunun Google Play Games hizmetleri.

  • Son oynatılmadan bu yana geçen gün sayısı: Oynatıcıdan bu yana geçen yaklaşık gün sayısı son oynandı.

  • Satın alma sayısı: oynatıcıya gitmiş olur.

  • Oturum sayısı: Oynatıcının yaklaşık oturum sayısı. Oturumlar, oyuncunun Google Play Games hizmetleri.

  • Oturum yüzdelik dilimi: oynatıcıya 0 ile 1 arasında ondalık bir değer olarak verilir. Bu değer, bu oyunu oynayanın geri kalanına kıyasla mevcut oyuncunun oynadığı oturum sayısı büyütmek açısından önemlidir. Sayıların yüksek olması, bu oyuncunun daha fazla oturum oynadığını gösterir.

  • Harcama yüzdelik dilimi: Belirtilen oyuncuya ait yaklaşık harcama yüzdelik dilimi 0 ile 1 arasında ondalık değer olarak kullanabilirsiniz. Bu değer, mevcut oyuncunun, bu oyunu oynayanların geri kalanına kıyasla ne kadar harcama yaptığı büyütmek açısından önemlidir. Yüksek sayılar, bu oyuncunun daha fazla harcama yaptığını gösterir.

Aşağıdaki oynatıcı verisi türleri kullanımdan kaldırılır ve her zaman ayarlanmamış olarak döndürür değer sabiti:

  • Uygulamayı kullanmayı bırakma olasılığı: Bir oyuncunun uygulamayı kullanmayı bırakıp bırakmayacağına dair tahmin 0 arasında ondalık bir değer olarak verilir (düşük olasılıklı uygulamayı kullanmayı bırakma) 1'e (yüksek oranda kullanmayı bırakma olasılığı) ekleyebilirsiniz. Uygulamayı kullanmayı bırakma değeri, 7 olarak tanımlanır gün boyunca etkin olmayabileceği anlamına gelir.
  • Harcama olasılığı: Oyuncunun yaklaşık olasılığı 0 (düşük) arasında ondalık bir değer olarak verilen, bu oyunda harcama yapmayı seçme harcama olasılığı) 1'e (yüksek harcama olasılığı) ekleyebilirsiniz.
  • Sonraki 28 gündeki toplam harcama: Beklenen toplam oyuncu sayısı yaklaşıktır harcama yapmasına izin vermiştir.
  • Yüksek harcama olasılığı: bir oyuncu sonraki 28 gün içinde 95. gün boyunca bu oyunun oyuncu tabanının yüzdelik dilimi veya daha yüksek bir kısmı. Bu değer ondalık sayı olarak verilir 0 (yüksek harcama yapma olasılığı düşük) ile 1 (yüksek) arasında değer harcamalar yapma olasılığına göre).

Başlamadan önce

Oynatıcı istatistikleri API'sini kullanmaya başlamadan önce:

Müşteriyi edinin

Oyuncu istatistikleri API'sini kullanmaya başlamak için oyununuzun önce bir PlayerStatsClient nesnesini tanımlayın. Bunu, Games.getPlayerStatsClient() ve etkinliği iletmenizi sağlar.

İlgili içeriği oluşturmak için kullanılan PlayerStatsClient Sınıfın Google Play Hizmetleri'ni kullanması Task sınıfını kullanır. Şu konu hakkında daha fazla bilgi edinmek için: veya görevleri nasıl kullanacağınızı öğrenmek için Görevler API'si geliştirici kılavuzu.

Verileri alma

Şu anda oturum açmış olan oyuncunun oyuncu istatistikleri verilerini almak için şu adımları uygulayın: için şu adımları izleyin:

  1. Şunu çağırın: PlayerStatsClient.loadPlayerStats() yöntemidir.

  2. Arama başarılı olursa Google Play Games Hizmetleri bir Task eşzamansız olarak yükleyen nesne PlayerStats nesnesini tanımlayın. Oturum açan kullanıcıyla 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());
          }
        }
      });
}

İpuçları

Play Stats API'si, oyun istatistiklerine ve oyun istatistiklerine göre etkileşim ve harcama alışkanlıklarını kavrayabilir ve bunlara uygun stratejileri oyun deneyimlerini zenginleştiriyor.

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

Oyuncu Segmenti Etkileşim stratejisi
Oturum sayısı yüksek ve harcamaları iyi olan sık oyuncular son bir haftadır veya daha uzun süredir oynatılmamış.
  • İndirim veya özel bonus hakkında bildirim gönderme geri döndüklerinde kullanılabilir.
  • Etkileyici olduğunu belirten bir tekrar karşılama mesajı gösterin ve onları teşvik etmek için tasarlanmış bir rozet geri oynat.
Düşük harcama yüzdesiyle yüksek etkileşim gösteren oyuncular.
  • Bonusları arkadaşlarını davet etmeye teşvik edecek şekilde uyarlayın Oyununuzu yükleyip katılın. Bu yaklaşım, oyuncunun yeni oyuncular kazanmak için oyundan keyif aldığını göstermiştir.
Zirveye ulaşıp başlamaya dair belirtiler gösteren, yüksek harcama yapan oyuncular oynamasını beklemeyin.
  • Bonuslar, ilgilerini çekecek şekilde uyarlayın. Örneğin: kısa süreli araçlar, silahlar veya daha fazlası daha fazla bilgi edineceksiniz.
  • Oynatıcı bir dahaki sefere oturum açtığında kullanıcıyı yönlendiren bir video gösterir klan saldırıları gibi topluluk özelliklerine daha sık ve daha uzun etkileşim sağlar.
Harcama olasılığı çok yüksek veya çok düşük olan oyuncular.
  • Harcama olasılığı düşük: Reklam izleme seçeneği sunun videosunu izleyin. Satılacak daha düşük fiyatlı ürünleri göster.
  • Harcama olasılığı yüksek: Onları erkenden oyun içi mağazaya yönlendirin. ve onları satın almaya teşvik etmek için özel promosyonlar sunabilir.