Method: vitals.crashrate.query

object (TimelineSpec)

اختيارية: يشير هذا الحقل إلى مواصفات مَعلمات تجميع المخطط الزمني.

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

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

string

اختيارية: السمات التي يتم تقسيم المقاييس حسبها

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

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

string

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

integer

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

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

string

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

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

enum (UserCohort)

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

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

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

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

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