গেমের পরিসংখ্যান একীভূত করুন

এই ডকুমেন্টটিতে গুগল প্লে কনসোল ব্যবহার করে আপনার গেমে গেম স্ট্যাটস কীভাবে যুক্ত করবেন তা ব্যাখ্যা করা হয়েছে। এতে প্রয়োজনীয় CSV এবং ZIP ফাইল ফরম্যাটগুলো অন্তর্ভুক্ত রয়েছে এবং সেগুলো কীভাবে তৈরি, ইম্পোর্ট ও পরিচালনা করতে হয় তা বর্ণনা করা হয়েছে।

ইভেন্ট তৈরি বা আমদানি করুন

গুগল প্লে কনসোল ব্যবহার করে প্রথমবারের মতো ইভেন্ট যোগ করার দুটি উপায় রয়েছে:

• ইভেন্ট তৈরি করুন : একবারে একটি ইভেন্ট যোগ করুন।
• ইভেন্ট ইম্পোর্ট করুন : একাধিক ইভেন্ট ইম্পোর্ট করুন।

একটি ইভেন্ট তৈরি করুন

গেমের জন্য একটি ইভেন্ট তৈরি করতে, এই ধাপগুলো সম্পন্ন করুন:

1. গুগল প্লে কনসোলে একটি গেম নির্বাচন করুন।
2. প্লে গেমস সার্ভিসেস - গেম স্ট্যাটস পেজে ( গ্রো ইউজার্স > প্লে গেমস সার্ভিসেস > সেটআপ অ্যান্ড ম্যানেজমেন্ট > গেম স্ট্যাটস ), অ্যাড অ্যান ইভেন্ট > ক্রিয়েট অ্যান ইভেন্ট নির্বাচন করুন।
3. ইভেন্ট তৈরি করার পেজে ফর্মটি পূরণ করুন।
4. পরিবর্তনগুলি সংরক্ষণ করুন -এ ক্লিক করুন।

গুরুত্বপূর্ণ ঘটনা

আপনার গেমে একসাথে একাধিক ইভেন্ট যোগ করতে, নিম্নলিখিত ধাপগুলো অনুসরণ করুন:

1. PlayerGameEvent.csv নামের ইভেন্ট CSV ফাইলটি তৈরি করুন।
2. গুগল প্লে কনসোলে একটি গেম নির্বাচন করুন।
3. প্লে গেমস সার্ভিসেস - গেম স্ট্যাটস পেজে ( গ্রো ইউজার্স > প্লে গেমস সার্ভিসেস > সেটআপ অ্যান্ড ম্যানেজমেন্ট > গেম স্ট্যাটস ), অ্যাড অ্যান ইভেন্ট > ইমপোর্ট ভায়া CSV নির্বাচন করুন।
4. ইভেন্ট কনফিগারেশন পেজে, আপলোড করার জন্য CSV ফাইলটি ড্রপ করুন।
5. ইভেন্ট তৈরি করার পর, পরিসংখ্যান সেট আপ করুন ।

পরিসংখ্যান তৈরি বা আমদানি করুন

গুগল প্লে কনসোল ব্যবহার করে প্রথমবারের মতো পরিসংখ্যান যোগ করার দুটি উপায় রয়েছে:

• একটি স্ট্যাট তৈরি করুন : একবারে একটি স্ট্যাট যোগ করুন।
• পরিসংখ্যান আমদানি করুন : একাধিক পরিসংখ্যান আমদানি করুন।

একটি পরিসংখ্যান তৈরি করুন

একটি গেমের জন্য পরিসংখ্যান তৈরি করতে, এই ধাপগুলো সম্পন্ন করুন:

