Method: vitals.lmkrate.query

object (TimelineSpec)

اختيارية: تحديد مَعلمات تجميع المخطّط الزمني

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

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

string

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

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

• ‫apiLevel (string): مستوى واجهة برمجة التطبيقات لنظام التشغيل Android الذي كان يعمل على جهاز المستخدم، على سبيل المثال: 26.
• ‫versionCode (int64): إصدار التطبيق الذي كان يعمل على جهاز المستخدم.
• ‫deviceModel (string): معرّف فريد لطراز جهاز المستخدم. يكون شكل المعرّف هو deviceBrand/device، حيث يتوافق deviceBrand مع Build.BRAND ويتوافق device مع Build.DEVICE، على سبيل المثال google/coral.
• ‫deviceBrand (string): معرّف فريد للعلامة التجارية لجهاز المستخدِم، مثل google.
• ‫deviceType (string): نوع جهاز المستخدِم (المعروف أيضًا باسم شكل الجهاز)، مثل هاتف
• ‫countryCode (string): البلد أو المنطقة التي يقع فيها جهاز المستخدِم استنادًا إلى عنوان IP الخاص به، ويتم تمثيلهما كرمز مكوّن من حرفَين وفقًا لمعيار ISO-3166 (مثل US للولايات المتحدة).
• ‫deviceRamBucket (int64): ذاكرة الوصول العشوائي (RAM) للجهاز، بالميغابايت، في حِزم (3 غيغابايت و4 غيغابايت وما إلى ذلك).
• ‫deviceSocMake (string): ماركة نظام الجهاز الأساسي على الشريحة، مثل Samsung المرجع
• ‫deviceSocModel (string): طراز نظام الجهاز الأساسي على الشريحة، مثل ‫"Exynos 2100". المرجع
• ‫deviceCpuMake (string): الشركة المصنّعة لوحدة المعالجة المركزية (CPU) بالجهاز، مثل ‫Qualcomm
• ‫deviceCpuModel (string): طراز وحدة المعالجة المركزية (CPU) للجهاز، مثل ‫"Kryo 240".
• ‫deviceGpuMake (string): يشير إلى الشركة المصنّعة لوحدة معالجة الرسومات في الجهاز، مثل ARM.
• ‫deviceGpuModel (string): طراز وحدة معالجة الرسومات في الجهاز، مثل مالي
• ‫deviceGpuVersion (string): إصدار وحدة معالجة الرسومات في الجهاز، مثل T750.
• ‫deviceVulkanVersion (string): إصدار Vulkan للجهاز، مثل ‫"4198400".
• deviceGlEsVersion (string): إصدار OpenGL ES على الجهاز، مثل ‫"196610".
• deviceScreenSize (string): حجم شاشة الجهاز، مثل NORMAL, LARGE.
• ‫deviceScreenDpi (string): كثافة الشاشة على الجهاز، مثل mdpi وhdpi

string

اختيارية: المقاييس التي سيتم تجميعها

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

• userPerceivedLmkRate (google.type.Decimal): هي النسبة المئوية للمستخدمين المختلفين خلال فترة التجميع الذين واجهوا عطلاً واحدًا على الأقل من نوع "إغلاق التطبيقات بسبب نقص الذاكرة" أثناء استخدامهم تطبيقك بشكل نشط (عطل "إغلاق التطبيقات بسبب نقص الذاكرة" لاحظه المستخدم). يُعتبَر التطبيق قيد الاستخدام النشط إذا كان يعرض أي نشاط أو ينفّذ أي خدمة تعمل في المقدّمة.
• ‫userPerceivedLmkRate7dUserWeighted (google.type.Decimal): متوسط التحرّك لقيمة userPerceivedLmkRate في آخر 7 أيام يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم.
• ‫userPerceivedLmkRate28dUserWeighted (google.type.Decimal): قيمة المتوسط المتحرّك لـ userPerceivedLmkRate في آخر 28 يومًا يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم.
• ‫distinctUsers (google.type.Decimal): عدد المستخدمين المختلفين في فترة التجميع الذين تم استخدامهم كقيمة تسوية لمقاييس userPerceivedLmkRate. يتم احتساب المستخدم في هذا المقياس إذا استخدم التطبيق في المقدّمة خلال فترة التجميع. يجب الحرص على عدم تجميع هذا العدد أكثر من ذلك، لأنّ ذلك قد يؤدي إلى احتساب المستخدمين عدة مرات. يتم تقريب القيمة إلى أقرب مضاعف للعدد 10 أو 100 أو 1,000 أو 1,000,000، وذلك استنادًا إلى حجم القيمة.

string

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

integer

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

إذا لم يتم تحديدها، سيتم عرض 1, 000 صف كحد أقصى. الحدّ الأقصى للقيمة هو 100,000، وسيتم فرض القيمة 100,000 على القيم التي تتجاوز هذا الحدّ.

string

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

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

enum (UserCohort)

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

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

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

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

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