Method: vitals.anrrate.query

object (TimelineSpec)

אופציונלי. מפרט של הפרמטרים לצבירת נתונים בציר הזמן.

תקופות צבירה נתמכות:

• ‫DAILY: המדדים נצברים במרווחים של תאריכים קלנדריים. בגלל אילוצים היסטוריים, אזור הזמן שמוגדר כברירת מחדל והיחיד שנתמך הוא America/Los_Angeles.
• ‫HOURLY: המדדים נצברים במרווחים של שעה. אזור הזמן שמוגדר כברירת מחדל והיחיד שנתמך הוא UTC.

string

אופציונלי. מאפיינים שמשמשים לפילוח המדדים.

מידות נתמכות:

• ‫apiLevel (string): רמת ה-API של Android שפועלת במכשיר של המשתמש, למשל 26.
• ‫versionCode (int64): גרסת האפליקציה שפעלה במכשיר של המשתמש.
• ‫deviceModel (string): המזהה הייחודי של דגם המכשיר של המשתמש. המזהה הוא בפורמט "deviceBrand/device", כאשר deviceBrand תואם ל-Build.BRAND ו-device תואם ל-Build.DEVICE, לדוגמה, google/coral.
• deviceBrand (string): מזהה ייחודי של מותג המכשיר של המשתמש, למשל google.
• ‫deviceType (string): סוג המכשיר של המשתמש (נקרא גם Form Factor), למשל PHONE.
• ‫countryCode (string): המדינה או האזור של מכשיר המשתמש על סמך כתובת ה-IP שלו, שמיוצגים כקוד ISO-3166 בן 2 אותיות (למשל, US לארצות הברית).
• ‫deviceRamBucket (int64): זיכרון RAM של המכשיר, ב-MB, בקטגוריות (למשל, 1024 ל-1-1.5GB, ‏ 4096 ל-4-6GB).
• deviceSocMake (string): יצרן המערכת על שבב (SoC) הראשית של המכשיר, למשל Samsung. קובץ עזר
• deviceSocModel (string): דגם המערכת על שבב (SoC) הראשית של המכשיר, למשל "Exynos 2100". קובץ עזר
• deviceCpuMake (string): יצרן המעבד (CPU) של המכשיר, למשל Qualcomm.
• ‫deviceCpuModel (string): דגם המעבד (CPU) של המכשיר, למשל "Kryo 240".
• deviceGpuMake (string): יצרן ה-GPU של המכשיר, למשל ARM.
• deviceGpuModel (string): דגם ה-GPU של המכשיר, למשל Mali.
• deviceGpuVersion (string): גרסת המעבד הגרפי (GPU) של המכשיר, למשל T750.
• deviceVulkanVersion (string): גרסת Vulkan של המכשיר, למשל "4198400".
• ‫deviceGlEsVersion (string): גרסת OpenGL ES של המכשיר, למשל "196610".
• deviceScreenSize (string): גודל המסך של המכשיר, למשל: NORMAL,‏ LARGE.
• ‫deviceScreenDpi (string): צפיפות המסך של המכשיר, למשל mdpi,‏ hdpi.

string

אופציונלי. המדדים לצבירה.

מדדים נתמכים:

• 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 הימים האחרונים. הערכים היומיים משוקללים לפי מספר המשתמשים הייחודיים באותו יום. אין תמיכה ברמת פירוט של HOURLY (שעתית).
• ‫userPerceivedAnrRate28dUserWeighted (google.type.Decimal): הערך הממוצע הנע של userPerceivedAnrRate ב-28 הימים האחרונים. הערכים היומיים משוקללים לפי מספר המשתמשים הייחודיים באותו יום. לא . נתמך ברמת פירוט של שעה.
• distinctUsers (google.type.Decimal): מספר המשתמשים הייחודיים בתקופת הצבירה ששימשו כערך הנורמליזציה של המדדים anrRate ו-userPerceivedAnrRate. משתמש נספר במדד הזה אם הוא השתמש באפליקציה בחזית במהלך תקופת הצבירה. חשוב לא לצבור את הספירה הזו עוד יותר, כי זה עלול לגרום לכך שמשתמשים ייספרו כמה פעמים. הערך מעוגל לכפולה הקרובה ביותר של 10, 100, 1,000 או 1,000,000, בהתאם לגודל הערך.

string

אופציונלי. מסננים שאפשר להחיל על הנתונים. ביטוי הסינון תואם לתקן AIP-160 ותומך בסינון לפי שוויון של כל מאפייני הפירוט.

integer

אופציונלי. הגודל המקסימלי של הנתונים שמוחזרים.

אם לא מציינים ערך, יוחזרו עד 1,000 שורות. הערך המקסימלי הוא 10,000. ערכים גבוהים יותר יומרו ל-10,000.

string

אופציונלי. טוקן של דף שהתקבל מקריאה קודמת. צריך להזין את הטוקן כדי לאחזר את הדף הבא.

כשמבצעים חלוקה לעמודים, כל הפרמטרים האחרים שסופקו לבקשה חייבים להיות זהים לקריאה שסיפקה את הטוקן של הדף.

enum (UserCohort)

אופציונלי. תצוגת המשתמש שצריך לבחור. נתוני הפלט יתאימו לתצוגה שנבחרה.

ערכים נתמכים:

• OS_PUBLIC כדי לבחור נתונים מכל הגרסאות של Android שפורסמו באופן ציבורי. זוהי אפשרות ברירת המחדל. תמיכה בכל המאפיינים שצוינו למעלה.
• APP_TESTERS כדי לבחור נתונים ממשתמשים שהביעו הסכמה להיות בודקים. תמיכה בכל המאפיינים שצוינו למעלה.
• OS_BETA כדי לבחור נתונים רק מגרסאות בטא של Android, לא כולל נתונים מגרסאות Android שהושקו. אפשר להשתמש רק במאפיינים הבאים:

• ‫versionCode (int64): גרסת האפליקציה שפעלה במכשיר של המשתמש.

• osBuild (string): גרסת ה-OS של מכשיר המשתמש, לדוגמה, "T1B2.220916.004".