মেট্রিক সেট পরিচিতি

গুগল প্লে ডেভেলপার রিপোর্টিং এপিআই আপনাকে আপনার অ্যাপ সম্পর্কিত মেট্রিক, রিপোর্ট এবং টাইমলাইন তথ্য অ্যাক্সেস করার সুযোগ দেয়। এপিআই-এর ব্যবহার যথাসম্ভব সহজ করার জন্য, মেট্রিক সেট মেট্রিক অ্যাক্সেসকে প্রমিত করে। একটি মেট্রিক সেট হলো সম্পর্কিত মেট্রিকগুলোর একটি যৌক্তিক গোষ্ঠী, যেগুলোর মধ্যে সাধারণ বৈশিষ্ট্য (যেমন সতেজতা এবং সূক্ষ্মতা) থাকে এবং যেগুলোকে একসাথে কোয়েরি করা যায়। একটি মেট্রিক সেটে বেশ কিছু ডাইমেনশনও থাকে, যা আপনি ফিল্টার করতে বা বিস্তারিত বিশ্লেষণ তৈরি করতে ব্যবহার করতে পারেন। অন্য কোনো নির্দেশনা না থাকলে, সমস্ত মেট্রিককে উপলব্ধ সকল ডাইমেনশন দ্বারা বিশ্লেষণ বা ফিল্টার করা যায়।

সতেজতা

প্রতিটি মেট্রিক সেট রিসোর্স সর্বশেষ উপলব্ধ ডেটাপয়েন্টের (যা ফ্রেশনেস নামে পরিচিত) তারিখ ও সময় পুনরুদ্ধার করার জন্য একটি স্ট্যান্ডার্ড GET মেথড প্রদান করে। যেহেতু একটি মেট্রিক সেট একাধিক গ্র্যানুলারিটি (দৈনিক, ঘণ্টাব্যাপী) সমর্থন করতে পারে, তাই অপারেশনটি প্রতিটি সমর্থিত গ্র্যানুলারিটির জন্য একটি করে ফ্রেশনেস ভ্যালু রিটার্ন করে।

আপনি কোয়েরির সময়সীমার মধ্যে এন্ডপয়েন্ট হিসেবে সরাসরি সতেজতার মানটি ব্যবহার করতে পারেন।

ডেটা কোয়েরি

একটি মেট্রিক সেটের ডেটা অ্যাক্সেস করতে, আপনাকে কাস্টম QUERY মেথড ব্যবহার করে কোয়েরি চালাতে হবে। প্রতিটি কোয়েরিতে একটি গ্র্যানুলারিটি এবং একটি টাইম রেঞ্জ উল্লেখ করতে হবে। আপনি যে মেট্রিকগুলো অ্যাক্সেস করতে চান, সেগুলোর পাশাপাশি অ্যাগ্রিগেশনগুলোকে ভেঙে ফেলার জন্য যে ডাইমেনশনগুলো ব্যবহার করা হবে, সেগুলোও উল্লেখ করতে হবে।

টাইমলাইন অনুরোধ করার সময় তারিখের পরিসর চাওয়ার ক্ষেত্রে সতর্কতা অবলম্বন করা উচিত, যাতে সময়সীমার আকার আপনার অ্যাপের আকার এবং ব্রেকডাউনের সংখ্যার সাথে ব্যস্তানুপাতিক হয়। উদাহরণস্বরূপ, একটি বড় অ্যাপের ক্ষেত্রে, অতিরিক্ত ডেটা পড়ার কারণে সৃষ্ট কোয়েরি টাইমআউট এড়াতে একটি একক কোয়েরি অনুরোধে কম দিন নির্বাচন করা উচিত।

উপলব্ধ মেট্রিক সেট

নিচের সূচীতে সেই সমস্ত এন্ডপয়েন্ট এবং সংশ্লিষ্ট ডেটার তালিকা দেওয়া আছে, যেগুলোর জন্য আপনি অনুরোধ করতে পারেন।

