REST Resource: vitals.excessivewakeuprate

المورد: ExcessiveWakeupRateMetricSet

مورد فردي يمثّل مجموعة مقاييس عمليات التنشيط المفرطة.

تحتوي مجموعة المقاييس هذه على بيانات عدد عمليات التنشيط في AlarmManager مدمَجة مع بيانات حالة العملية لإنشاء مقياس موحّد مستقل عن أعداد المستخدمين.

فترات التجميع المسموح بها:

  • DAILY: يتم تجميع المقاييس في فواصل زمنية لتاريخ التقويم. بسبب القيود السابقة، المنطقة الزمنية الوحيدة المسموح بها هي America/Los_Angeles.

المقاييس المسموح بها:

  • excessiveWakeupRate (google.type.Decimal): النسبة المئوية للمستخدمين المختلفين في فترة التجميع الذين تم إجراء أكثر من 10 عمليات تنشيط في الساعة على أجهزتهم.
  • excessiveWakeupRate7dUserWeighted (google.type.Decimal): قيمة المتوسط المتحرّك لـ excessiveWakeupRate في آخر 7 أيام. يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم.
  • excessiveWakeupRate28dUserWeighted (google.type.Decimal): قيمة المتوسط المتحرّك لـ excessiveWakeupRate في آخر 28 يومًا. يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم.
  • distinctUsers (google.type.Decimal): عدد المستخدمين المختلفين في فترة التجميع الذين تم استخدامهم كقيمة توحيد للمقياس excessiveWakeupRate. يتم احتساب المستخدم في هذا المقياس إذا كان تطبيقه يجري أي عملية على الجهاز، أي ليس مجرد استخدام نشط في المقدّمة، بل أيضًا عمليات في الخلفية. يجب الحرص على عدم تجميع هذا العدد أكثر من ذلك، لأنّ ذلك قد يؤدي إلى احتساب المستخدمين عدة مرات. يتم تقريب القيمة إلى أقرب مضاعف للعدد 10 أو 100 أو 1,000 أو 1,000,000، حسب حجم القيمة.

السمات المسموح بها:

  • apiLevel (string): مستوى واجهة برمجة التطبيقات لنظام التشغيل Android الذي كان قيد التشغيل على جهاز المستخدم، مثلاً 26
  • versionCode (int64): إصدار التطبيق الذي كان قيد التشغيل على جهاز المستخدم
  • deviceModel (string): معرّف فريد لطراز جهاز المستخدم يكون شكل المعرّف "deviceBrand/device"، حيث يتطابق deviceBrand مع Build.BRAND ويتطابق device مع Build.DEVICE، مثلاً google/coral.
  • deviceBrand (string): معرّف فريد للعلامة التجارية لجهاز المستخدم، مثلاً google
  • deviceType (string): نوع جهاز المستخدم (المعروف أيضًا باسم عامل الشكل)، مثلاً PHONE
  • countryCode (string): بلد جهاز المستخدم أو منطقته استنادًا إلى عنوان IP الخاص به، ويتم تمثيله كرمز من حرفَين وفقًا لمعيار ISO-3166 (مثلاً US للولايات المتحدة)
  • deviceRamBucket (int64): ذاكرة الوصول العشوائي (RAM) للجهاز، بالميغابايت، في مجموعات (مثلاً 1024 لذاكرة الوصول العشوائي من 1 إلى 1.5 غيغابايت، و4096 لذاكرة الوصول العشوائي من 4 إلى 6 غيغابايت)
  • deviceSocMake (string): الشركة المصنّعة لنظام الجهاز الأساسي على شريحة، مثلاً Samsung مرجع
  • deviceSocModel (string): طراز نظام الجهاز الأساسي على شريحة، مثلاً "Exynos 2100" مرجع
  • deviceCpuMake (string): الشركة المصنّعة لوحدة المعالجة المركزية (CPU) للجهاز، مثلاً Qualcomm
  • deviceCpuModel (string): طراز وحدة المعالجة المركزية للجهاز، مثلاً "Kryo 240"
  • deviceGpuMake (string): الشركة المصنّعة لوحدة معالجة الرسومات (GPU) للجهاز، مثلاً ARM
  • deviceGpuModel (string): طراز وحدة معالجة الرسومات للجهاز، مثلاً Mali
  • deviceGpuVersion (string): إصدار وحدة معالجة الرسومات للجهاز، مثلاً T750
  • deviceVulkanVersion (string): إصدار Vulkan للجهاز، مثلاً "4198400"
  • deviceGlEsVersion (string): إصدار OpenGL ES للجهاز، مثلاً "196610"
  • deviceScreenSize (string): حجم شاشة الجهاز، مثلاً NORMAL أو LARGE
  • deviceScreenDpi (string): كثافة شاشة الجهاز، مثلاً mdpi أو hdpi

الأذونات المطلوبة: للوصول إلى هذا المورد، يجب أن يتوفّر لدى المستخدم الذي يجري الطلب إذن عرض معلومات التطبيق (للقراءة فقط) للتطبيق.

تمثيل JSON 
{
  "name": string,
  "freshnessInfo": {
    object (FreshnessInfo)
  }
}
الحقول
name

string

المعرّف. اسم المورد

التنسيق: apps/{app}/excessiveWakeupRateMetricSet
freshnessInfo

object (FreshnessInfo)

ملخّص عن سرعة توفُّر البيانات في هذا المورد

الطُرق

get

 يصف خصائص مجموعة المقاييس.

query

 يستعلم عن المقاييس في مجموعة المقاييس.