مقدمة حول مجموعات المقاييس

تتيح لك واجهة برمجة التطبيقات Google Play Developer Reporting API الوصول إلى المقاييس والتقارير ومعلومات المخطط الزمني لتطبيقاتك. ولتسهيل استخدام واجهة برمجة التطبيقات قدر الإمكان، تعمل مجموعات المقاييس على توحيد طريقة الوصول إلى المقاييس. مجموعة المقاييس هي تجميع منطقي للمقاييس ذات الصلة التي تشترك في سمات شائعة (مثل الحداثة والدقة) ويمكن طلبها معًا. تحتوي مجموعة المقاييس أيضًا على عدد من السمات التي يمكنك استخدامها لفلترة البيانات أو عرض تفاصيلها. ما لم يُنص على خلاف ذلك، يمكن عرض تفاصيل جميع المقاييس أو فلترتها حسب جميع السمات المتاحة.

الحداثة

يقدّم كل مصدر من مصادر مجموعة المقاييس طريقة GET عادية لاسترداد تاريخ ووقت أحدث نقطة بيانات متاحة، تُعرف باسم الحداثة. بما أنّ مجموعة المقاييس يمكن أن تتيح دقة متعدّدة (يومية، كل ساعة)، تعرض العملية قيمة حداثة واحدة لكل دقة متاحة.

يمكنك استخدام قيمة الحداثة مباشرةً كنقطة نهاية في نطاق زمني لطلب بحث.

طلبات البحث عن البيانات

للوصول إلى البيانات في مجموعة مقاييس، عليك استخدام طريقة QUERY المخصّصة لإرسال طلبات البحث. يجب أن يحدّد كل طلب بحث دقة ونطاقًا زمنيًا. بالإضافة إلى المقاييس التي تريد الوصول إليها، عليك تحديد السمات التي يجب استخدامها لعرض تفاصيل عمليات التجميع.

يجب توخي الحذر عند طلب المخططات الزمنية لطلب النطاقات الزمنية، بحيث يكون حجم النطاق الزمني متناسبًا عكسيًا مع حجم تطبيقك وعدد التفاصيل. على سبيل المثال، يجب أن يختار التطبيق الكبير عددًا أقل من الأيام في طلب بحث واحد لتجنُّب انتهاء مهلة طلب البحث بسبب قراءة الكثير من البيانات.

مجموعات المقاييس المتاحة

يعرض الفهرس أدناه جميع نقاط النهاية والبيانات المرتبطة التي يمكنك طلبها.