মেট্রিক সেট	বর্ণনা	সমর্থিত মেট্রিক্স
vitals.anrrate	ব্যবহারকারীর সংখ্যা থেকে স্বাধীন একটি স্বাভাবিকীকৃত মেট্রিক তৈরি করার জন্য এতে এএনআর ডেটার সাথে ব্যবহারের ডেটা একত্রিত করা হয়েছে।	anrRate (google.type.Decimal) : অ্যাগ্রিগেশন পিরিয়ডে থাকা স্বতন্ত্র ব্যবহারকারীদের শতকরা হার, যারা অন্তত একটি ANR-এর সম্মুখীন হয়েছেন। anrRate7dUserWeighted (google.type.Decimal) : উক্ত তারিখ পর্যন্ত এবং সেই তারিখ সহ বিগত ৭ দিনের anrRate মেট্রিকের ব্যবহারকারী-ভারিত গড়। anrRate28dUserWeighted (google.type.Decimal) : উক্ত তারিখ পর্যন্ত এবং সেই তারিখ সহ বিগত ২৮ দিনের anrRate মেট্রিকের ব্যবহারকারী-ভারিত গড়। userPerceivedAnrRate (google.type.Decimal) : অ্যাগ্রিগেশন পিরিয়ডে থাকা স্বতন্ত্র ব্যবহারকারীদের শতকরা হার, যারা অন্তত একটি ব্যবহারকারী-অনুভূত ANR-এর সম্মুখীন হয়েছেন। বর্তমানে শুধুমাত্র 'ইনপুট ডিসপ্যাচিং'-এর ANR-গুলোই গণনা করা হয়। userPerceivedAnrRate7dUserWeighted (google.type.Decimal) : নির্দিষ্ট তারিখ পর্যন্ত এবং উক্ত তারিখ সহ বিগত ৭ দিনের userPerceivedAnrRate মেট্রিকের ব্যবহারকারী-ভারিত গড়। userPerceivedAnrRate28dUserWeighted (google.type.Decimal) : নির্দিষ্ট তারিখ পর্যন্ত এবং সেই তারিখ সহ বিগত ২৮ দিনের userPerceivedAnrRate মেট্রিকের ব্যবহারকারী-ভারিত গড়। distinctUsers (google.type.Decimal) : একত্রীকরণ সময়কালে যে সকল ব্যবহারকারীর তথ্য পাওয়া গিয়েছিল, তাদের আনুমানিক সংখ্যা।
vitals.crashrate	ব্যবহারকারীর সংখ্যা নির্বিশেষে একটি স্বাভাবিকীকৃত মেট্রিক তৈরি করতে এতে ক্র্যাশ ডেটার সাথে ব্যবহারের ডেটা একত্রিত করা হয়েছে।	ক্র্যাশ রেট (google.type.Decimal) : নির্দিষ্ট ডেটা সংগ্রহের সময়কালে অন্তত একটি ক্র্যাশের সম্মুখীন হওয়া স্বতন্ত্র ব্যবহারকারীদের শতাংশ। crashRate7dUserWeighted (google.type.Decimal) : উল্লিখিত তারিখ পর্যন্ত এবং উক্ত তারিখ সহ বিগত ৭ দিনের crashRate মেট্রিকের ব্যবহারকারী-ভারিত গড়। crashRate28dUserWeighted (google.type.Decimal) : বর্তমান তারিখ পর্যন্ত এবং উক্ত তারিখ সহ বিগত ২৮ দিনের crashRate মেট্রিকের ব্যবহারকারী-ভারিত গড়। userPerceivedCrashRate (google.type.Decimal) : নির্দিষ্ট সময়কালে অ্যাপটি সক্রিয়ভাবে ব্যবহারের সময় অন্তত একবার ক্র্যাশের সম্মুখীন হওয়া স্বতন্ত্র ব্যবহারকারীদের শতাংশ। userPerceivedCrashRate7dUserWeighted (google.type.Decimal) : বর্তমান তারিখ পর্যন্ত এবং উক্ত তারিখ সহ বিগত ৭ দিনের userPerceivedCrashRate মেট্রিকের ব্যবহারকারী-ভারিত গড়। userPerceivedCrashRate28dUserWeighted (google.type.Decimal) : বর্তমান তারিখ পর্যন্ত এবং উক্ত তারিখ সহ বিগত ২৮ দিনের userPerceivedCrashRate মেট্রিকের ব্যবহারকারী-ভারিত গড়। distinctUsers (google.type.Decimal) : একত্রীকরণ সময়কালে যে সকল ব্যবহারকারীর তথ্য পাওয়া গিয়েছিল, তাদের আনুমানিক সংখ্যা।
vitals.lmkrate	এতে LMK (লো মেমোরি কিল) ডেটার সাথে ব্যবহারের ডেটা একত্রিত করে ব্যবহারকারীর সংখ্যা থেকে স্বাধীন একটি স্বাভাবিকীকৃত মেট্রিক তৈরি করা হয়।	userPerceivedLmkRate (google.type.Decimal) : নির্দিষ্ট সময়কালে আপনার অ্যাপটি সক্রিয়ভাবে ব্যবহার করার সময় অন্তত একবার LMK (লো মেমোরি কিল)-এর সম্মুখীন হওয়া স্বতন্ত্র ব্যবহারকারীদের শতাংশ। একটি অ্যাপকে সক্রিয়ভাবে ব্যবহৃত হচ্ছে বলে মনে করা হয় যদি এটি কোনো কার্যকলাপ প্রদর্শন করে বা কোনো ফোরগ্রাউন্ড পরিষেবা সম্পাদন করে। userPerceivedLmkRate7dUserWeighted (google.type.Decimal) : নির্দিষ্ট তারিখ পর্যন্ত এবং উক্ত তারিখ সহ বিগত ৭ দিনের userPerceivedLmkRate মেট্রিকের ব্যবহারকারী-ভারিত গড়। userPerceivedLmkRate28dUserWeighted (google.type.Decimal) : বর্তমান তারিখ পর্যন্ত এবং উক্ত তারিখ সহ বিগত ২৮ দিনের userPerceivedLmkRate মেট্রিকের ব্যবহারকারী-ভারিত গড়। distinctUsers (google.type.Decimal) : একত্রীকরণ সময়কালে যে সকল ব্যবহারকারীর তথ্য পাওয়া গিয়েছিল, তাদের আনুমানিক সংখ্যা।
vitals.excessivewakeuprate	এতে AlarmManager-এর ওয়েকআপ কাউন্ট ডেটার সাথে প্রসেস স্টেট ডেটা একত্রিত করে একটি নর্মালাইজড মেট্রিক তৈরি করা হয়, যা ইউজার কাউন্ট থেকে স্বাধীন।	অতিরিক্ত ঘুম থেকে ওঠার হার (google.type.Decimal) : নির্দিষ্ট সময়কালে প্রতি ঘন্টায় ১০টির বেশি ঘুম ভাঙা স্বতন্ত্র ব্যবহারকারীদের শতাংশ। অতিরিক্ত ঘুম থেকে ওঠার ৭ দিনের ব্যবহারকারী-ভারযুক্ত হার (google.type.Decimal) : নির্দিষ্ট তারিখ পর্যন্ত এবং সেই তারিখ সহ বিগত ৭ দিনের অতিরিক্ত ঘুম থেকে ওঠার হারের মেট্রিকের ব্যবহারকারী-ভারযুক্ত গড়। excessiveWakeupRate28dUserWeighted (google.type.Decimal) : নির্দিষ্ট তারিখ পর্যন্ত এবং উক্ত তারিখ সহ বিগত ২৮ দিনের excessiveWakeupRate মেট্রিকের ব্যবহারকারী-ভারিত গড়। distinctUsers (google.type.Decimal) : একত্রীকরণ সময়কালে যে সকল ব্যবহারকারীর তথ্য পাওয়া গিয়েছিল, তাদের আনুমানিক সংখ্যা।
vitals.stuckbackgroundwakelockrate	ব্যবহারকারীর সংখ্যা নির্বিশেষে একটি স্বাভাবিকীকৃত মেট্রিক তৈরি করার জন্য এতে PowerManager ওয়েক-লক সময়কালের ডেটার সাথে প্রসেস অবস্থার ডেটা একত্রিত করা হয়।	stuckBgWakelockRate (google.type.Decimal) : অ্যাগ্রিগেশন পিরিয়ডে থাকা স্বতন্ত্র ব্যবহারকারীদের শতকরা হার, যাদের ওয়েক-লক ১ ঘণ্টার বেশি সময় ধরে ব্যাকগ্রাউন্ডে চালু ছিল। stuckBgWakelockRate7dUserWeighted (google.type.Decimal) : এই তারিখ পর্যন্ত এবং এই তারিখ সহ বিগত ৭ দিনের stuckBgWakelockRate মেট্রিকের ব্যবহারকারী-ভারিত গড়। stuckBgWakelockRate28dUserWeighted (google.type.Decimal) : নির্দিষ্ট তারিখ পর্যন্ত এবং উক্ত তারিখ সহ বিগত ২৮ দিনের stuckBgWakelockRate মেট্রিকের ব্যবহারকারী-ভারিত গড়। distinctUsers (google.type.Decimal) : একত্রীকরণ সময়কালে যে সকল ব্যবহারকারীর তথ্য পাওয়া গিয়েছিল, তাদের আনুমানিক সংখ্যা।
vitals.slowstartrate	অ্যাপ চালু হওয়ার ধরণ (কোল্ড, ওয়ার্ম, হট) অনুযায়ী বিভক্ত ধীরগতির অ্যাপ স্টার্টআপ ডেটা এতে রয়েছে।	slowStartRate (google.type.Decimal) : অ্যাগ্রিগেশন পিরিয়ডে থাকা স্বতন্ত্র ব্যবহারকারীদের শতকরা হার যাদের একটি স্লো স্টার্ট ইভেন্ট ছিল। slowStartRate7dUserWeighted (google.type.Decimal) : নির্দিষ্ট তারিখ পর্যন্ত এবং সেই তারিখ সহ বিগত ৭ দিনের slowStartRate মেট্রিকের ব্যবহারকারী-ভারিত গড়। slowStartRate28dUserWeighted (google.type.Decimal) : বর্তমান তারিখ পর্যন্ত এবং উক্ত তারিখ সহ বিগত ২৮ দিনের slowStartRate মেট্রিকের ব্যবহারকারী-ভারিত গড়। distinctUsers (google.type.Decimal) : একত্রীকরণ সময়কালে যে সকল ব্যবহারকারীর তথ্য পাওয়া গিয়েছিল, তাদের আনুমানিক সংখ্যা।
vitals.errors.counts	এতে অ-স্বাভাবিকীকৃত ত্রুটি প্রতিবেদনের সংখ্যা রয়েছে।	অনুগ্রহ করে মনে রাখবেন: এই রিসোর্সটি আপাতত শুধুমাত্র API-এর v1 আলফা সংস্করণে উপলব্ধ। errorReportCount (google.type.Decimal) : একটি অ্যাপের জন্য প্রাপ্ত স্বতন্ত্র ত্রুটি রিপোর্টের মোট সংখ্যা।

