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:
- Şu dosyayı indirin ve inceleyin: kod örneği.
- Şu bölümünde açıklanan öneriler hakkında bilgi edinin: Kalite Kontrol Listesi.
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:
Şunu çağırın:
PlayerStatsClient.loadPlayerStats()
yöntemidir.Arama başarılı olursa Google Play Games Hizmetleri bir
Task
eşzamansız olarak yükleyen nesnePlayerStats
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ış. |
|
Düşük harcama yüzdesiyle yüksek etkileşim gösteren oyuncular. |
|
Zirveye ulaşıp başlamaya dair belirtiler gösteren, yüksek harcama yapan oyuncular oynamasını beklemeyin. |
|
Harcama olasılığı çok yüksek veya çok düşük olan oyuncular. |
|