Method: vitals.crashrate.query

object (TimelineSpec)

اختياريّ. مواصفات مَعلمات تجميع المخطط الزمني

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

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

string

اختياريّ. السمات التي يتم تقسيم المقاييس حسبها

السمات المتاحة:

• apiLevel (string): مستوى واجهة برمجة التطبيقات (API) لنظام التشغيل 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 Reference
• deviceSocModel (string): طراز نظام الجهاز الأساسي على شريحة واحدة، مثلاً "Exynos 2100" Reference
• deviceCpuMake (string): الشركة المصنّعة لوحدة المعالجة المركزية (CPU) للجهاز، مثلاً Qualcomm
• deviceCpuModel (string): طراز وحدة المعالجة المركزية (CPU) للجهاز، مثلاً "Kryo 240"
• deviceGpuMake (string): الشركة المصنّعة لوحدة معالجة الرسومات (GPU) للجهاز، مثلاً 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

string

اختياريّ. المقاييس المطلوب تجميعها

المقاييس المتاحة:

• crashRate (google.type.Decimal): النسبة المئوية للمستخدمين المميّزين في فترة التجميع الذين واجهوا عطلاً واحدًا على الأقل
• crashRate7dUserWeighted (google.type.Decimal): القيمة المتوسطة المتحركة لـ crashRate في آخر 7 أيام يتم ترجيح القيم اليومية حسب عدد المستخدمين المميّزين في اليوم.
• crashRate28dUserWeighted (google.type.Decimal): القيمة المتوسطة المتحركة لـ crashRate في آخر 28 يومًا يتم ترجيح القيم اليومية حسب عدد المستخدمين المميّزين في اليوم. غير متاح بدقة HOURLY.
• userPerceivedCrashRate (google.type.Decimal): النسبة المئوية للمستخدمين المميّزين في فترة التجميع الذين واجهوا عطلاً واحدًا على الأقل أثناء استخدامهم تطبيقك بنشاط (عطل لاحظه المستخدم) يُعتبر التطبيق قيد الاستخدام النشط إذا كان يعرض أي نشاط أو ينفّذ أي خدمة تعمل في المقدّمة.
• userPerceivedCrashRate7dUserWeighted (google.type.Decimal): القيمة المتوسطة المتحركة لـ userPerceivedCrashRate في آخر 7 أيام يتم ترجيح القيم اليومية حسب عدد المستخدمين المميّزين في اليوم. غير متاح بدقة HOURLY.
• userPerceivedCrashRate28dUserWeighted (google.type.Decimal): القيمة المتوسطة المتحركة لـ userPerceivedCrashRate في آخر 28 يومًا يتم ترجيح القيم اليومية حسب عدد المستخدمين المميّزين في اليوم. غير متاح بدقة HOURLY.
• distinctUsers (google.type.Decimal): عدد المستخدمين المميّزين في فترة التجميع الذين تم استخدامهم كقيمة تسوية للمقيَسين crashRate وuserPerceivedCrashRate يتم احتساب المستخدم في هذا المقياس إذا كان يستخدم التطبيق بنشاط خلال فترة التجميع. يُعتبر التطبيق قيد الاستخدام النشط إذا كان يعرض أي نشاط أو ينفّذ أي خدمة تعمل في المقدّمة. يجب الحرص على عدم تجميع هذا العدد أكثر من ذلك، لأنّ ذلك قد يؤدي إلى احتساب المستخدمين عدة مرات. يتم تقريب القيمة إلى أقرب مضاعف لـ 10 أو 100 أو 1,000 أو 1,000,000، حسب حجم القيمة.

string

اختياريّ. الفلاتر التي يتم تطبيقها على البيانات يتّبع تعبير الفلترة معيار AIP-160 ويتيح الفلترة حسب المساواة في جميع سمات التقسيم.

integer

اختياريّ. الحد الأقصى لحجم البيانات المعروضة

إذا لم يتم تحديد هذه المَعلمة، سيتم عرض 1, 000 صف كحد أقصى. الحد الأقصى للقيمة هو 100,000، وسيتم فرض القيمة 100,000 على القيم التي تزيد عن 100,000.

string

اختياريّ. رمز الصفحة الذي تم تلقّيه من طلب سابق يُرجى تقديم هذا الرمز لاسترداد الصفحة التالية.

عند تقسيم النتائج على صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة للطلب مع الطلب الذي قدّم رمز الصفحة.

enum (UserCohort)

اختياريّ. عرض المستخدم المطلوب اختياره ستتطابق البيانات الناتجة مع العرض المحدّد.

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

• OS_PUBLIC: لاختيار البيانات من جميع إصدارات Android التي تم إطلاقها علنًا هذا هو الخيار التلقائي. يتيح هذا الخيار استخدام جميع السمات أعلاه.
• APP_TESTERS: لاختيار البيانات من المستخدمين الذين وافقوا على أن يكونوا مختبِرين يتيح هذا الخيار استخدام جميع السمات أعلاه.
• OS_BETA: لاختيار البيانات من إصدارات Android التجريبية فقط، باستثناء البيانات من إصدارات Android التي تم إطلاقها لا تتوفّر سوى السمات التالية:

• versionCode (int64): إصدار التطبيق الذي كان يعمل على جهاز المستخدم

• osBuild (string): إصدار نظام التشغيل لجهاز المستخدم، مثلاً "T1B2.220916.004".