REST Resource: vitals.crashrate

المورد: CrashRateMetricSet

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

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

فترات التجميع المتاحة:

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

المقاييس المتوافقة:

  • ‫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): عدد المستخدمين المختلفين في فترة التجميع الذين تم استخدامهم كقيمة تسوية للمقياسَين crashRate وuserPerceivedCrashRate. يتم احتساب المستخدم في هذا المقياس إذا كان يستخدم التطبيق بشكلٍ نشط خلال فترة التجميع. يُعد التطبيق قيد الاستخدام النشط إذا كان يعرض أي نشاط أو ينفّذ أي خدمة تعمل في المقدّمة. يجب الحرص على عدم تجميع هذا العدد أكثر من ذلك، لأنّ ذلك قد يؤدي إلى احتساب المستخدمين عدة مرات. يتم تقريب القيمة إلى أقرب مضاعف للعدد 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): طراز وحدة المعالجة المركزية (CPU) للجهاز، مثل "Kryo 240"
  • ‫deviceGpuMake (string): يشير إلى الشركة المصنّعة لوحدة معالجة الرسومات في الجهاز، مثل ARM.
  • ‫deviceGpuModel (string): طراز وحدة معالجة الرسومات (GPU) للجهاز، مثل Mali
  • ‫deviceGpuVersion (string): إصدار وحدة معالجة الرسومات (GPU) في الجهاز، مثل T750.
  • deviceVulkanVersion (string): إصدار Vulkan للجهاز، مثل "4198400".
  • deviceGlEsVersion (string): إصدار OpenGL ES للجهاز، مثل "196610".
  • ‫deviceScreenSize (string): حجم شاشة الجهاز، مثل NORMAL أو LARGE
  • ‫deviceScreenDpi (string): كثافة الشاشة على الجهاز، مثل mdpi وhdpi

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

مجموعات المقاييس ذات الصلة:

  • يحتوي vitals.errors على إصدار غير معدّل (إجمالي عدد الأعطال) من الأعطال.
  • vitals.errors يحتوي على مقاييس موحّدة حول أخطاء ANR، وهو مقياس آخر للثبات.
تمثيل JSON 
{
  "name": string,
  "freshnessInfo": {
    object (FreshnessInfo)
  }
}
الحقول
name

string

المعرّف. تمثّل هذه السمة اسم المورد.

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

object (FreshnessInfo)

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

الطُرق

get

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

query

 يطلب هذا الحقل المقاييس في مجموعة المقاييس.