مقدمه ای بر مجموعه های متریک

Google Play Developer Reporting API به شما امکان می‌دهد به معیارها، گزارش‌ها و اطلاعات جدول زمانی برنامه‌هایتان دسترسی داشته باشید. برای ساده کردن استفاده از API تا حد امکان، مجموعه‌های متریک دسترسی متریک را استاندارد می‌کنند. مجموعه متریک یک گروه بندی منطقی از معیارهای مرتبط است که ویژگی های مشترکی (مانند تازگی و دانه بندی) دارند و می توان آنها را با هم جستجو کرد. مجموعه متریک همچنین شامل تعدادی ابعاد است که می توانید از آنها برای فیلتر کردن یا ایجاد خرابی استفاده کنید. مگر اینکه خلاف آن مشخص شده باشد، همه معیارها را می توان بر اساس همه ابعاد موجود تجزیه یا فیلتر کرد.

خنکی

هر منبع مجموعه متریک یک روش استاندارد GET را برای بازیابی تاریخ و زمان آخرین نقطه داده موجود ارائه می دهد که به تازگی شناخته می شود. از آنجایی که یک مجموعه متریک می تواند چندین دانه بندی (روزانه، ساعتی) را پشتیبانی کند، این عملیات به ازای هر دانه بندی پشتیبانی شده یک مقدار تازگی را برمی گرداند.

شما می توانید مقدار تازه بودن را مستقیماً به عنوان نقطه پایانی در محدوده زمانی پرس و جو استفاده کنید.

پرس و جوهای داده

برای دسترسی به داده ها در یک مجموعه متریک، باید از روش QUERY سفارشی برای صدور پرس و جو استفاده کنید. هر پرس و جو باید یک دانه بندی و یک محدوده زمانی را مشخص کند. همراه با معیارهایی که می خواهید به آنها دسترسی داشته باشید، باید ابعادی را که باید برای تجزیه مجموعه ها استفاده شوند، مشخص کنید.

هنگام درخواست جدول زمانی برای درخواست محدوده تاریخ باید مراقب بود، به طوری که اندازه محدوده زمانی با اندازه برنامه شما و تعداد خرابی ها نسبت معکوس دارد. به عنوان مثال، یک برنامه بزرگ باید روزهای کمتری را در یک درخواست پرس و جو انتخاب کند تا از وقفه زمانی درخواست ناشی از خواندن داده های زیاد جلوگیری کند.

مجموعه های متریک موجود

فهرست زیر تمام نقاط پایانی و داده‌های مرتبطی را که می‌توانید درخواست کنید فهرست می‌کند.