মাত্রা

প্রতিটি মেট্রিক সেট ফিল্টারিং এবং বিভাজনের জন্য স্বতন্ত্র ডাইমেনশন সেট সমর্থন করে। এপিআই-তে উপলব্ধ ডাইমেনশনগুলোর তালিকার জন্য নিচের ডাইমেনশন ইনডেক্সটি দেখুন।

মাত্রা	বর্ণনা
versionCode	ডেটা সংগ্রহের সময় ব্যবহারকারীর ডিভাইসে চলমান অ্যাপটির ভার্সন কোড। এই ডাইমেনশনের স্ট্রিং ভ্যালুটি একটি ইন্টিজার হিসেবে পার্স করা যেতে পারে। অ্যান্ড্রয়েডে অ্যাপ ভার্সনিং কীভাবে কাজ করে সে সম্পর্কে অতিরিক্ত বিবরণের জন্য এখানে দেখুন।
countryCode	ব্যবহারকারীর আইপি অ্যাড্রেসের উপর ভিত্তি করে তার দেশ বা অঞ্চলের শনাক্তকারী, যা একটি ২-অক্ষরের ISO-3166 কোড হিসাবে প্রকাশ করা হয় (যেমন, মার্কিন যুক্তরাষ্ট্রের জন্য US)।