1. গুগল প্লে কনসোলে একটি গেম নির্বাচন করুন।
2. প্লে গেমস সার্ভিসেস - গেম স্ট্যাটস পেজে ( গ্রো ইউজার্স > প্লে গেমস সার্ভিসেস > সেটআপ অ্যান্ড ম্যানেজমেন্ট > গেম স্ট্যাটস ), অ্যাড আ স্ট্যাট > ক্রিয়েট আ স্ট্যাট নির্বাচন করুন।
3. 'Create a stat ' পেজে ফর্মটি পূরণ করুন।
4. পরিবর্তনগুলি সংরক্ষণ করুন -এ ক্লিক করুন।
5. পরিসংখ্যান তৈরি করার পর আপনার গেমটি প্রকাশ করুন।

আমদানি পরিসংখ্যান

পরিসংখ্যান আমদানি করতে, এই ধাপগুলো অনুসরণ করুন:

1. পরিসংখ্যানের জন্য নির্ধারিত জিপ ফাইল নির্দেশিকা অনুসারে পরিসংখ্যান, স্থানীয়করণ এবং আইকন ফাইল সম্বলিত জিপ ফাইলটি তৈরি করুন।
2. গুগল প্লে কনসোলে একটি গেম নির্বাচন করুন।
3. প্লে গেমস সার্ভিসেস - গেম স্ট্যাটস পেজে ( গ্রো ইউজার্স > প্লে গেমস সার্ভিসেস > সেটআপ অ্যান্ড ম্যানেজমেন্ট > গেম স্ট্যাটস ), অ্যাড আ স্ট্যাট > ইমপোর্ট ভায়া জিপ সিলেক্ট করুন।
4. গেম স্ট্যাটস কনফিগারেশন পেজে, আপলোড করার জন্য ZIP ফাইলটি ড্রপ করুন।
5. সমস্ত পরিসংখ্যান আপলোড করার পর আপনার গেমটি প্রকাশ করুন।

টেস্ট গেমের পরিসংখ্যান

গেম স্ট্যাটসগুলো উদ্দেশ্য অনুযায়ী কাজ করছে কিনা তা যাচাই করতে, নিম্নলিখিত ধাপগুলো অনুসরণ করে পরীক্ষা করুন:

• প্লে কনসোলে একটি অভ্যন্তরীণ টেস্ট ট্র্যাক তৈরি করুন।
• পরীক্ষকদের জন্য আপনার গেম প্রজেক্টে টেস্ট অ্যাকাউন্ট যোগ করুন ।
• প্লে গেমস অ্যাপ ব্যবহার করে একটি টেস্ট অ্যাকাউন্টের জন্য প্লে গেমস সার্ভিসেস প্রোফাইল তৈরি করুন।
• যে টেস্ট অ্যাকাউন্টটি দিয়ে আপনি প্লে গেমস সার্ভিসেস প্রোফাইল তৈরি করেছিলেন, সেই একই অ্যাকাউন্ট ব্যবহার করে গেমটি খুলুন।
• গেম চালু করার সময় সফল স্বয়ংক্রিয় প্রমাণীকরণের নিশ্চিতকরণ হিসেবে স্ক্রিনে প্লে গেমস সার্ভিসেস-এর "ওয়েলকাম টোস্ট" দেখানো হচ্ছে কিনা, তা যাচাই করুন।
• টেস্ট অ্যাকাউন্টের ব্যবহারকারী ইভেন্টগুলো ট্রিগার করার জন্য গেমটি খেলতে পারেন। ইভেন্টগুলো রেকর্ড হয়েছে কিনা তা জানতে এপিআই রেসপন্সটি চেক করুন।

পরীক্ষার জন্য আপনার ডিভাইসে গেমের পরিসংখ্যান দেখার সুবিধা পরিচালনা করুন।

প্লে কনসোলে আপনার পরীক্ষকদের জন্য গেমটি উপলব্ধ হয়ে গেলে, আপনার ডিভাইসে গেমের পরিসংখ্যান দেখতে এই ধাপগুলো অনুসরণ করুন:

1. গুগল প্লে স্টোরের ক্যাশে পরিষ্কার করুন:

   1. আপনার ডিভাইসে সেটিংস অ্যাপটি খুলুন।
   2. অ্যাপস > গুগল প্লে স্টোর-এ ট্যাপ করুন।
   3. স্টোরেজ এবং ক্যাশে ট্যাপ করুন, এবং তারপর ক্লিয়ার ক্যাশে ট্যাপ করুন।

2. গুগল প্লে স্টোর অ্যাপটি খুলুন।

3. আপনার খেলার সময় ট্র্যাক করুন বিভাগ অথবা আপনার গেমার প্রোফাইল ব্যবহার করে আপনার গেমের পরিসংখ্যান দেখুন:

পদ্ধতি ১: আপনার খেলার সময় ট্র্যাক করুন বিভাগটি ব্যবহার করুন

'আপনার খেলার সময় ট্র্যাক করুন' বিভাগে যান এবং তারপরে আপনার গেমের পরিসংখ্যান দেখতে এটিতে ট্যাপ করুন।

পদ্ধতি ২: আপনার গেমার প্রোফাইল ব্যবহার করুন

1. 'You' ট্যাবে ট্যাপ করুন, এবং তারপর আপনার গেমার প্রোফাইলে ট্যাপ করুন।
2. গেম স্ট্যাটস বিভাগে যান।
3. সময়সীমার জন্য, ‘সব’ নির্বাচন করুন।
4. আপনার গেমটি দেখা না গেলে, ‘সব গেম দেখুন’ -এ ট্যাপ করুন।
5. আপনার গেমটির পরিসংখ্যান দেখতে সেটি নির্বাচন করুন।

আপনার ডিভাইসে লগগুলি দেখুন

গেম স্ট্যাটস পরিকল্পিতভাবে কাজ করছে কিনা তা যাচাই করতে, আপনার ডিভাইসে লগ চালু করুন:

1. আপনার ডিভাইসে adb ডিবাগিং চালু করুন এবং টার্মিনালে নিম্নলিখিত কমান্ডগুলো চালান:

   adb shell setprop log.tag.Games INFO
   adb logcat -s "PlayGamesServices[GameStatsAgent]:I"

2. নিম্নলিখিত উদাহরণে দেখানো অনুযায়ী, একটি সফল লগ বার্তা প্রদর্শিত হচ্ছে কিনা তা যাচাই করুন:

   Successfully uploaded batch of X events.
   

   দ্রষ্টব্য: যেহেতু এপিআই আংশিক আপলোড সমর্থন করে, তাই এই তথ্য লগটি নির্দেশ করে যে ব্যাচটি প্রক্রিয়াজাত করা হয়েছে। যদি ব্যাচের অন্তর্ভুক্ত কোনো স্বতন্ত্র ইভেন্ট স্কিমা যাচাইকরণে ব্যর্থ হয়, তাহলে এই বার্তার আগে একটি ত্রুটি লগ প্রদর্শিত হবে।

3. জমা দেওয়া কোনো ইভেন্ট যাচাইকরণে ব্যর্থ হলে, আপনি ব্যর্থতার বিবরণসহ একটি ত্রুটি বার্তা দেখতে পাবেন:

   BatchRecordEvents validation failed for X event(s): ...
   

খেলার পরিসংখ্যান প্রকাশ করুন

টেস্টিং শেষ করার পর, আপনাকে অবশ্যই আপনার গেমটি পাবলিশ করতে হবে। এর সাথেই আপনার গেমের সমস্ত ইভেন্ট এবং স্ট্যাটস পাবলিশ হয়ে যায়।

প্রকাশ করতে, এই ধাপগুলো অনুসরণ করুন:

1. গুগল প্লে কনসোলে একটি গেম নির্বাচন করুন।
2. Play Games Services - Game Stats পেজে ( Grow users > Play Games Services > Setup and management > Game Stats ), Review and publish -এ ক্লিক করুন।
3. প্লে গেমস সার্ভিসেস - পাবলিশিং পেজে ( Grow users > Play Games Services > Setup and management > Publishing ), অ্যাকশনগুলো পর্যালোচনা করুন এবং সমস্যাগুলো সমাধান করুন।
4. পাবলিশ-এ ক্লিক করুন। আপনার গেমের সমস্ত পরিসংখ্যান প্রকাশিত হয়ে যাবে।

গেমের পরিসংখ্যান সম্পাদনা করুন

আপনার কাছে যদি আগে থেকেই গেমের পরিসংখ্যান থাকে এবং আপনি তা সম্পাদনা করতে চান:

1. গুগল প্লে কনসোলে একটি গেম নির্বাচন করুন।
2. প্লে গেমস সার্ভিসেস - গেম স্ট্যাটস পৃষ্ঠায় যান ( ব্যবহারকারী বৃদ্ধি > প্লে গেমস সার্ভিসেস > সেটআপ এবং ব্যবস্থাপনা > গেম স্ট্যাটস )।
3. একটি ইভেন্ট সম্পাদনা করতে:
   1. ইভেন্ট কনফিগারেশন বিভাগে, একটি ইভেন্ট নির্বাচন করুন।
   2. আপনি ইভেন্টের বৈশিষ্ট্যগুলো যোগ বা মুছে ফেলতে পারেন।
      • আপনি ইভেন্টের নাম সম্পাদনা করতে পারবেন না।
   3. পরিবর্তনগুলি সংরক্ষণ করুন -এ ক্লিক করুন।
4. একটি পরিসংখ্যান সম্পাদনা করতে:
   1. গেম স্ট্যাটস কনফিগারেশন সেকশনে, একটি স্ট্যাট নির্বাচন করুন।
   2. আপনি Stat name , Stat description এবং Icon file name ফিল্ডগুলো সম্পাদনা করতে পারেন।
      • আপনি Stat ID , Progression direction , Stat unit এবং Associated event details সম্পাদনা করতে পারবেন না।
   3. পরিবর্তনগুলি সংরক্ষণ করুন -এ ক্লিক করুন।
5. প্লে গেমস সার্ভিসেস - গেম স্ট্যাটস পেজে, সম্পাদিত স্ট্যাটটি 'পরীক্ষাকারীদের জন্য উপলব্ধ ' স্ট্যাটাসে রয়েছে।
6. পরিসংখ্যানটি পরীক্ষা করার পর, 'রিভিউ এবং পাবলিশ' এ ক্লিক করুন। এটি আপনার সমস্ত আপডেট করা পরিসংখ্যান সহ আপনার গেমটি পুনরায় প্রকাশ করবে।

গেমের পরিসংখ্যান মুছে ফেলুন

গেমের পরিসংখ্যান একবার প্রকাশিত হয়ে গেলে তা আর মুছে ফেলা যায় না।

আপনি 'পরীক্ষকদের জন্য উপলব্ধ ' স্ট্যাটাসে থাকা কোনো ইভেন্ট বা স্ট্যাট মুছে ফেলতে পারেন।

1. গুগল প্লে কনসোলে একটি গেম নির্বাচন করুন।
2. প্লে গেমস সার্ভিসেস - গেম স্ট্যাটস পৃষ্ঠায় যান ( ব্যবহারকারী বৃদ্ধি > প্লে গেমস সার্ভিসেস > সেটআপ এবং ব্যবস্থাপনা > গেম স্ট্যাটস )।
3. একটি ইভেন্ট মুছে ফেলতে:
   1. ইভেন্ট কনফিগারেশন বিভাগে, একটি ইভেন্ট নির্বাচন করুন।
   2. ডিলিট ইভেন্টে ক্লিক করুন।
4. একটি পরিসংখ্যান মুছে ফেলতে:
   1. গেম স্ট্যাটস কনফিগারেশনে , আপনি যে স্ট্যাটটি মুছতে চান সেটি নির্বাচন করুন।
   2. গেমের পরিসংখ্যান মুছতে ক্লিক করুন।

