Android गेम के लिए खिलाड़ी के आंकड़े

इस गाइड में, Google Play की गेम सेवाओं के लिए, प्लेयर के आंकड़ों से जुड़े एपीआई का इस्तेमाल करने का तरीका बताया गया है. खिलाड़ी के गेम में की गई गतिविधि का डेटा पाने के लिए, प्लेयर स्टैटिस्टिक्स API का इस्तेमाल किया जा सकता है.

खिलाड़ी के आंकड़ों से जुड़े एपीआई की मदद से, खिलाड़ियों के अलग-अलग सेगमेंट और उनकी लाइफ़साइकल के अलग-अलग चरणों के हिसाब से, गेम के अनुभव को बेहतर बनाया जा सकता है. खिलाड़ियों की प्रोग्रेस, खर्च, और दिलचस्पी के आधार पर, हर खिलाड़ी सेगमेंट के लिए खास अनुभव बनाए जा सकते हैं. उदाहरण के लिए, इस एपीआई का इस्तेमाल करके, कम सक्रिय खिलाड़ी को अपने गेम से फिर से जुड़ने के लिए प्रोत्साहित किया जा सकता है. जैसे, जब खिलाड़ी साइन इन करे, तब उसे गेम में मौजूद नई चीज़ें दिखाई जा सकती हैं और उनका प्रमोशन किया जा सकता है.

ये एपीआई, com.google.android.gms.games.stats और com.google.android.gms.games पैकेज में उपलब्ध हैं.

शुरू करने से पहले

Player Stats API का इस्तेमाल शुरू करने से पहले:

• कोड सैंपल डाउनलोड करें और उसकी समीक्षा करें.
• क्वालिटी चेकलिस्ट में बताए गए सुझावों के बारे में जानें.

खिलाड़ी के आंकड़ों का क्लाइंट पाएं

Player Stats API का इस्तेमाल शुरू करने के लिए, आपके गेम को सबसे पहले PlayerStatsClient ऑब्जेक्ट पाना होगा. इसके लिए, PlayerStatsClient.getPlayersClient() तरीके को कॉल करें और गतिविधि को पास करें.

PlayerStatsClient क्लास, Google Play services Task क्लास का इस्तेमाल करके, नतीजे एसिंक्रोनस तरीके से दिखाती है. थ्रेड किए गए काम को मैनेज करने के लिए, टास्क का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, Tasks API डेवलपर गाइड देखें.

खिलाड़ी के आंकड़ों के बारे में बुनियादी जानकारी

खिलाड़ी के गेम में की गई गतिविधि का डेटा वापस पाने के लिए, प्लेयर स्टैटिस्टिक्स एपीआई का इस्तेमाल किया जा सकता है. खिलाड़ी के इस तरह के डेटा को वापस पाया जा सकता है:

• सेशन की औसत अवधि: यह खिलाड़ी के सेशन की औसत अवधि को मिनटों में दिखाती है. सेशन की अवधि इस बात से तय होती है कि कोई खिलाड़ी, Google Play की गेम सेवाओं में कितने समय तक साइन इन रहता है.

• पिछली बार गेम खेलने के बाद से अब तक के दिन: इससे पता चलता है कि खिलाड़ी ने पिछली बार कब गेम खेला था.

• खरीदारी की संख्या: खिलाड़ी के लिए, इन-ऐप्लिकेशन खरीदारी की अनुमानित संख्या.

• सेशन की संख्या: प्लेयर के सेशन की अनुमानित संख्या. सेशन की संख्या इस बात से तय होती है कि कोई खिलाड़ी, Google Play की गेम सेवाओं में कितनी बार साइन इन करता है.

• सेशन पर्सेंटाइल: यह खिलाड़ी के सेशन पर्सेंटाइल का अनुमान है. इसे 0 से 1 के बीच की दशमलव वैल्यू के तौर पर दिखाया जाता है. इस वैल्यू से पता चलता है कि मौजूदा खिलाड़ी ने इस गेम के बाकी खिलाड़ियों की तुलना में कितने सेशन खेले हैं. ज़्यादा संख्या का मतलब है कि इस प्लेयर ने ज़्यादा सेशन खेले हैं.

• खर्च का पर्सेंटाइल: यह खिलाड़ी के खर्च का अनुमानित पर्सेंटाइल होता है. इसे 0 से 1 के बीच की दशमलव वैल्यू के तौर पर दिखाया जाता है. इस वैल्यू से पता चलता है कि मौजूदा खिलाड़ी ने इस गेम के अन्य खिलाड़ियों की तुलना में कितना खर्च किया है. ज़्यादा संख्या का मतलब है कि इस प्लेयर ने ज़्यादा खर्च किया है.

नीचे दिए गए प्लेयर डेटा के टाइप अब काम नहीं करते. ये हमेशा 'सेट नहीं की गई वैल्यू' कॉन्स्टेंट दिखाते हैं:

खिलाड़ी के आंकड़ों का डेटा पाना

साइन इन किए गए खिलाड़ी के लिए, खिलाड़ी के आंकड़ों का डेटा वापस पाने के लिए, यह तरीका अपनाएं:

1. PlayerStatsClient.loadPlayerStats() तरीके को कॉल करें.

2. अगर कॉल पूरा होता है, तो Google Play games services एक 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 Stats API की मदद से, खिलाड़ियों की दिलचस्पी और खर्च करने के तरीके के आधार पर, अलग-अलग तरह के खिलाड़ियों की पहचान की जा सकती है. साथ ही, उनके गेम खेलने के अनुभव को बेहतर बनाने के लिए सही रणनीतियां लागू की जा सकती हैं.

यहां दी गई टेबल में, प्लेयर सेगमेंट के कुछ उदाहरण और उनसे जुड़ने के लिए सुझाई गई रणनीतियां दी गई हैं: