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

Google साइन-इन एपीआई के बंद होने के बाद, हम 2026 में Games v1 SDK को हटा रहे हैं. फ़रवरी 2025 के बाद, Google Play पर ऐसे गेम पब्लिश नहीं किए जा सकेंगे जो Games v1 SDK के साथ हाल ही में इंटिग्रेट किए गए हैं. हमारा सुझाव है कि आप इसके बजाय, Games v2 SDK का इस्तेमाल करें.
हालांकि, पिछले गेम के v1 के साथ इंटिग्रेट किए गए मौजूदा टाइटल, कुछ सालों तक काम करते रहेंगे. फिर भी हमारा सुझाव है कि आप जून 2025 से v2 पर माइग्रेट कर लें.
यह गाइड, Play की गेम सेवाओं के v1 एसडीके का इस्तेमाल करने के लिए है. एसडीके टूल के नए वर्शन के बारे में जानकारी पाने के लिए, v2 का दस्तावेज़ देखें.

अहम जानकारी: इस एपीआई के साथ किए गए एक्सपेरिमेंट के नतीजों के आधार पर, हमने इन एंडपॉइंट के लिए डेटा इकट्ठा करना बंद कर दिया है: चर्न की संभावना, खर्च की संभावना, अगले 28 दिनों में कुल खर्च, और ज़्यादा खर्च करने वाले उपयोगकर्ता की संभावना. इनमें से हर एंडपॉइंट, अब हमेशा 'सेट नहीं की गई वैल्यू' कॉन्सटेंट दिखाता है. यह वैल्यू, उस वैल्यू के बराबर होती है जिसका इस्तेमाल Player Stats सिस्टम यह बताने के लिए करता है कि किसी दिए गए एंडपॉइंट को कंप्यूट करने के लिए उसके पास ज़रूरत के मुताबिक डेटा नहीं है.

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

इस गाइड में, Google Play की गेम सेवाओं का इस्तेमाल करके, गेम में खिलाड़ी के आंकड़ों वाले एपीआई का इस्तेमाल करने का तरीका बताया गया है. इन एपीआई को com.google.android.gms.games.stats और com.google.android.gms.games पैकेज में देखा जा सकता है.

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

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

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

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

खिलाड़ी के आंकड़ों से जुड़े एपीआई का इस्तेमाल शुरू करने के लिए, आपके गेम को सबसे पहले PlayerStatsClient ऑब्जेक्ट पाना होगा. इसके लिए, Games.getPlayerStatsClient() तरीके का इस्तेमाल करें और मौजूदा खिलाड़ी की गतिविधि और GoogleSignInAccount से जुड़ी जानकारी उपलब्ध कराएं. खिलाड़ी के खाते की जानकारी वापस पाने का तरीका जानने के लिए, Android गेम में साइन-इन करना लेख पढ़ें.

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

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

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

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

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

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

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

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

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

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

• ऐप्लिकेशन छोड़ने की संभावना: यह अनुमान लगाया जाता है कि कोई खिलाड़ी अगले दिन ऐप्लिकेशन छोड़ देगा या नहीं. इसे 0 से 1 के बीच की डेसिमल वैल्यू के तौर पर दिखाया जाता है. 0 का मतलब है कि ऐप्लिकेशन छोड़ने की संभावना कम है और 1 का मतलब है कि ऐप्लिकेशन छोड़ने की संभावना ज़्यादा है. सात दिनों तक कोई गतिविधि न होने को चर्न कहा जाता है.
• खर्च करने की संभावना: इससे यह पता चलता है कि किसी खिलाड़ी के इस गेम में खर्च करने की संभावना कितनी है. इसे 0 से 1 के बीच की दशमलव वैल्यू के तौर पर दिखाया जाता है. 0 का मतलब है कि खर्च करने की संभावना कम है और 1 का मतलब है कि खर्च करने की संभावना ज़्यादा है.
• अगले 28 दिनों में कुल खर्च: इस गेम में अगले 28 दिनों में, खिलाड़ियों के अनुमानित कुल खर्च की जानकारी.
• ज़्यादा खर्च करने वाले व्यक्ति की संभावना: इस बात की संभावना कि अगले 28 दिनों में कोई खिलाड़ी, इस गेम के 95वें पर्सेंटाइल या उससे ज़्यादा के बराबर खर्च करेगा. यह वैल्यू, दशमलव में दी जाती है. यह 0 (ज़्यादा खर्च करने वाला ग्राहक बनने की कम संभावना) से लेकर 1 (ज़्यादा खर्च करने वाला ग्राहक बनने की ज़्यादा संभावना) के बीच होती है.

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

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

1. PlayerStatsClient.loadPlayerStats() तरीके को कॉल करें.
2. अगर कॉल पूरा होता है, तो Google Play games services एक Task ऑब्जेक्ट दिखाती है. यह ऑब्जेक्ट, PlayerStats ऑब्जेक्ट को एसिंक्रोनस तरीके से लोड करता है. इस ऑब्जेक्ट के तरीकों का इस्तेमाल करके, साइन इन किए हुए प्लेयर की आपके ऐप्लिकेशन में की गई गतिविधियों का डेटा वापस पाएं.

यहां एक उदाहरण दिया गया है:

public void checkPlayerStats() {
  Games.getPlayerStatsClient(this, GoogleSignIn.getLastSignedInAccount(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 की मदद से, खिलाड़ियों की दिलचस्पी और खर्च करने के तरीके के आधार पर, अलग-अलग तरह के खिलाड़ियों की आसानी से पहचान की जा सकती है. साथ ही, उनके गेम के अनुभव को बेहतर बनाने के लिए सही रणनीतियां लागू की जा सकती हैं.

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

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