ইভেন্টের জন্য CSV ফাইল নির্দেশিকা

CSV ফাইলের প্রথম সারিটি হলো হেডার সারি। আপনাকে অবশ্যই ইভেন্টস CSV ফাইল ব্যবহার করে ইভেন্টগুলো ইম্পোর্ট করতে হবে, যেমন, PlayerGameEvent.csv ।

PlayerGameEvent.csv ফরম্যাট

CSV ফাইলটিতে ঘোষিত ইভেন্ট এবং তার প্রোপার্টিগুলো কমা দ্বারা পৃথক করা মান হিসেবে নিম্নলিখিত ক্রমে রয়েছে:

 Event Name,Property Name,Property Type

আপনি যদি progressionStat এর জন্য progressUpdate ইভেন্টটি পাঠান, তাহলে এই ইভেন্টের জন্য একটি সারি যোগ করুন। এই ইভেন্টে অবশ্যই INT বা STRING টাইপের অন্তত একটি currentProgress প্রপার্টি থাকতে হবে, এবং এর সাথে আপনি পাঠাতে চান এমন অন্য যেকোনো প্রপার্টিও থাকতে হবে।

এই ক্ষেত্রগুলো নিম্নলিখিত সারণিতে বর্ণনা করা হয়েছে:

PlayerGameEvent.csv ফাইলের প্রয়োজনীয়তা:

• ফাইলটি সর্বোচ্চ ২০টি অনন্য ইভেন্টের নাম সমর্থন করে, এবং প্রতিটি ইভেন্টের জন্য সর্বোচ্চ ২০টি প্রপার্টি থাকতে পারে।
• ফাইলের বিষয়বস্তু খালি হতে পারবে না এবং এতে অবশ্যই কমপক্ষে ১টি সারি থাকতে হবে।

পরিসংখ্যানের জন্য জিপ ফাইলের নির্দেশিকা

আপনি একটি ZIP ফাইল ব্যবহার করে একবারে পরিসংখ্যান ইম্পোর্ট করতে পারেন। আপনার ZIP ফাইলে ব্যবহার করার জন্য সঠিক ফাইলের নামগুলো জানতে টেবিলটি দেখুন:

জিপ ফাইলটিকে অবশ্যই নিম্নলিখিত শর্তগুলো পূরণ করতে হবে:

• ZIP ফাইলের আকারের সীমা: অসংকুচিত অবস্থায় সর্বোচ্চ মোট আকার ১০ মেগাবাইট।
• সর্বোচ্চ ফাইল সংখ্যা: জিপ আর্কাইভের ভিতরে মোট ৫৩টি ফাইল (৩টি CSV এবং ৫০টি আইকন)।
• সর্বোচ্চ সম্মিলিত পরিসংখ্যানের সীমা: ProgressionStatConfig.csv এবং RepetitiveStatsConfig.csv ফাইল দুটি মিলিয়ে মোট পরিসংখ্যানের সর্বোচ্চ সীমা ৫০টি।
• সমর্থিত CSV ফাইলসমূহ: ProgressionStatConfig.csv , RepetitiveStatsConfig.csv , এবং StatLocalizations.csv (ঐচ্ছিক)। আপনি যদি শুধুমাত্র অগ্রগতির পরিসংখ্যান আপলোড করতে চান, তাহলে ZIP ফাইলে পুনরাবৃত্তিমূলক পরিসংখ্যানের CSV ফাইলটি অন্তর্ভুক্ত করবেন না; অন্যথায়, কনসোলে একটি ত্রুটি দেখা দেবে। আপনি যদি শুধুমাত্র পুনরাবৃত্তিমূলক পরিসংখ্যান আপলোড করতে চান, তাহলেও একই নিয়ম প্রযোজ্য।
• আইকন ইমেজ ফাইল: PNG (.png) অথবা JPEG (.jpg, .jpeg)।
  • CSV ফাইলগুলোতে উল্লেখিত সকল আইকন অবশ্যই ZIP ফাইলের রুটে থাকতে হবে।
  • ZIP ফাইলে থাকা সমস্ত ইমেজ ফাইলকে অবশ্যই অন্তত একটি স্ট্যাট দ্বারা রেফারেন্স করা থাকতে হবে।
