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

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

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

एपीआई, com.google.android.gms.games.stats और com.google.android.gms.games पैकेज में मिल सकते हैं.

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

प्लेयर के आंकड़े दिखाने वाले एपीआई का इस्तेमाल शुरू करने से पहले:

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

खिलाड़ी के आंकड़े देखने वाला क्लाइंट पाना

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

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

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

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

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

• पिछली बार गेम खेले जाने के बाद से बीत चुके दिन: खिलाड़ी ने पिछली बार गेम कब खेला था, यह अनुमानित संख्या.

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

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

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

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