Method: vitals.crashrate.query

שולחת שאילתה על המדדים בקבוצת המדדים.

בקשת HTTP

POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/crashRateMetricSet}:query

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של נתיב

פרמטרים
name

string

חובה. שם המשאב

פורמט: apps/{app}/crashRateMetricSet

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
שדות
timelineSpec

object (TimelineSpec)

מפרט הפרמטרים של הצבירה בציר הזמן.

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

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

string

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

מאפיינים נתמכים:

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

string

מדדים לצבירה.

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

  • crashRate (google.type.Decimal): אחוז המשתמשים הייחודיים בתקופת הצבירה שהתרחשה בהם קריסה אחת לפחות.
  • crashRate7dUserWeighted (google.type.Decimal): הערך הממוצע המצטבר של crashRate ב-7 הימים האחרונים. הערכים היומיים משוקללים לפי מספר המשתמשים הייחודיים באותו יום.
  • crashRate28dUserWeighted (google.type.Decimal): הערך הממוצע המצטבר של crashRate ב-28 הימים האחרונים. הערכים היומיים משוקללים לפי מספר המשתמשים הייחודיים באותו יום. אין תמיכה ברמת פירוט של HOURLY.
  • userPerceivedCrashRate (google.type.Decimal): אחוז המשתמשים הייחודיים בתקופת הצבירה שזוהתה בהם קריסה אחת לפחות בזמן שהם השתמשו באפליקציה באופן פעיל (קריסה שהשפיעה על המשתמשים). אפליקציה נחשבת לשימוש פעיל אם היא מציגה פעילות כלשהי או מבצעת שירות כלשהו בחזית.
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal): הערך הממוצע המצטבר של userPerceivedCrashRate ב-7 הימים האחרונים. הערכים היומיים משוקללים לפי מספר המשתמשים הייחודיים באותו יום. אין תמיכה ברמת פירוט של HOURLY.
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal): הערך הממוצע המצטבר של userPerceivedCrashRate ב-28 הימים האחרונים. הערכים היומיים משוקללים לפי מספר המשתמשים הייחודיים באותו יום. אין תמיכה ברמת פירוט של HOURLY.
  • distinctUsers (google.type.Decimal): מספר המשתמשים הייחודיים בתקופת הצבירה ששימשו כערך הנירמול במדדים crashRate ו-userPerceivedCrashRate. משתמש נספר במדד הזה אם הוא השתמש באפליקציה באופן פעיל במהלך תקופת הצבירה. אפליקציה נחשבת לשימוש פעיל אם היא מציגה פעילות כלשהי או מבצעת שירות כלשהו בחזית. אין לכלול את המספר הזה בפירוט רב יותר, מפני שהדבר עלול לגרום לכך שמשתמשים ייספרו כמה פעמים. הערך מעוגל לכפולה הקרובה ביותר של 10, 100, 1,000 או 1,000,000, בהתאם למידת הגודל של הערך.
filter

string

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

pageSize

integer

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

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

pageToken

string

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

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

userCohort

enum (UserCohort)

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

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

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

  • osBuild (string): גרסת build של מערכת ההפעלה של מכשיר המשתמש, למשל, "T1B2.220916.004".

גוף התגובה

הודעת תשובה לגבי crashrate.query.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:

ייצוג JSON
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
שדות
rows[]

object (MetricsRow)

הוחזרו שורות נתונים.

nextPageToken

string

אסימון המשך לאחזור דף הנתונים הבא.

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/playdeveloperreporting

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.