प्लेयर के आंकड़े वाले एपीआई से, गेम के खास सेगमेंट के हिसाब से गेम का अनुभव बेहतर बनाया जा सकता है खिलाड़ियों और उनके लाइफ़साइकल के अलग-अलग स्टेज दिखाए जाते हैं. अपनी ऑडियंस के हिसाब से, हर खिलाड़ी सेगमेंट के लिए अनुभव, जो इस बात पर आधारित होता है कि खिलाड़ी कैसे आगे बढ़ रहे हैं, कैसे खर्च कर रहे हैं, और दिलचस्प होने चाहिए. उदाहरण के लिए, अपने-आप काम करने वाली कार्रवाइयों के लिए, इस एपीआई का इस्तेमाल किया जा सकता है कम सक्रिय रहने वाले खिलाड़ी को आपके गेम से फिर से जुड़ने के लिए प्रोत्साहित करें, जैसे कि खिलाड़ी के साइन इन करने पर नए इन-गेम आइटम दिखाना और उनका प्रमोशन करना.
इस गाइड में बताया गया है कि
Google Play की गेम सेवाएं. ये एपीआई यहां
com.google.android.gms.games.stats
और com.google.android.gms.games पैकेज.
शुरू करने से पहले
प्लेयर आंकड़े एपीआई का इस्तेमाल शुरू करने से पहले:
- Google News ऐप्लिकेशन को डाउनलोड करें और कोड सैंपल.
- यहां दिए गए सुझावों के बारे में जानें क्वालिटी चेकलिस्ट.
खिलाड़ी के आंकड़ों वाला क्लाइंट लोड किया जा रहा है
प्लेयर आंकड़े एपीआई का इस्तेमाल शुरू करने के लिए, पहले आपके गेम को
PlayerStatsClient ऑब्जेक्ट. ऐसा करने के लिए,
Games.getPlayerStatsClient() तरीका इस्तेमाल किया और इस प्रक्रिया में पास किया जा रहा है:
गतिविधि.
खिलाड़ी के आंकड़ों की बुनियादी बातें
किसी खिलाड़ी के इन-गेम का डेटा पाने के लिए, प्लेयर के आंकड़े वाले एपीआई का इस्तेमाल किया जा सकता है गतिविधि. खिलाड़ी से जुड़ा जो डेटा वापस पाया जा सकता है उसमें ये शामिल हैं:
सेशन औसतन कितनी देर चला: इतने समय तक खिलाड़ी का औसत सेशन मिनट. सेशन की अवधि, खिलाड़ी के साइन इन रहने के समय से तय होती है Google Play की गेम सेवाएं.
पिछली बार खेले जाने के बाद के दिन: खिलाड़ी से लेकर अब तक के अनुमानित दिनों की संख्या पिछली बार चलाया गया.
खरीदारी की संख्या: प्लेयर.
सेशन की संख्या: खिलाड़ी के सेशन की अनुमानित संख्या. सेशन इस आधार पर तय होते हैं कि कोई खिलाड़ी कितनी बार साइन इन करता है Google Play की गेम सेवाएं.
सेशन पर्सेंटाइल: प्लेयर, जो 0 से 1 के बीच के दशमलव मान के रूप में दिया जाता है. इस वैल्यू से पता चलता है कि कितने इस गेम के बाकी खिलाड़ी की तुलना में मौजूदा खिलाड़ी ने जो सेशन खेले हैं बेस. ज़्यादा सेशन का मतलब है कि इस खिलाड़ी ने ज़्यादा सेशन खेले हैं.
खर्च का पर्सेंटाइल: खिलाड़ी के खर्च का अनुमानित पर्सेंटाइल, दिया गया 0 से 1 के बीच की दशमलव वैल्यू डालें. इस वैल्यू से पता चलता है कि मौजूदा खिलाड़ी ने इस गेम के बाकी खिलाड़ी की तुलना में खर्च किया है बेस. ज़्यादा स्कोर का मतलब है कि इस खिलाड़ी ने ज़्यादा खर्च किया है.
इस तरह का प्लेयर डेटा अब काम नहीं करता. साथ ही, यह हमेशा सेट नहीं करता है मान स्थिर:
- चर्न आउट की संभावना: यह अनुमान कि कोई खिलाड़ी चर्न आउट करेगा या नहीं अगले दिन में, 0 के बीच के दशमलव मान के रूप में दिया गया है (इसकी कम संभावना है चर्न आउट) से 1 (चर्न आउट की संभावना ज़्यादा) तक. चर्न आउट की परिभाषा 7 दिन में कोई गतिविधि नहीं होगी.
- खर्च की संभावना: खिलाड़ी की अनुमानित संभावना इस गेम में खर्च करने का विकल्प चुना गया है. दशमलव वाली वैल्यू 0 (कम खर्च की संभावना) से 1 (खर्च की ज़्यादा संभावना) तक.
- अगले 28 दिनों में होने वाला कुल खर्च: खिलाड़ी का अनुमानित कुल खर्च इस गेम में अगले 28 दिनों तक का समय खर्च करेंगे.
- ज़्यादा खर्च करने की संभावना: इस बात की अनुमानित संभावना कि अगले 28 दिनों में कोई खिलाड़ी ऐसी रकम खर्च करेगा जो 95वें इस गेम के खिलाड़ी आधार का प्रतिशत या उससे ज़्यादा. इसे दशमलव के रूप में दिया गया है 0 (ज़्यादा खर्च करने की संभावना कम है) से 1 (ज़्यादा) के बीच की वैल्यू ज़्यादा खर्च करने की संभावना.
खिलाड़ी के आंकड़ों का डेटा वापस लाया जा रहा है
आपने अभी जिस प्लेयर में साइन इन किया हुआ है उसके आंकड़े का डेटा वापस पाने के लिए, यह तरीका अपनाएं कदम:
PlayerStatsClient.loadPlayerStats()तरीके को कॉल करें.- कॉल पूरा होने पर, Google Play की गेम सेवाएं,
Taskऑब्जेक्ट जो एसिंक्रोनस रूप सेPlayerStatsऑब्जेक्ट लोड करता है. इसके बारे में डेटा पुनर्प्राप्त करने के लिए इस ऑब्जेक्ट की विधियों का उपयोग करें आपके ऐप्लिकेशन में साइन-इन किए हुए खिलाड़ी की गतिविधियां.
यहां एक उदाहरण दिया गया है:
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());
}
}
});
}
खिलाड़ी के आंकड़ों से जुड़े डेटा को इस्तेमाल करने के बारे में सलाह
Play आंकड़े API से आपको अलग-अलग तरह के खिलाड़ियों की पहचान करने में मदद मिलती है. ये खिलाड़ी और सही रणनीतियां लागू कर सकें, ताकि उनके गेम अनुभव को बेहतर बनाना.
यहां दी गई टेबल में, प्लेयर सेगमेंट के कुछ उदाहरण और सुझाए गए उपयोगकर्ताओं की दिलचस्पी बढ़ाने से जुड़ी रणनीतियां:
| खिलाड़ी सेगमेंट | दर्शकों की दिलचस्पी बढ़ाने की रणनीति |
|---|---|
| बहुत ज़्यादा सेशन और अच्छे खर्च वाले खिलाड़ी लेकिन पिछले हफ़्ते या उससे ज़्यादा समय से नहीं चलाया जा सका. |
|
| कम खर्च वाले पर्सेंटाइल में ज़्यादा दिलचस्पी रखने वाले खिलाड़ी. |
|
| ज़्यादा खर्च करने वाले खिलाड़ियों का कहना है कि वे अपने लक्ष्यों के हिसाब से सबसे ज़्यादा खर्च कर रहे हैं और फिर शुरुआत कर रहे हैं कम बार प्ले करने के लिए. |
|
| ऐसे खिलाड़ी जिनके खर्च करने की संभावना बहुत ज़्यादा या बहुत कम है. |
|