গুগল প্লে ডেভেলপার রিপোর্টিং এপিআই আপনাকে আপনার অ্যাপ সম্পর্কিত মেট্রিক, রিপোর্ট এবং টাইমলাইন তথ্য অ্যাক্সেস করার সুযোগ দেয়। এপিআই-এর ব্যবহার যথাসম্ভব সহজ করার জন্য, মেট্রিক সেট মেট্রিক অ্যাক্সেসকে প্রমিত করে। একটি মেট্রিক সেট হলো সম্পর্কিত মেট্রিকগুলোর একটি যৌক্তিক গোষ্ঠী, যেগুলোর মধ্যে সাধারণ বৈশিষ্ট্য (যেমন সতেজতা এবং সূক্ষ্মতা) থাকে এবং যেগুলোকে একসাথে কোয়েরি করা যায়। একটি মেট্রিক সেটে বেশ কিছু ডাইমেনশনও থাকে, যা আপনি ফিল্টার করতে বা বিস্তারিত বিশ্লেষণ তৈরি করতে ব্যবহার করতে পারেন। অন্য কোনো নির্দেশনা না থাকলে, সমস্ত মেট্রিককে উপলব্ধ সকল ডাইমেনশন দ্বারা বিশ্লেষণ বা ফিল্টার করা যায়।
সতেজতা
প্রতিটি মেট্রিক সেট রিসোর্স সর্বশেষ উপলব্ধ ডেটাপয়েন্টের (যা ফ্রেশনেস নামে পরিচিত) তারিখ ও সময় পুনরুদ্ধার করার জন্য একটি স্ট্যান্ডার্ড 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.anonrssandswapmemoryusage | এতে সাধারণ আরএসএস (RSS) ও সোয়াপ মেমরি ব্যবহারের তথ্যের সাথে অন্যান্য ব্যবহারের তথ্যও রয়েছে। | anonRssAndSwapMemoryUsageP50 (google.type.Decimal) : অ্যানন আরএসএস এবং সোয়াপ মেমরি ব্যবহারের ৫০তম পার্সেন্টাইল। anonRssAndSwapMemoryUsageP75 (google.type.Decimal) : অ্যানন আরএসএস এবং সোয়াপ মেমরি ব্যবহারের ৭৫তম পার্সেন্টাইল। anonRssAndSwapMemoryUsageP90 (google.type.Decimal) : অ্যানন আরএসএস এবং সোয়াপ মেমরি ব্যবহারের ৯০তম পার্সেন্টাইল। anonRssAndSwapMemoryUsageP95 (google.type.Decimal) : অ্যানন আরএসএস এবং সোয়াপ মেমরি ব্যবহারের ৯৫তম পার্সেন্টাইল। anonRssAndSwapMemoryUsageP99 (google.type.Decimal) : অ্যানন আরএসএস এবং সোয়াপ মেমরি ব্যবহারের ৯৯তম পার্সেন্টাইল। distinctUsers (google.type.Decimal) : অ্যাগ্রিগেশন সময়কালে যেসব স্বতন্ত্র ব্যবহারকারীর মেমরি মেট্রিক্স রিপোর্ট করা হয়েছিল, তাদের সংখ্যা। এই সংখ্যাটিকে আরও অ্যাগ্রিগেট না করার ব্যাপারে অবশ্যই সতর্কতা অবলম্বন করতে হবে, কারণ এর ফলে ব্যবহারকারীরা একাধিকবার গণনার শিকার হতে পারেন। মানটির পরিমাণের উপর নির্ভর করে, এটিকে ১০, ১০০, ১,০০০ বা ১,০০০,০০০-এর নিকটতম গুণিতকে রাউন্ড করা হয়। |
vitals.bitmapmemoryusage | এতে ব্যবহারের তথ্যের সাথে বিটম্যাপ মেমরি ব্যবহারের তথ্য একত্রিত রয়েছে। | bitmapMemoryUsageP50 (google.type.Decimal) : বিটম্যাপ মেমরি ব্যবহারের ৫০তম পার্সেন্টাইল। bitmapMemoryUsageP75 (google.type.Decimal) : বিটম্যাপ মেমরি ব্যবহারের ৭৫তম পার্সেন্টাইল। bitmapMemoryUsageP90 (google.type.Decimal) : বিটম্যাপ মেমরি ব্যবহারের ৯০তম পার্সেন্টাইল। bitmapMemoryUsageP95 (google.type.Decimal) : বিটম্যাপ মেমরি ব্যবহারের ৯৫তম পার্সেন্টাইল। bitmapMemoryUsageP99 (google.type.Decimal) : বিটম্যাপ মেমরি ব্যবহারের ৯৯তম পার্সেন্টাইল। 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। |