এই নির্দেশিকাটি আপনাকে Google Play Games Services-এর জন্য প্লেয়ার স্ট্যাটস API কীভাবে ব্যবহার করবেন তা দেখায়। আপনি প্লেয়ার স্ট্যাটস API ব্যবহার করে একজন খেলোয়াড়ের ইন-গেম কার্যকলাপ সম্পর্কে তথ্য পুনরুদ্ধার করতে পারেন।
প্লেয়ার স্ট্যাটস API আপনাকে খেলোয়াড়দের নির্দিষ্ট বিভাগ এবং খেলোয়াড়ের জীবনচক্রের বিভিন্ন পর্যায়ে গেমের অভিজ্ঞতা তৈরি করতে দেয়। খেলোয়াড়রা কীভাবে অগ্রগতি করছে, ব্যয় করছে এবং জড়িত হচ্ছে তার উপর ভিত্তি করে আপনি প্রতিটি খেলোয়াড় বিভাগের জন্য উপযুক্ত অভিজ্ঞতা তৈরি করতে পারেন। উদাহরণস্বরূপ, আপনি এই API ব্যবহার করে কম সক্রিয় খেলোয়াড়কে আপনার গেমের সাথে পুনরায় যুক্ত হতে উৎসাহিত করার জন্য সক্রিয় পদক্ষেপ নিতে পারেন, যেমন খেলোয়াড় প্রমাণীকরণের সময় নতুন ইন-গেম আইটেম প্রদর্শন এবং প্রচার করে।
API গুলি com.google.android.gms.games.stats এবং com.google.android.gms.games প্যাকেজগুলিতে পাওয়া যাবে।
শুরু করার আগে
প্লেয়ার স্ট্যাটস এপিআই ব্যবহার শুরু করার আগে:
- কোড নমুনাটি ডাউনলোড করুন এবং পর্যালোচনা করুন।
- গুণমান চেকলিস্টে বর্ণিত সুপারিশগুলির সাথে নিজেকে পরিচিত করুন।
প্লেয়ার স্ট্যাটাস ক্লায়েন্ট পান
প্লেয়ার স্ট্যাটস API ব্যবহার শুরু করতে, আপনার গেমটিকে প্রথমে একটি PlayerStatsClient অবজেক্ট পেতে হবে। আপনি PlayerStatsClient.getPlayersClient() পদ্ধতিতে কল করে এবং কার্যকলাপটি পাস করে এটি করতে পারেন।
PlayerStatsClient ক্লাসটি Google Play পরিষেবা Task ক্লাস ব্যবহার করে ফলাফল অ্যাসিঙ্ক্রোনাসভাবে ফেরত পাঠায়। থ্রেডেড কাজ পরিচালনা করার জন্য টাস্ক ব্যবহার সম্পর্কে আরও জানতে, Tasks API ডেভেলপার গাইড দেখুন।
খেলোয়াড় পরিসংখ্যানের মূল বিষয়গুলি
আপনি খেলোয়াড়ের ইন-গেম কার্যকলাপ সম্পর্কে ডেটা পুনরুদ্ধার করতে প্লেয়ার স্ট্যাটস API ব্যবহার করতে পারেন। আপনি যে ধরণের খেলোয়াড়ের ডেটা পুনরুদ্ধার করতে পারেন তার মধ্যে রয়েছে:
গড় সেশনের দৈর্ঘ্য : মিনিটে খেলোয়াড়ের গড় সেশনের দৈর্ঘ্য। গুগল প্লে গেমস পরিষেবা দ্বারা একজন খেলোয়াড়ের প্রমাণীকরণের সময় দ্বারা সেশনের দৈর্ঘ্য নির্ধারিত হয়।
শেষ খেলার পর থেকে দিন : খেলোয়াড় শেষ খেলার পর থেকে আনুমানিক দিনের সংখ্যা।
ক্রয়ের সংখ্যা : খেলোয়াড়ের জন্য অ্যাপ-মধ্যস্থ ক্রয়ের আনুমানিক সংখ্যা।
সেশনের সংখ্যা : খেলোয়াড়ের আনুমানিক সেশনের সংখ্যা। গুগল প্লে গেমস পরিষেবা দ্বারা একজন খেলোয়াড় কতবার প্রমাণীকরণ করেছেন তার উপর নির্ভর করে সেশনগুলি নির্ধারিত হয়।
সেশন পার্সেন্টাইল : খেলোয়াড়ের জন্য সেশন পার্সেন্টাইলের আনুমানিক মান, যা 0 থেকে 1 এর মধ্যে দশমিক মান হিসাবে দেওয়া হয়। এই মানটি নির্দেশ করে যে বর্তমান খেলোয়াড় এই গেমের বাকি খেলোয়াড় বেসের তুলনায় কতগুলি সেশন খেলেছে। বেশি সংখ্যা নির্দেশ করে যে এই খেলোয়াড় আরও বেশি সেশন খেলেছে।
ব্যয়ের শতকরা হার : খেলোয়াড়ের আনুমানিক ব্যয়ের শতকরা হার, যা ০ থেকে ১ এর মধ্যে দশমিক মান হিসেবে দেওয়া হয়। এই মানটি নির্দেশ করে যে বর্তমান খেলোয়াড় এই খেলার বাকি খেলোয়াড়দের তুলনায় কত খরচ করেছে। বেশি সংখ্যা নির্দেশ করে যে এই খেলোয়াড় বেশি খরচ করেছে।
নিম্নলিখিত ধরণের প্লেয়ার ডেটা অবচিত হয় এবং সর্বদা একটি অনির্ধারিত মান ধ্রুবক প্রদান করে:
- মন্থন সম্ভাবনা : একজন খেলোয়াড় পরের দিন মন্থন করবে কিনা তার পূর্বাভাস, 0 (মন্থনের কম সম্ভাবনা) থেকে 1 (মন্থনের উচ্চ সম্ভাবনা) সহ দশমিক মান হিসাবে দেওয়া হয়। মন্থনকে 7 দিনের নিষ্ক্রিয়তা হিসাবে সংজ্ঞায়িত করা হয়।
- ব্যয়ের সম্ভাবনা : এই খেলায় খেলোয়াড়ের ব্যয় করার আনুমানিক সম্ভাবনা, যা 0 (ব্যয় করার কম সম্ভাবনা) থেকে 1 (ব্যয় করার উচ্চ সম্ভাবনা) সহ দশমিক মান হিসাবে দেওয়া হয়।
- পরবর্তী ২৮ দিনে মোট খরচ : এই গেমটিতে পরবর্তী ২৮ দিনে খেলোয়াড়ের আনুমানিক মোট প্রত্যাশিত ব্যয়।
- উচ্চ ব্যয়কারীর সম্ভাবনা : পরবর্তী ২৮ দিনে একজন খেলোয়াড়ের এই খেলার খেলোয়াড় বেসের ৯৫তম শতাংশ বা তার বেশি পরিমাণ ব্যয় করার আনুমানিক সম্ভাবনা। এটি ০ (উচ্চ ব্যয়কারী হওয়ার কম সম্ভাবনা) থেকে ১ (উচ্চ ব্যয়কারী হওয়ার উচ্চ সম্ভাবনা) এর মধ্যে দশমিক মান হিসাবে দেওয়া হয়।
খেলোয়াড়ের পরিসংখ্যানের তথ্য পুনরুদ্ধার করুন
প্রমাণিত খেলোয়াড়ের জন্য খেলোয়াড়ের পরিসংখ্যান তথ্য পুনরুদ্ধার করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
PlayerStatsClient.loadPlayerStats()পদ্ধতিটি কল করুন।যদি কলটি সফল হয়, তাহলে 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()); } } }); }
খেলোয়াড়ের পরিসংখ্যান ডেটা ব্যবহারের জন্য টিপস
প্লে স্ট্যাটস এপিআই আপনাকে বিভিন্ন ধরণের খেলোয়াড়দের তাদের ব্যস্ততা এবং ব্যয়ের আচরণের উপর ভিত্তি করে সনাক্ত করতে এবং তাদের খেলার অভিজ্ঞতা উন্নত করার জন্য উপযুক্ত কৌশল প্রয়োগ করতে দেয়।
নিম্নলিখিত সারণীতে কিছু উদাহরণ প্লেয়ার সেগমেন্ট এবং প্রস্তাবিত এনগেজমেন্ট কৌশল তালিকাভুক্ত করা হয়েছে:
| খেলোয়াড়ের অংশ | সম্পৃক্ততা কৌশল |
|---|---|
| যারা ঘন ঘন খেলেন এবং প্রচুর সেশন খেলেন এবং ভালো খরচ করেন, কিন্তু গত সপ্তাহ বা তার বেশি সময় ধরে খেলেননি। |
|
| কম খরচের শতাংশে অত্যন্ত নিযুক্ত খেলোয়াড়। |
|
| উচ্চ ব্যয়ের খেলোয়াড়রা শীর্ষে ওঠার এবং কম ঘন ঘন খেলা শুরু করার লক্ষণ দেখাচ্ছে। |
|
| খুব বেশি বা খুব কম খরচের সম্ভাবনা সহ খেলোয়াড়। |
|