تتيح لك واجهة برمجة التطبيقات Google Play Developer Reporting API الوصول إلى معلومات حول المقاييس والتقارير والمخططات حول تطبيقاتك. لتسهيل استخدام واجهة برمجة التطبيقات قدر الإمكان، تعمل مجموعات المقاييس على توحيد الوصول إلى المقياس. مجموعة المقاييس هي مجموعة منطقية من المقاييس ذات الصلة التي تشترك في سمات مشتركة (مثل الحداثة والدقة)، ويمكن طلبها معًا. تحتوي مجموعة المقاييس أيضًا على عدد من الأبعاد التي يمكنك استخدامها لتصفية التصنيفات وإنتاجها. ويمكن تقسيم جميع المقاييس أو فلترتها حسب جميع السمات المتاحة، ما لم يُذكر خلاف ذلك.
الحداثة
يقدّم كل مورد لمجموعة مقاييس طريقة GET عادية لاسترداد
تاريخ ووقت آخر نقطة بيانات متاحة، وتُعرف هذه العملية باسم "الحداثة". وبما أنّ مجموعة المقاييس يمكن أن تتيح
درجات دقة متعددة (يوميًا كل ساعة)، تعرض العملية قيمة حداثة واحدة
لكل دقة متوافقة.
يمكنك استخدام قيمة الحداثة مباشرةً كنقطة نهاية في نطاق وقت طلب البحث.
طلبات البحث عن البيانات
للوصول إلى البيانات في مجموعة مقاييس، عليك استخدام طريقة QUERY المخصّصة لإصدار طلبات البحث.
ويجب على كل طلب بحث تحديد مستوى الدقة والنطاق الزمني. بالإضافة إلى المقاييس التي تريد الوصول إليها، عليك تحديد السمات التي يجب استخدامها لتقسيم التجميعات.
يجب توخي الحذر عند طلب المخططات الزمنية لطلب النطاقات الزمنية، بحيث يتناسب حجم النطاق الزمني عكسيًا مع حجم تطبيقك وعدد التصنيفات التفصيلية. على سبيل المثال، من المفترَض أن يختار تطبيق كبير عددًا أقل من الأيام في طلب بحث واحد لتجنُّب انتهاء مهلة طلب البحث بسبب قراءة بيانات كثيرة جدًا.
مجموعات المقاييس المتاحة
يسرد الفهرس أدناه جميع نقاط النهاية والبيانات المرتبطة بها التي يمكنك طلبها.
| مجموعة المقاييس | الوصف | المقاييس المتاحة |
|---|---|---|
vitals.anrrate |
يحتوي على بيانات أخطاء ANR (بيانات 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.excessivewakeuprate |
يحتوي على تنبيه تنشيط AlarmManager مع بيانات حالة المعالجة لإنشاء مقياس تمت تسويته بشكل مستقل عن أعداد المستخدمين. |
excessiveWakeupRate (google.type.Decimal): النسبة المئوية للمستخدمين المختلفين في فترة التجميع التي تلقّت أكثر من 10 عمليات تنشيط في الساعة.
excessiveWakeupRate7dUserWeighted (google.type.Decimal): المتوسط المرجح بواسطة المستخدم لمقياس OverWakeupRate خلال آخر 7 أيام وحتى التاريخ. exuseiveWakeupRate28dUserWeighted (google.type.Decimal): المتوسط المرجح بواسطة المستخدم لمقياس WakeupRate الزائد خلال 28 يومًا حتى التاريخ. distinctUsers (google.type.Decimal): العدد التقريبي للمستخدمين الذين كانت البيانات متوفرة لهم خلال فترة التجميع. |
vitals.stuckbackgroundwakelockrate |
يحتوي على بيانات مدة تنشيط PowerManager مع بيانات حالة المعالجة لإنشاء مقياس تمت تسويته بشكل مستقل عن أعداد المستخدمين. |
stuckBgWakelockRate (google.type.Decimal): النسبة المئوية للمستخدمين الفريدين خلال فترة التجميع التي تم فيها تنشيط قفل التنشيط في الخلفية لأكثر من ساعة واحدة.
stuckBgWakelockRate7dUserWeighted (google.type.Decimal): المتوسط المرجح بواسطة المستخدم لمقياس
BBWakelockRate في آخر 7 أيام وحتى التاريخ. stuckBgWakelockRate28dUserWeighted (google.type.Decimal): المتوسط المرجح بواسطة المستخدم لمقياس BBWakeLockRate في آخر 28 يومًا حتى التاريخ. distinctUsers (google.type.Decimal): العدد التقريبي للمستخدمين الذين كانت البيانات متوفرة لهم خلال فترة التجميع. |
vitals.slowstartuprate |
يحتوي على بيانات بدء تشغيل بطيئة للتطبيق مقسمة حسب نوع بدء تشغيل التطبيق (بارد، ساخن، ساخن). |
slowStartRate (google.type.Decimal): النسبة المئوية للمستخدمين المختلفين في فترة التجميع التي كان لها حدث بدء بطيء.
slowStartRate7dUserWeighted (google.type.Decimal): المتوسط المُرجَّح لحساب المستخدم
لمقياسlowStartRate خلال آخر 7 أيام وحتى التاريخ. slowStartRate28dUserWeighted (google.type.Decimal): المتوسط المُرجَّح لحساب المستخدم الخاص بمقياس البطيء StartRate خلال 28 يومًا حتى التاريخ. distinctUsers (google.type.Decimal): العدد التقريبي للمستخدمين الذين كانت البيانات متوفرة لهم خلال فترة التجميع. |
vitals.errors.counts |
يحتوي على أعداد تقارير أخطاء غير طبيعية. |
الرجاء ملاحظة: هذا المورد متوفر حاليًا فقط في الإصدار ألفا من واجهة برمجة التطبيقات. errorReportCount (google.type.Decimal): العدد المطلق لتقارير الأخطاء الفردية التي تم تلقّيها بخصوص أحد التطبيقات. |
الأبعاد
تدعم كل مجموعة مقاييس مجموعة مختلفة من الأبعاد للتصفية والتقسيم. ألقِ نظرة على فهرس الأبعاد أدناه للاطّلاع على قائمة بالأبعاد المتوفّرة في واجهة برمجة التطبيقات.
| السمة | الوصف |
|---|---|
versionCode |
رمز إصدار التطبيق الذي كان قيد التشغيل على جهاز المستخدم في وقت التقاط البيانات. يمكن تحليل قيمة السلسلة لهذا البُعد كعدد صحيح. يمكنك الاطّلاع هنا على تفاصيل إضافية حول آلية عمل إصدارات التطبيق على Android. |
countryCode |
تمثّل هذه السمة معرّف بلد المستخدم أو منطقته استنادًا إلى عنوان IP الخاص به، على شكل رمز ISO-3166 مؤلّف من حرفَين (مثل الولايات المتحدة للولايات المتحدة). |
أبعاد الجهاز
هذه هي الأبعاد المتعلقة بالجهاز وخصائص البرامج والأجهزة الخاصة به.
| السمة | الوصف |
|---|---|
apiLevel |
مستوى واجهة برمجة التطبيقات (API) لنظام التشغيل Android الذي تم تشغيله على جهاز المستخدم في وقت التقاط البيانات. يمكن تحليل قيمة السلسلة لهذا البُعد كعدد صحيح. يمكنك الاطّلاع هنا على قائمة بإصدارات Android وكيفية ربطها بمستويات واجهات برمجة التطبيقات. |
deviceModel |
معرّف طراز جهاز محدّد وفقًا لتعريف كتالوج جهاز Play Console |
deviceType |
معرّف عامل معيّن في شكل جهاز حسب كتالوج جهاز Play Console. |
deviceRamBucket |
ذاكرة الوصول العشوائي للجهاز، بالميغابايت، في مجموعات البيانات (3 غيغابايت، 4 غيغابايت، وما إلى ذلك). |
deviceSocMake |
العلامة التجارية للرقاقة الأساسية للنظام على الجهاز، على سبيل المثال، Samsung. يمكنك الاطّلاع هنا. |
deviceSocModel |
اسم طراز رقاقة النظام الأساسية للجهاز، على سبيل المثال، "Exynos 2100". يمكنك الاطّلاع هنا. |
deviceCpuMake |
إنشاء وحدة المعالجة المركزية (CPU) للجهاز، على سبيل المثال، كوالكوم |
deviceCpuModel |
طراز وحدة المعالجة المركزية للجهاز، على سبيل المثال، "Kryo 240". |
deviceGpuMake |
إنشاء وحدة معالجة رسومات للجهاز، على سبيل المثال، تفعيل ARM |
deviceGpuModel |
طراز وحدة معالجة الرسومات للجهاز، على سبيل المثال، مالي |
deviceGpuVersion |
إصدار وحدة معالجة الرسومات للجهاز، على سبيل المثال، T750. |
deviceVulkanVersion |
إصدار Vulkan من الجهاز، مثل "4198400". |
deviceGlEsVersion |
إصدار OpenGL ES من الجهاز، على سبيل المثال، "196610". |
deviceScreenSize |
حجم شاشة الجهاز، على سبيل المثال، عادي، كبير. |
deviceScreenDpi |
كثافة الشاشة للجهاز، على سبيل المثال، mdpi، وhdpi. |