Method: vitals.lmkrate.query

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

בקשת HTTP

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/lmkRateMetricSet}:query

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

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

פרמטרים
name

string

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

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

גוף הבקשה

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

ייצוג ב-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): הסוג (שנקרא גם גורם צורה) של המכשיר של המשתמש, למשל: PHONE.
  • ‫countryCode (string): המדינה או האזור של המכשיר של המשתמש על סמך כתובת ה-IP שלו, שמיוצגים כקוד ISO-3166 בן 2 אותיות (למשל, US לארצות הברית).
  • ‫deviceRamBucket (int64): זיכרון ה-RAM של המכשיר, במגה-בייט, בדליים (3GB,‏ 4GB וכו').
  • ‫deviceSocMake (string): יצרן המערכת הראשית על שבב של המכשיר, למשל, סמסונג. חומרי עזר
  • ‫deviceSocModel (string): דגם המערכת הראשית על שבב במכשיר, למשל: ‫Exynos 2100. חומרי עזר
  • ‫deviceCpuMake (string): יצרן המעבד של המכשיר, למשל, Qualcomm.
  • ‫deviceCpuModel (string): דגם המעבד (CPU) של המכשיר, למשל: ‪"Kryo 240".
  • ‫deviceGpuMake (string): יצרן יחידת ה-GPU של המכשיר, לדוגמה: ARM.
  • ‫deviceGpuModel (string): דגם ה-GPU של המכשיר, למשל: מאלי.
  • ‫deviceGpuVersion (string): גרסת ה-GPU של המכשיר, למשל, T750.
  • ‫deviceVulkanVersion (string): גרסת Vulkan של המכשיר, למשל: ‫"4198400".
  • ‫deviceGlEsVersion (string): גרסת OpenGL ES של המכשיר, לדוגמה: ‫"196610".
  • ‫deviceScreenSize (string): גודל המסך של המכשיר, למשל NORMAL, LARGE.
  • ‫deviceScreenDpi (string): צפיפות המסך של המכשיר, למשל mdpi,‏ hdpi.
metrics[]

string

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

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

  • ‫userPerceivedLmkRate (google.type.Decimal): אחוז המשתמשים הייחודיים בתקופת הצבירה שחוו לפחות אירוע LMK אחד בזמן שהם השתמשו באופן פעיל באפליקציה (אירוע LMK שהשפיע על המשתמש). אפליקציה נחשבת בשימוש פעיל אם היא מציגה פעילות כלשהי או מבצעת שירות כלשהו בחזית.
  • ‫userPerceivedLmkRate7dUserWeighted (google.type.Decimal): ערך הממוצע הנע של userPerceivedLmkRate ב-7 הימים האחרונים. הערכים היומיים משוקללים לפי מספר המשתמשים הייחודיים באותו יום.
  • ‫userPerceivedLmkRate28dUserWeighted (google.type.Decimal): ערך הממוצע הנע של userPerceivedLmkRate ב-28 הימים האחרונים. הערכים היומיים משוקללים לפי מספר המשתמשים הייחודיים באותו יום.
  • ‫distinctUsers (google.type.Decimal): מספר המשתמשים הייחודיים בתקופת הצבירה ששימשו כערך נורמליזציה למדדים userPerceivedLmkRate. משתמש נספר במדד הזה אם הוא השתמש באפליקציה בחזית במהלך תקופת הצבירה. חשוב להיזהר ולא לצבור את המספר הזה, כי יכול להיות שמשתמשים ייספרו כמה פעמים. הערך מעוגל לכפולה הקרובה ביותר של 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): גרסת ה-OS במכשיר של המשתמש, לדוגמה: ‪"T1B2.220916.004".

גוף התשובה

הודעת תגובה לגבי lmkrate.query.

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

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

object (MetricsRow)

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

string

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

היקפי הרשאה

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

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

מידע נוסף זמין במאמר בנושא OAuth 2.0 Overview.