مجموعة المقاييس الوصف المقاييس المتاحة
vitals.anrrate يحتوي على بيانات أخطاء ANR مدمجة مع بيانات الاستخدام لإنشاء مقياس موحّد مستقل عن عدد المستخدمين. anrRate (google.type.Decimal): النسبة المئوية للمستخدمين المميّزين في فترة التجميع الذين واجهوا خطأ ANR واحدًا على الأقل.
anrRate7dUserWeighted (google.type.Decimal): المتوسّط المرجّح حسب المستخدم لمقياس anrRate في الأيام السبعة حتى التاريخ المحدّد وضمنه.
anrRate28dUserWeighted (google.type.Decimal): المتوسّط المرجّح حسب المستخدم لمقياس anrRate في الأيام الـ 28 حتى التاريخ المحدّد وضمنه.
userPerceivedAnrRate (google.type.Decimal): النسبة المئوية للمستخدمين المميّزين في فترة التجميع الذين واجهوا خطأ ANR واحدًا على الأقل من الأخطاء التي لاحظها المستخدمون. في الوقت الحالي، لا يتم احتساب سوى أخطاء ANR التي تخص "إرسال الإدخال".
userPerceivedAnrRate7dUserWeighted (google.type.Decimal): المتوسّط المرجّح حسب المستخدم لمقياس userPerceivedAnrRate في الأيام السبعة حتى التاريخ المحدّد وضمنه.
userPerceivedAnrRate28dUserWeighted (google.type.Decimal): المتوسّط المرجّح حسب المستخدم لمقياس userPerceivedAnrRate في الأيام الـ 28 حتى التاريخ المحدّد وضمنه.
distinctUsers (google.type.Decimal): العدد التقريبي للمستخدمين الذين كانت البيانات متاحة لهم في فترة التجميع.
vitals.crashrate يحتوي على بيانات الأعطال مدمجة مع بيانات الاستخدام لإنشاء مقياس موحّد مستقل عن عدد المستخدمين. crashRate (google.type.Decimal): النسبة المئوية للمستخدمين المميّزين في فترة التجميع الذين واجهوا عطلاً واحدًا على الأقل.
crashRate7dUserWeighted (google.type.Decimal): المتوسّط المرجّح حسب المستخدم لمقياس crashRate في الأيام السبعة حتى التاريخ المحدّد وضمنه.
crashRate28dUserWeighted (google.type.Decimal): المتوسّط المرجّح حسب المستخدم لمقياس crashRate في الأيام الـ 28 حتى التاريخ المحدّد وضمنه.
userPerceivedCrashRate (google.type.Decimal): النسبة المئوية للمستخدمين المميّزين في فترة التجميع الذين واجهوا عطلاً واحدًا على الأقل أثناء استخدام التطبيق بنشاط.
userPerceivedCrashRate7dUserWeighted (google.type.Decimal): المتوسّط المرجّح حسب المستخدم لمقياس userPerceivedCrashRate في الأيام السبعة حتى التاريخ المحدّد وضمنه.
userPerceivedCrashRate28dUserWeighted (google.type.Decimal): المتوسّط المرجّح حسب المستخدم لمقياس userPerceivedCrashRate في الأيام الـ 28 حتى التاريخ المحدّد وضمنه.
distinctUsers (google.type.Decimal): العدد التقريبي للمستخدمين الذين كانت البيانات متاحة لهم في فترة التجميع.
vitals.lmkrate يحتوي على بيانات أعطال "إغلاق التطبيقات بسبب نقص الذاكرة" (LMK) مدمجة مع بيانات الاستخدام لإنشاء مقياس موحّد مستقل عن عدد المستخدمين. userPerceivedLmkRate (google.type.Decimal): النسبة المئوية للمستخدمين المميّزين في فترة التجميع الذين واجهوا عطلاً واحدًا على الأقل من أعطال "إغلاق التطبيقات بسبب نقص الذاكرة" (LMK) أثناء استخدامهم تطبيقك بنشاط. يُعتبر التطبيق قيد الاستخدام النشط إذا كان يعرض أي نشاط أو ينفّذ أي خدمة تعمل في المقدّمة.
userPerceivedLmkRate7dUserWeighted (google.type.Decimal): المتوسّط المرجّح حسب المستخدم لمقياس userPerceivedLmkRate في الأيام السبعة حتى التاريخ المحدّد وضمنه.
userPerceivedLmkRate28dUserWeighted (google.type.Decimal): المتوسّط المرجّح حسب المستخدم لمقياس userPerceivedLmkRate في الأيام الـ 28 حتى التاريخ المحدّد وضمنه.
distinctUsers (google.type.Decimal): العدد التقريبي للمستخدمين الذين كانت البيانات متاحة لهم في فترة التجميع.
vitals.excessivewakeuprate يحتوي على بيانات عدد عمليات التنشيط في AlarmManager مدمجة مع بيانات حالة العملية لإنشاء مقياس موحّد مستقل عن عدد المستخدمين. excessiveWakeupRate (google.type.Decimal): النسبة المئوية للمستخدمين المميّزين في فترة التجميع الذين تم إجراء أكثر من 10 عمليات تنشيط لهم في الساعة. excessiveWakeupRate7dUserWeighted (google.type.Decimal): المتوسّط المرجّح حسب المستخدم لمقياس excessiveWakeupRate في الأيام السبعة حتى التاريخ المحدّد وضمنه.
excessiveWakeupRate28dUserWeighted (google.type.Decimal): المتوسّط المرجّح حسب المستخدم لمقياس excessiveWakeupRate في الأيام الـ 28 حتى التاريخ المحدّد وضمنه.
distinctUsers (google.type.Decimal): العدد التقريبي للمستخدمين الذين كانت البيانات متاحة لهم في فترة التجميع.
vitals.stuckbackgroundwakelockrate يحتوي على بيانات مدة قفل التنشيط في PowerManager مدمجة مع بيانات حالة العملية لإنشاء مقياس موحّد مستقل عن عدد المستخدمين. stuckBgWakelockRate (google.type.Decimal): النسبة المئوية للمستخدمين المميّزين في فترة التجميع الذين تم الاحتفاظ بقفل التنشيط لديهم في الخلفية لأكثر من ساعة واحدة. stuckBgWakelockRate7dUserWeighted (google.type.Decimal): المتوسّط المرجّح حسب المستخدم لمقياس stuckBgWakelockRate في الأيام السبعة حتى التاريخ المحدّد وضمنه.
stuckBgWakelockRate28dUserWeighted (google.type.Decimal): المتوسّط المرجّح حسب المستخدم لمقياس stuckBgWakelockRate في الأيام الـ 28 حتى التاريخ المحدّد وضمنه.
distinctUsers (google.type.Decimal): العدد التقريبي للمستخدمين الذين كانت البيانات متاحة لهم في فترة التجميع.
vitals.slowstartrate يحتوي على بيانات بدء تشغيل التطبيق المتأخّر مصنّفة حسب نوع بدء تشغيل التطبيق (على البارد، على الساخن، على الدافئ). slowStartRate (google.type.Decimal): النسبة المئوية للمستخدمين المميّزين في فترة التجميع الذين واجهوا حدث بدء تشغيل متأخّرًا. slowStartRate7dUserWeighted (google.type.Decimal): المتوسّط المرجّح حسب المستخدم لمقياس slowStartRate في الأيام السبعة حتى التاريخ المحدّد وضمنه.
slowStartRate28dUserWeighted (google.type.Decimal): المتوسّط المرجّح حسب المستخدم لمقياس slowStartRate في الأيام الـ 28 حتى التاريخ المحدّد وضمنه.
distinctUsers (google.type.Decimal): العدد التقريبي للمستخدمين الذين كانت البيانات متاحة لهم في فترة التجميع.
vitals.errors.counts يحتوي على أعداد تقارير الأخطاء غير الموحّدة. ملاحظة: لا يتوفّر هذا المصدر حاليًا إلا في الإصدار الأولي v1 من واجهة برمجة التطبيقات.
errorReportCount (google.type.Decimal): العدد المطلق لتقارير الأخطاء الفردية التي تم تلقّيها لتطبيق.

