API گزارشدهی توسعهدهندگان گوگل پلی به شما امکان میدهد به معیارها، گزارشها و اطلاعات جدول زمانی مربوط به برنامههای خود دسترسی داشته باشید. برای سادهسازی هرچه بیشتر استفاده از API، مجموعههای معیار، دسترسی به معیارها را استاندارد میکنند. یک مجموعه معیار، یک گروهبندی منطقی از معیارهای مرتبط است که ویژگیهای مشترکی (مانند تازگی و جزئیات) دارند و میتوانند با هم پرسوجو شوند. یک مجموعه معیار همچنین شامل تعدادی بُعد است که میتوانید از آنها برای فیلتر کردن یا ایجاد جزئیات استفاده کنید. مگر اینکه خلاف آن مشخص شده باشد، همه معیارها را میتوان بر اساس تمام ابعاد موجود تجزیه یا فیلتر کرد.
تازگی
هر منبع مجموعه معیار، یک روش استاندارد GET برای بازیابی تاریخ و زمان آخرین نقطه داده موجود، که به عنوان تازگی شناخته میشود، ارائه میدهد. از آنجایی که یک مجموعه معیار میتواند از چندین جزئیات (روزانه، ساعتی) پشتیبانی کند، این عملیات به ازای هر جزئیات پشتیبانی شده، یک مقدار تازگی را برمیگرداند.
شما میتوانید از مقدار freshness مستقیماً به عنوان نقطه پایانی در یک محدوده زمانی پرس و جو استفاده کنید.
پرسوجوهای داده
برای دسترسی به دادهها در یک مجموعه معیار، باید از روش سفارشی QUERY برای صدور پرسوجوها استفاده کنید. هر پرسوجو باید جزئیات و محدوده زمانی را مشخص کند. همراه با معیارهایی که میخواهید به آنها دسترسی داشته باشید، باید ابعادی را که باید برای تجزیه تجمیعها استفاده شوند، مشخص کنید.
هنگام درخواست جدولهای زمانی باید به محدودههای تاریخ دقت شود، به طوری که اندازه محدوده زمانی با اندازه برنامه شما و تعداد خرابیها نسبت معکوس داشته باشد. به عنوان مثال، یک برنامه بزرگ باید روزهای کمتری را در یک درخواست پرس و جو انتخاب کند تا از وقفههای پرس و جو ناشی از خواندن دادههای زیاد جلوگیری شود.
مجموعههای متریک موجود
فهرست زیر تمام نقاط پایانی و دادههای مرتبطی را که میتوانید درخواست کنید، فهرست میکند.
| مجموعه متریک | توضیحات | معیارهای پشتیبانی شده |
|---|---|---|
vitals.anrrate | شامل دادههای ANR همراه با دادههای استفاده است تا یک معیار نرمالشده مستقل از تعداد کاربران تولید کند. | anrRate (google.type.Decimal) : درصد کاربران متمایز در دوره تجمیع که حداقل یک ANR را تجربه کردهاند. anrRate7dUserWeighted (google.type.Decimal) : میانگین وزنی کاربر از معیار anrRate در 7 روز تا و شامل تاریخ. 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 | شامل دادههای خرابی همراه با دادههای استفاده است تا یک معیار نرمالشده مستقل از تعداد کاربران ایجاد کند. | 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 است که با دادههای وضعیت فرآیند ترکیب شده تا یک معیار نرمالشده مستقل از تعداد کاربران تولید کند. | excessWakeupRate (google.type.Decimal) : درصد کاربران متمایز در دوره تجمیع که بیش از ۱۰ بیدارباش در ساعت داشتهاند. excessWakeupRate7dUserWeighted (google.type.Decimal) : میانگین وزنی کاربر از معیار excessWakeupRate در ۷ روز تا و شامل تاریخ. excessWakeupRate28dUserWeighted (google.type.Decimal) : میانگین وزنی کاربر از معیار excessWakeupRate در ۲۸ روز تا تاریخ مورد نظر و شامل آن. distinctUsers (google.type.Decimal) : تعداد تقریبی کاربرانی که دادههای آنها در دوره تجمیع در دسترس بوده است. |
vitals.stuckbackgroundwakelockrate | شامل دادههای مدت زمان wakelock در PowerManager همراه با دادههای وضعیت فرآیند است تا یک معیار نرمالشده مستقل از تعداد کاربران تولید کند. | stuckBgWakelockRate (google.type.Decimal) : درصد کاربران متمایز در دوره تجمیع که wakelock آنها بیش از ۱ ساعت در پسزمینه نگه داشته شده است. 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 در 7 روز تا و شامل تاریخ. slowStartRate28dUserWeighted (google.type.Decimal) : میانگین وزنی کاربر از معیار slowStartRate در ۲۸ روز تا تاریخ مورد نظر و شامل آن. distinctUsers (google.type.Decimal) : تعداد تقریبی کاربرانی که دادههای آنها در دوره تجمیع در دسترس بوده است. |
vitals.errors.counts | شامل تعداد گزارشهای خطای غیر نرمال شده است. | لطفا توجه داشته باشید: این منبع در حال حاضر فقط در نسخه آلفای v1 از API موجود است. errorReportCount (google.type.Decimal) : تعداد مطلق گزارشهای خطای تکی که برای یک برنامه دریافت شدهاند. |
ابعاد
هر مجموعه معیار از مجموعهای متمایز از ابعاد برای فیلتر کردن و تجزیه و تحلیل پشتیبانی میکند. برای مشاهده فهرست ابعاد موجود در API، به فهرست ابعاد زیر نگاهی بیندازید.
| ابعاد | توضیحات |
|---|---|
versionCode | کد نسخه برنامهای که در زمان ثبت دادهها روی دستگاه کاربر در حال اجرا بوده است. مقدار رشتهای این بُعد را میتوان به عنوان یک عدد صحیح تجزیه کرد. برای جزئیات بیشتر در مورد نحوه عملکرد نسخهبندی برنامه در اندروید، اینجا را ببینید. |
countryCode | شناسه کشور یا منطقه کاربر بر اساس آدرس IP او، که به صورت یک کد دو حرفی ISO-3166 نمایش داده میشود (مثلاً US برای ایالات متحده). |
ابعاد دستگاه
اینها ابعاد مخصوص دستگاه و ویژگیهای نرمافزاری و سختافزاری آن هستند.
| ابعاد | توضیحات |
|---|---|
apiLevel | سطح API اندروید که در زمان دریافت دادهها روی دستگاه کاربر در حال اجرا بوده است. مقدار رشتهای این بُعد را میتوان به صورت یک عدد صحیح تجزیه کرد. برای مشاهده لیست نسخههای اندروید و نحوه نگاشت آنها به سطوح API، اینجا را ببینید. |
deviceModel | شناسهی مدل دستگاه خاص، همانطور که در کاتالوگ دستگاه Play Console تعریف شده است. |
deviceType | شناسهی فرم فاکتور خاص دستگاه، همانطور که توسط کاتالوگ دستگاههای Play Console استفاده میشود. |
deviceRamBucket | رم دستگاه، بر حسب مگابایت، در دستههای (۳ گیگابایت، ۴ گیگابایت و غیره). |
deviceSocMake | سازندهی تراشهی سیستمی اصلی دستگاه، مثلاً سامسونگ. اینجا را ببینید. |
deviceSocModel | نام مدل سیستم-روی-چیپ اصلی دستگاه، مثلاً «اگزینوس ۲۱۰۰». اینجا را ببینید. |
deviceCpuMake | سازنده پردازنده دستگاه، مثلاً کوالکام. |
deviceCpuModel | مدل CPU دستگاه، مثلاً "Kryo 240". |
deviceGpuMake | ساخت پردازنده گرافیکی دستگاه، مثلاً ARM. |
deviceGpuModel | مدل پردازنده گرافیکی دستگاه، مثلاً Mali. |
deviceGpuVersion | نسخه پردازنده گرافیکی دستگاه، مثلاً T750. |
deviceVulkanVersion | نسخه ولکان دستگاه، مثلاً "۴۱۹۸۴۰۰". |
deviceGlEsVersion | نسخه OpenGL ES دستگاه، مثلاً "196610". |
deviceScreenSize | اندازه صفحه نمایش دستگاه، مثلاً معمولی، بزرگ. |
deviceScreenDpi | تراکم صفحه نمایش دستگاه، مثلاً mdpi، hdpi. |