تتيح لك واجهة برمجة التطبيقات 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.crashrate |
تحتوي على بيانات الأعطال مدمجة مع بيانات الاستخدام لإنتاج مقياس موحّد مستقل عن عدد المستخدمين. |
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): العدد التقريبي للمستخدمين الذين توفّرت بياناتهم خلال فترة التجميع. |
vitals.lmkrate
|
تحتوي على بيانات أعطال "إغلاق التطبيقات بسبب نقص الذاكرة" (LMK) مدمجة مع بيانات الاستخدام لإنتاج مقياس موحّد لا يعتمد على عدد المستخدمين. |
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.slowstartuprate |
يحتوي على بيانات بدء تشغيل التطبيق المتأخِّر مقسَّمة حسب نوع بدء تشغيل التطبيق (على البارد، وإعادة التشغيل البطيء، وإعادة التشغيل السريع). |
slowStartRate (google.type.Decimal): النسبة المئوية للمستخدمين المختلفين في فترة التجميع الذين سجّلوا حدث بدء تشغيل بطيء.
slowStartRate7dUserWeighted (google.type.Decimal): متوسّط مقياس slowStartRate المرجّح حسب المستخدم خلال 7 أيام حتى التاريخ المحدّد وضمنه. slowStartRate28dUserWeighted (google.type.Decimal): متوسط مقياس slowStartRate المرجّح حسب المستخدم خلال الـ 28 يومًا حتى التاريخ المحدّد. distinctUsers (google.type.Decimal): العدد التقريبي للمستخدمين الذين توفّرت بياناتهم خلال فترة التجميع. |
vitals.errors.counts |
يحتوي على أعداد تقارير الأخطاء غير المعدَّلة. |
يُرجى العِلم أنّ هذا المرجع متاح حاليًا في الإصدار الأوّلي 1 من واجهة برمجة التطبيقات فقط. 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 |
تشير إلى الشركة المصنّعة لوحدة المعالجة المركزية في الجهاز، مثل Qualcomm |
deviceCpuModel |
طراز وحدة المعالجة المركزية للجهاز، مثل "Kryo 240". |
deviceGpuMake |
ماركة وحدة معالجة الرسومات (GPU) للجهاز، مثل ARM. |
deviceGpuModel |
طراز وحدة معالجة الرسومات في الجهاز، مثل مالي |
deviceGpuVersion |
إصدار وحدة معالجة الرسومات في الجهاز، مثل T750. |
deviceVulkanVersion |
إصدار Vulkan على الجهاز، مثل "4198400". |
deviceGlEsVersion |
إصدار OpenGL ES على الجهاز، مثل "196610". |
deviceScreenSize |
حجم شاشة الجهاز، مثل NORMAL, LARGE. |
deviceScreenDpi |
كثافة الشاشة على الجهاز، مثل mdpi أو hdpi |