الأبعاد

تتيح كل مجموعة مقاييس مجموعة مميّزة من السمات للفلترة وعرض التفاصيل. يمكنك الاطّلاع على فهرس السمات أدناه للحصول على قائمة بالسمات المتاحة في واجهة برمجة التطبيقات.

السمة الوصف
versionCode رمز إصدار التطبيق الذي كان قيد التشغيل على جهاز المستخدم في وقت جمع البيانات. يمكن تحليل القيمة النصية لهذه السمة كعدد صحيح. يمكنك الاطّلاع هنا على تفاصيل إضافية حول طريقة عمل إصدارات التطبيقات على Android.
countryCode معرّف بلد المستخدم أو منطقته استنادًا إلى عنوان IP الخاص به، ويتم تمثيله كرمز ISO-3166 مكوّن من حرفَين (مثل US للولايات المتحدة).

سمات الجهاز

هذه هي السمات الخاصة بالجهاز وخصائص برامجه وأجهزته.

السمة الوصف
apiLevel مستوى واجهة برمجة التطبيقات لنظام Android الذي كان قيد التشغيل على جهاز المستخدم في وقت جمع البيانات. يمكن تحليل القيمة النصية لهذه السمة كعدد صحيح. يمكنك الاطّلاع هنا على قائمة بإصدارات Android وكيفية ربطها بمستويات واجهة برمجة التطبيقات.
deviceModel معرّف لطراز جهاز معيّن، كما هو محدّد في قائمة الأجهزة في Play Console.
deviceType معرّف لعامل شكل جهاز معيّن، كما هو مستخدَم في قائمة الأجهزة في Play Console.
deviceRamBucket ذاكرة الوصول العشوائي (RAM) للجهاز، بالميغابايت، في مجموعات (3 غيغابايت، 4 غيغابايت، إلخ)
deviceSocMake الشركة المصنّعة لنظام الجهاز الأساسي على شريحة، مثل Samsung. يمكنك الاطّلاع هنا.
deviceSocModel اسم طراز نظام الجهاز الأساسي على شريحة، مثل "Exynos 2100". يمكنك الاطّلاع هنا.
deviceCpuMake الشركة المصنّعة لوحدة المعالجة المركزية (CPU) للجهاز، مثل Qualcomm.
deviceCpuModel طراز وحدة المعالجة المركزية (CPU) للجهاز، مثل "Kryo 240".
deviceGpuMake الشركة المصنّعة لوحدة معالجة الرسومات (GPU) للجهاز، مثل ARM.
deviceGpuModel طراز وحدة معالجة الرسومات (GPU) للجهاز، مثل Mali.
deviceGpuVersion إصدار وحدة معالجة الرسومات (GPU) للجهاز، مثل T750.
deviceVulkanVersion إصدار Vulkan للجهاز، مثل "4198400".
deviceGlEsVersion إصدار OpenGL ES للجهاز، مثل "196610".
deviceScreenSize حجم شاشة الجهاز، مثل NORMAL أو LARGE.
deviceScreenDpi كثافة شاشة الجهاز، مثل mdpi أو hdpi.