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

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

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

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

ये एपीआई यहां com.google.android.gms.games.stats और com.google.android.gms.games पैकेज.

खिलाड़ी से जुड़ा जो डेटा वापस पाया जा सकता है उसमें ये शामिल हैं:

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

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

• खरीदारी की संख्या: प्लेयर.

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

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

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

इस तरह का प्लेयर डेटा अब काम नहीं करता. साथ ही, यह हमेशा सेट नहीं करता है मान स्थिर:

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

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

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

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

क्लाइंट पाएं

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

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

डेटा वापस पाएं

आपने अभी जिस प्लेयर में साइन इन किया हुआ है उसके आंकड़े का डेटा वापस पाने के लिए, यह तरीका अपनाएं चरण:

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

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

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

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