مجموعه متریک	شرح	معیارهای پشتیبانی شده
vitals.anrrate	حاوی داده‌های ANR است که با داده‌های استفاده ترکیب می‌شود تا معیاری نرمال‌شده مستقل از تعداد کاربران تولید کند.	anrRate (google.type.Decimal) : درصدی از کاربران متمایز در دوره تجمع که حداقل یک ANR را تجربه کرده‌اند. anrRate7dUserWeighted (google.type.Decimal) : میانگین وزنی کاربر معیار anrRate در 7 روز تا تاریخ و با احتساب آن تاریخ. anrRate28dUserWeighted (google.type.Decimal) : میانگین وزنی کاربر معیار anrRate در 28 روز تا تاریخ و با احتساب آن تاریخ. userPerceivedAnrRate (google.type.Decimal) : درصدی از کاربران متمایز در دوره تجمع که حداقل یک ANR درک شده توسط کاربر را تجربه کرده‌اند. در حال حاضر تنها یک ANR از "ارسال ورودی" شمارش می شود. userPerceivedAnrRate7dUserWeighted (google.type.Decimal) : میانگین وزنی کاربر معیار userPerceivedAnrRate در 7 روز تا تاریخ و با احتساب تاریخ. userPerceivedAnrRate28dUserWeighted (google.type.Decimal) : میانگین وزنی کاربر معیار userPerceivedAnrRate در 28 روز تا تاریخ و با احتساب تاریخ. distinctUsers (google.type.Decimal) : تعداد تقریبی کاربرانی که اطلاعات آنها در دوره تجمع در دسترس بوده است.
vitals.crashrate	حاوی داده‌های خرابی همراه با داده‌های استفاده برای تولید یک معیار عادی شده مستقل از تعداد کاربران است.	crashRate (google.type.Decimal) : درصدی از کاربران متمایز در دوره تجمع که حداقل یک خرابی را تجربه کرده‌اند. crashRate7dUserWeighted (google.type.Decimal) : میانگین وزنی کاربر معیار crashRate در 7 روز تا تاریخ و با احتساب آن تاریخ. crashRate28dUserWeighted (google.type.Decimal) : میانگین وزنی کاربر معیار crashRate در 28 روز تا تاریخ و با احتساب آن تاریخ. userPerceivedCrashRate (google.type.Decimal) : درصدی از کاربران متمایز در دوره تجمیع که حداقل یک بار خرابی را در زمانی که برنامه در حال استفاده فعال بود تجربه کردند. userPerceivedCrashRate7dUserWeighted (google.type.Decimal) : میانگین وزنی کاربر معیار userPerceivedCrashRate در 7 روز تا تاریخ و با احتساب تاریخ. userPerceivedCrashRate28dUserWeighted (google.type.Decimal) : میانگین وزنی کاربر معیار userPerceivedCrashRate در 28 روز تا تاریخ و با احتساب تاریخ. distinctUsers (google.type.Decimal) : تعداد تقریبی کاربرانی که اطلاعات آنها در دوره تجمع در دسترس بوده است.
vitals.excessivewakeuprate	حاوی داده‌های شمارش بیدارباش AlarmManager همراه با داده‌های وضعیت فرآیند برای تولید یک متریک عادی شده مستقل از تعداد کاربران است.	ExcessiveWakeupRate (google.type.Decimal) : درصدی از کاربران متمایز در دوره تجمع که بیش از 10 بیدار شدن در ساعت داشتند. excessiveWakeupRate7dUserWeighted (google.type.Decimal) : میانگین وزنی کاربر متریک excessiveWakeupRate در 7 روز تا تاریخ و با احتساب آن تاریخ. excessiveWakeupRate28dUserWeighted (google.type.Decimal) : میانگین وزنی کاربر متریک ExcessiveWakeupRate در 28 روز تا تاریخ و با احتساب آن تاریخ. distinctUsers (google.type.Decimal) : تعداد تقریبی کاربرانی که اطلاعات آنها در دوره تجمع در دسترس بوده است.
vitals.stuckbackgroundwakelockrate	حاوی داده‌های مدت زمان wakelock PowerManager همراه با داده‌های وضعیت فرآیند برای تولید یک معیار عادی شده مستقل از تعداد کاربران است.	stuckBgWakelockRate (google.type.Decimal) : درصدی از کاربران متمایز در دوره انباشتگی که دارای wakelock در پس‌زمینه برای بیش از 1 ساعت نگه داشته شده‌اند. stuckBgWakelockRate7dUserWeighted (google.type.Decimal) : میانگین وزنی کاربر معیار stuckBgWakelockRate در 7 روز تا تاریخ و با احتساب آن تاریخ. stuckBgWakelockRate28dUserWeighted (google.type.Decimal) : میانگین وزنی کاربر معیار stuckBgWakelockRate در 28 روز تا تاریخ و با احتساب تاریخ. distinctUsers (google.type.Decimal) : تعداد تقریبی کاربرانی که اطلاعات آنها در دوره تجمع در دسترس بوده است.
vitals.slowstartuprate	حاوی داده‌های راه‌اندازی کند برنامه است که بر اساس نوع شروع برنامه (سرد، گرم، گرم) تفکیک شده است.	slowStartRate (google.type.Decimal) : درصدی از کاربران متمایز در دوره تجمع که یک رویداد شروع کند داشتند. slowStartRate7dUserWeighted (google.type.Decimal) : میانگین وزنی کاربر معیار slowStartRate در 7 روز تا تاریخ و با احتساب آن تاریخ. slowStartRate28dUserWeighted (google.type.Decimal) : میانگین وزنی کاربر معیار slowStartRate در 28 روز تا تاریخ و با احتساب آن تاریخ. distinctUsers (google.type.Decimal) : تعداد تقریبی کاربرانی که اطلاعات آنها در دوره تجمع در دسترس بوده است.
vitals.errors.counts	حاوی تعداد گزارش خطای غیرعادی است.	لطفاً توجه داشته باشید: این منبع در حال حاضر فقط در نسخه آلفای v1 API موجود است. errorReportCount (google.type.Decimal) : تعداد مطلق گزارش های خطای فردی که برای یک برنامه دریافت شده است.

