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