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

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

الحداثة

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

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

طلبات البيانات

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

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

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

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

مجموعة المقاييس الوصف المقاييس المتاحة
vitals.anrrate يحتوي على بيانات أخطاء ANR مدمَجة مع بيانات الاستخدام لإنتاج مقياس موحّد مستقل عن عدد المستخدمين. anrRate (google.type.Decimal): النسبة المئوية للمستخدمين المختلفين في فترة التجميع الذين واجهوا خطأ ANR واحدًا على الأقل.
anrRate7dUserWeighted (google.type.Decimal): يمثّل هذا الحقل المتوسط المرجّح للمستخدمين لمقياس anrRate خلال 7 أيام حتى التاريخ المحدّد ضِمنًا.
anrRate28dUserWeighted (google.type.Decimal): متوسط مقياس anrRate المرجّح حسب المستخدم خلال 28 يومًا حتى التاريخ المحدّد ضِمنًا.
userPerceivedAnrRate (google.type.Decimal): النسبة المئوية للمستخدمين المختلفين في فترة التجميع الذين واجهوا خطأ ANR واحدًا على الأقل لاحظه المستخدم. في الوقت الحالي، يتم احتساب أخطاء ANR المتعلقة بـ "إرسال الإدخال" فقط.
userPerceivedAnrRate7dUserWeighted (google.type.Decimal): متوسّط مقياس userPerceivedAnrRate المرجّح حسب المستخدم خلال 7 أيام حتى التاريخ المحدّد ضِمنًا.
userPerceivedAnrRate28dUserWeighted (google.type.Decimal): متوسّط مقياس userPerceivedAnrRate المرجّح حسب المستخدم خلال 28 يومًا حتى التاريخ المحدّد ضِمنًا.
distinctUsers (google.type.Decimal): العدد التقريبي للمستخدمين الذين توفّرت بياناتهم خلال فترة التجميع.
vitals.anonrssandswapmemoryusage يحتوي على بيانات استخدام ذاكرة RSS المجهولة ومساحة الإبدال مع بيانات الاستخدام. anonRssAndSwapMemoryUsageP50 (google.type.Decimal): الشريحة المئوية الخمسون من استخدام ذاكرة RSS المجهولة ومساحة الإبدال.
anonRssAndSwapMemoryUsageP75 (google.type.Decimal): الشريحة المئوية الخامسة والسبعون من استخدام ذاكرة RSS المجهولة ومساحة الإبدال.
anonRssAndSwapMemoryUsageP90 (google.type.Decimal): الشريحة المئوية التسعون لاستخدام ذاكرة RSS المجهولة ومساحة الإبدال.
anonRssAndSwapMemoryUsageP95 (google.type.Decimal): الشريحة المئوية الخامسة والتسعون من استخدام ذاكرة RSS المجهولة ومساحة الإبدال.
anonRssAndSwapMemoryUsageP99 (google.type.Decimal): الشريحة المئوية الـ 99 من استخدام ذاكرة RSS المجهولة ومساحة الإبدال.
distinctUsers (google.type.Decimal): عدد المستخدمين الفريدين الذين تم تسجيل مقاييس الذاكرة لهم خلال فترة التجميع. يجب الحرص على عدم تجميع هذا العدد بشكل أكبر، لأنّ ذلك قد يؤدي إلى احتساب المستخدمين عدة مرات. يتم تقريب القيمة إلى أقرب مضاعف للعدد 10 أو 100 أو 1,000 أو 1,000,000، وذلك استنادًا إلى حجم القيمة.
vitals.bitmapmemoryusage يحتوي على بيانات استخدام ذاكرة الصور النقطية مدمجة مع بيانات الاستخدام. bitmapMemoryUsageP50 (google.type.Decimal): الشريحة المئوية الخمسون لاستخدام ذاكرة الصور النقطية.
bitmapMemoryUsageP75 (google.type.Decimal): الشريحة المئوية الخامسة والسبعون لاستخدام ذاكرة الصور النقطية.
bitmapMemoryUsageP90 (google.type.Decimal): الشريحة المئوية التسعون لاستخدام الذاكرة في الصور النقطية.
bitmapMemoryUsageP95 (google.type.Decimal): الشريحة المئوية الخامسة والتسعون من استخدام ذاكرة الصورة النقطية.
bitmapMemoryUsageP99 (google.type.Decimal): الشريحة المئوية الـ 99 من استخدام ذاكرة الصورة النقطية.
distinctUsers (google.type.Decimal): عدد المستخدمين الفريدين الذين تم تسجيل مقاييس الذاكرة لهم خلال فترة التجميع. يجب الحرص على عدم تجميع هذا العدد بشكل أكبر، لأنّ ذلك قد يؤدي إلى احتساب المستخدمين عدة مرات. يتم تقريب القيمة إلى أقرب مضاعف للعدد 10 أو 100 أو 1,000 أو 1,000,000، وذلك استنادًا إلى حجم القيمة.
vitals.crashrate يحتوي على بيانات الأعطال مدمجة مع بيانات الاستخدام لإنتاج مقياس موحّد مستقل عن أعداد المستخدمين. crashRate (google.type.Decimal): النسبة المئوية للمستخدمين المميّزين في فترة التجميع الذين واجهوا عطلاً واحدًا على الأقل.
crashRate7dUserWeighted (google.type.Decimal): متوسّط معدّل الأعطال المرجّح حسب المستخدم خلال 7 أيام حتى التاريخ المحدّد ضِمنًا.
crashRate28dUserWeighted (google.type.Decimal): متوسط معدّل الأعطال المرجّح حسب المستخدمين خلال 28 يومًا حتى التاريخ المحدّد ضِمنًا.
userPerceivedCrashRate (google.type.Decimal): النسبة المئوية للمستخدمين المختلفين في فترة التجميع الذين واجهوا عطلاً واحدًا على الأقل أثناء استخدام التطبيق بشكل نشط.
userPerceivedCrashRate7dUserWeighted (google.type.Decimal): متوسّط مقياس userPerceivedCrashRate المرجّح حسب المستخدمين خلال 7 أيام حتى التاريخ المحدّد ضِمنًا.
userPerceivedCrashRate28dUserWeighted (google.type.Decimal): متوسط مقياس userPerceivedCrashRate المرجّح حسب المستخدمين خلال الـ 28 يومًا حتى التاريخ المحدّد ضِمنًا.
distinctUsers (google.type.Decimal): العدد التقريبي للمستخدمين الذين توفّرت بياناتهم خلال فترة التجميع.
vitals.lmkrate يحتوي على بيانات LMK (low memory kill) مدمَجة مع بيانات الاستخدام لإنتاج مقياس موحّد لا يعتمد على عدد المستخدمين. userPerceivedLmkRate (google.type.Decimal): هي النسبة المئوية للمستخدمين المختلفين خلال فترة التجميع الذين واجهوا عُطلاً واحدًا على الأقل من نوع "إغلاق التطبيقات بسبب نقص الذاكرة" (LMK) أثناء استخدامهم تطبيقك بشكل نشط. ويُعد التطبيق قيد الاستخدام النشط إذا كان يعرض أي نشاط أو ينفّذ أي خدمة تعمل في المقدّمة.
userPerceivedLmkRate7dUserWeighted (google.type.Decimal): متوسّط مقياس userPerceivedLmkRate المرجّح حسب المستخدم خلال 7 أيام حتى التاريخ المحدّد ضِمنًا.
userPerceivedLmkRate28dUserWeighted (google.type.Decimal): متوسط مقياس userPerceivedLmkRate المرجّح حسب المستخدم خلال 28 يومًا حتى التاريخ المحدّد.
distinctUsers (google.type.Decimal): العدد التقريبي للمستخدمين الذين توفّرت بياناتهم خلال فترة التجميع.
vitals.excessivewakeuprate تحتوي على بيانات عدد عمليات التنشيط في AlarmManager مدمَجة مع بيانات حالة العملية لإنتاج مقياس موحّد مستقل عن عدد المستخدمين. excessiveWakeupRate (google.type.Decimal): تشير إلى النسبة المئوية للمستخدمين المختلفين خلال فترة التجميع الذين تم إجراء أكثر من 10 عمليات تنشيط في الساعة على أجهزتهم. excessiveWakeupRate7dUserWeighted (google.type.Decimal): متوسّط مقياس excessiveWakeupRate المرجّح حسب المستخدم خلال 7 أيام حتى التاريخ المحدّد ضِمنًا.
excessiveWakeupRate28dUserWeighted (google.type.Decimal): متوسط مقياس excessiveWakeupRate المرجّح حسب المستخدم خلال الـ 28 يومًا حتى التاريخ المحدّد ضِمنًا.
distinctUsers (google.type.Decimal): العدد التقريبي للمستخدمين الذين توفّرت بياناتهم خلال فترة التجميع.
vitals.stuckbackgroundwakelockrate يحتوي على بيانات مدة قفل التنشيط في PowerManager مدمجة مع بيانات حالة العملية لإنتاج مقياس موحّد مستقل عن أعداد المستخدمين. stuckBgWakelockRate (google.type.Decimal): تشير إلى النسبة المئوية للمستخدمين المميّزين خلال فترة التجميع الذين تم إبقاء قفل التنشيط في الخلفية لمدة تزيد عن ساعة واحدة. stuckBgWakelockRate7dUserWeighted (google.type.Decimal): متوسط مقياس stuckBgWakelockRate المرجّح حسب المستخدم خلال 7 أيام حتى التاريخ المحدد ضِمنًا.
stuckBgWakelockRate28dUserWeighted (google.type.Decimal): متوسط مقياس stuckBgWakelockRate المرجّح حسب المستخدم خلال 28 يومًا حتى التاريخ المحدد ضِمنًا.
distinctUsers (google.type.Decimal): العدد التقريبي للمستخدمين الذين توفّرت بياناتهم خلال فترة التجميع.
vitals.slowstartrate يحتوي على بيانات بدء تشغيل التطبيق المتأخِّر مقسَّمة حسب نوع بدء تشغيل التطبيق (على البارد، وإعادة التشغيل البطيء، وإعادة التشغيل السريع). slowStartRate (google.type.Decimal): النسبة المئوية للمستخدمين المميّزين خلال فترة التجميع الذين سجّلوا حدث بدء تشغيل بطيء. slowStartRate7dUserWeighted (google.type.Decimal): متوسط مقياس slowStartRate المرجّح حسب المستخدم خلال 7 أيام حتى التاريخ المحدد ضمناً
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 ماركة وحدة معالجة الرسومات في الجهاز، مثل ARM
deviceGpuModel طراز وحدة معالجة الرسومات (GPU) بالجهاز، مثل Mali
deviceGpuVersion يشير إلى إصدار وحدة معالجة الرسومات (GPU) للجهاز، مثل T750.
deviceVulkanVersion إصدار Vulkan على الجهاز، مثل "4198400".
deviceGlEsVersion إصدار OpenGL ES على الجهاز، مثل "196610".
deviceScreenSize حجم شاشة الجهاز، مثل NORMAL أو LARGE
deviceScreenDpi كثافة الشاشة على الجهاز، مثل mdpi أو hdpi