ডিভাইসের মাত্রা

এগুলো হলো ডিভাইসটির নির্দিষ্ট মাত্রা এবং এর সফটওয়্যার ও হার্ডওয়্যার বৈশিষ্ট্যসমূহ।

মাত্রা	বর্ণনা
apiLevel	ডেটা সংগ্রহের সময় ব্যবহারকারীর ডিভাইসে চলমান অ্যান্ড্রয়েডের এপিআই লেভেল। এই ডাইমেনশনের স্ট্রিং ভ্যালুটি একটি ইন্টিজার হিসেবে পার্স করা যেতে পারে। অ্যান্ড্রয়েড রিলিজগুলোর তালিকা এবং সেগুলো কীভাবে এপিআই লেভেলের সাথে সম্পর্কিত, তা জানতে এখানে দেখুন।
deviceModel	প্লে কনসোল ডিভাইস ক্যাটালগ দ্বারা সংজ্ঞায়িত একটি নির্দিষ্ট ডিভাইস মডেলের শনাক্তকারী।
deviceType	একটি নির্দিষ্ট ডিভাইস ফর্ম ফ্যাক্টরের শনাক্তকারী, যা প্লে কনসোল ডিভাইস ক্যাটালগে ব্যবহৃত হয়।
deviceRamBucket	ডিভাইসটির র‍্যাম, মেগাবাইটে, বিভিন্ন ভাগে (যেমন ৩জিবি, ৪জিবি ইত্যাদি)।
deviceSocMake	ডিভাইসটির প্রধান সিস্টেম-অন-চিপের প্রস্তুতকারক, যেমন, স্যামসাং। এখানে দেখুন।
deviceSocModel	ডিভাইসটির প্রধান সিস্টেম-অন-চিপের মডেলের নাম, যেমন, 'এক্সিনোস ২১০০'। এখানে দেখুন।
deviceCpuMake	ডিভাইসটির সিপিইউ-এর প্রস্তুতকারক, যেমন, কোয়ালকম।
deviceCpuModel	ডিভাইসটির সিপিইউ-এর মডেল, যেমন, "Kryo 240"।
deviceGpuMake	ডিভাইসটির জিপিইউ-এর প্রস্তুতকারক, যেমন, এআরএম।
deviceGpuModel	ডিভাইসটির জিপিইউ-এর মডেল, যেমন, মালি।
deviceGpuVersion	ডিভাইসটির জিপিইউ-এর সংস্করণ, যেমন, টি৭৫০।
deviceVulkanVersion	ডিভাইসটির ভলকান সংস্করণ, যেমন, "4198400"।
deviceGlEsVersion	ডিভাইসটির OpenGL ES সংস্করণ, যেমন, "196610"।
deviceScreenSize	ডিভাইসটির স্ক্রিনের আকার, যেমন, সাধারণ, বড়।
deviceScreenDpi	ডিভাইসটির স্ক্রিন ডেনসিটি, যেমন, mdpi, hdpi।