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

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

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

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

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

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

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

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

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

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

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

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