ابعاد

هر مجموعه متریک مجموعه ای متمایز از ابعاد را برای فیلتر کردن و خرابی ها پشتیبانی می کند. برای فهرستی از ابعاد موجود در API به نمایه ابعاد زیر نگاه کنید.

بعد، ابعاد، اندازه	شرح
versionCode	کد نسخه برنامه ای که در زمان ضبط داده ها روی دستگاه کاربر اجرا می شد. مقدار رشته این بعد را می توان به صورت یک عدد صحیح تجزیه کرد. برای جزئیات بیشتر درباره نحوه عملکرد نسخه‌سازی برنامه در Android، اینجا را ببینید.
countryCode	شناسه کشور یا منطقه کاربر بر اساس آدرس IP او، که به عنوان کد ۲ حرفی ISO-3166 نشان داده شده است (به عنوان مثال ایالات متحده برای ایالات متحده).

ابعاد دستگاه

اینها ابعاد مخصوص دستگاه و ویژگی های نرم افزاری و سخت افزاری آن است.

بعد، ابعاد، اندازه	شرح
apiLevel	سطح API اندروید که در زمان ضبط داده ها روی دستگاه کاربر اجرا می شد. مقدار رشته این بعد را می توان به صورت یک عدد صحیح تجزیه کرد. برای مشاهده لیست نسخه های اندروید و نحوه نگاشت آنها به سطوح API اینجا را ببینید.
deviceModel	شناسه یک مدل دستگاه خاص، همانطور که توسط کاتالوگ دستگاه Play Console تعریف شده است.
deviceType	شناسه یک ضریب فرم دستگاه خاص، همانطور که در کاتالوگ دستگاه کنسول Play استفاده می‌شود.
deviceRamBucket	رم دستگاه، در مگابایت، در سطل (3 گیگابایت، 4 گیگابایت و غیره).
deviceSocMake	نام سیستم روی تراشه اصلی دستگاه، به عنوان مثال، سامسونگ. اینجا را ببینید.
deviceSocModel	نام مدل سیستم روی تراشه اصلی دستگاه، به عنوان مثال، "Exynos 2100". اینجا را ببینید.
deviceCpuMake	ساخت CPU دستگاه، به عنوان مثال، Qualcomm.
deviceCpuModel	مدل CPU دستگاه، به عنوان مثال، "Kryo 240".
deviceGpuMake	ساخت GPU دستگاه، به عنوان مثال، ARM.
deviceGpuModel	مدل GPU دستگاه، به عنوان مثال، مالی.
deviceGpuVersion	نسخه GPU دستگاه، به عنوان مثال، T750.
deviceVulkanVersion	نسخه Vulkan دستگاه، به عنوان مثال، "4198400".
deviceGlEsVersion	نسخه OpenGL ES دستگاه، به عنوان مثال، "196610".
deviceScreenSize	اندازه صفحه نمایش دستگاه، به عنوان مثال، NORMAL، LARGE.
deviceScreenDpi	تراکم صفحه نمایش دستگاه، به عنوان مثال، mdpi، hdpi.