Method: vitals.excessivewakeuprate.query

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

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
name

string

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

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

גוף הבקשה

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

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

object (TimelineSpec)

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

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

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

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.
metrics[]

string

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

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

  • ‫excessiveWakeupRate (google.type.Decimal): אחוז המשתמשים הייחודיים בתקופת הצבירה שהאפליקציה יצאה ממצב שינה יותר מ-10 פעמים בשעה במכשירים שלהם.
  • ‫excessiveWakeupRate7dUserWeighted (google.type.Decimal): ערך הממוצע הנע של excessiveWakeupRate ב-7 הימים האחרונים. הערכים היומיים משוקללים לפי מספר המשתמשים הנפרדים באותו יום.
  • ‫excessiveWakeupRate28dUserWeighted (google.type.Decimal): ערך הממוצע הנע של excessiveWakeupRate ב-28 הימים האחרונים. הערכים היומיים משוקללים לפי מספר המשתמשים הנפרדים באותו יום.
  • ‫distinctUsers (google.type.Decimal): מספר המשתמשים הייחודיים בתקופת הצבירה ששימשו כערך נורמליזציה למדד excessiveWakeupRate. משתמש נספר במדד הזה אם האפליקציה ביצעה פעולה כלשהי במכשיר, כלומר לא רק שימוש פעיל בחזית אלא גם פעולה ברקע. חשוב לא לצבור את הספירה הזו עוד יותר, כי זה עלול לגרום לכך שמשתמשים ייספרו כמה פעמים. הערך מעוגל לכפולה הקרובה ביותר של 10, 100, 1,000 או 1,000,000, בהתאם לגודל הערך.
filter

string

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

integer

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

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

string

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

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

enum (UserCohort)

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

גוף התשובה

הודעת התשובה של excessivewakeuprate.query.

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

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

object (MetricsRow)

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

string

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

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.