• ডিরেক্টরি কাঠামো: সমস্ত ফাইল অবশ্যই ZIP ফাইলের রুটে থাকতে হবে। সাবডিরেক্টরি অনুমোদিত নয়।

RepetitiveStatsConfig.csv ফরম্যাট

CSV ফাইলটিতে ঘোষিত ইভেন্ট এবং তার প্রোপার্টিগুলো কমা দ্বারা পৃথক করা মান হিসেবে নিম্নলিখিত ক্রমে রয়েছে:

Stat Id,Event Name,Event Property Name,Aggregation Type,Stat Display Name,Stat Description,Filter Property,Filter Operator,Filter Value,Is Competitive,Min limit,Max limit,Icon File Name,Good value direction,Unit

এই ক্ষেত্রগুলো নিম্নলিখিত সারণিতে বর্ণনা করা হয়েছে:

যদি আপনি ফিল্টার শর্তটি ব্যবহার করতে না চান, তাহলে সেলটি খালি রাখুন।

ProgressionStatConfig.csv ফরম্যাট

csv ফাইলটিতে ঘোষিত ইভেন্ট এবং তার প্রোপার্টিগুলো কমা দ্বারা পৃথক করা মান হিসেবে নিম্নলিখিত ক্রমে রয়েছে:

Stat Id,Event Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit

খেলোয়াড়ের গেমার প্রোফাইলে অগ্রগতির পরিসংখ্যানটি প্রথম পরিসংখ্যান হিসেবে দেখানো হবে।

এই ক্ষেত্রগুলো নিম্নলিখিত সারণিতে বর্ণনা করা হয়েছে:

StatLocalizations.csv ফরম্যাট

csv ফাইলটিতে ঘোষিত ইভেন্ট এবং তার প্রোপার্টিগুলো কমা দ্বারা পৃথক করা মান হিসেবে নিম্নলিখিত ক্রমে রয়েছে:

Stat Id,Stat Display Name,Locale,Localized Stat Display Name,Localized Stat Description

এই ক্ষেত্রগুলো নিম্নলিখিত সারণিতে বর্ণনা করা হয়েছে:

আইকন ফাইল

আপনি CSV ফাইলে যে আইকনগুলোর উল্লেখ করবেন, সেগুলো আপনার ইম্পোর্ট করা বর্তমান ZIP আর্কাইভটিতে অবশ্যই থাকতে হবে।

আইকন যাচাইকরণের নিয়মগুলো হলো:

আইকন নির্দেশিকা

আইকনগুলো স্বচ্ছ ব্যাকগ্রাউন্ডসহ ৫১২ x ৫১২ আকারের PNG, JPEG বা JPG ফাইল হিসেবে তৈরি করতে হবে।

সব লোকেলে একই আইকন ব্যবহার করা হয়, তাই আমরা আইকনের মধ্যে কোনো লেখা বা স্থানীয় ভাষার বিষয়বস্তু অন্তর্ভুক্ত না করার পরামর্শ দিই।

ইউনিট স্পেসিফিকেশন

ইউনিট কলামগুলো নিয়ন্ত্রণ করে যে খেলোয়াড়দের জন্য কাঁচা পরিসংখ্যানগত মানগুলো কীভাবে বিন্যাস ও স্থানীয়করণ করা হবে।

সংখ্যাসূচক পরিসংখ্যান বৈশিষ্ট্য (INT64, DOUBLE)

সময়কাল পরিসংখ্যান বৈশিষ্ট্য (DURATION)

অ-সংখ্যাসূচক পরিসংখ্যান বৈশিষ্ট্য (STRING, BOOL)

একক কলামগুলো অবশ্যই খালি রাখতে হবে।