Method: vitals.lmkrate.query

object (TimelineSpec)

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

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

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

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 של המכשיר, ב-MB, בדליים (למשל, 1024 ל-‎1-1.5GB, ‏ 4096 ל-‎4-6GB).
• ‫deviceSocMake (string): יצרן המערכת הראשית על שבב (SoC) של המכשיר, למשל Samsung. חומרי עזר
• ‫deviceSocModel (string): דגם של המערכת הראשית על שבב (SoC) של המכשיר, לדוגמה, Exynos 2100. חומרי עזר
• ‫deviceCpuMake (string): יצרן המעבד של המכשיר, למשל Qualcomm.
• ‫deviceCpuModel (string): דגם המעבד (CPU) של המכשיר, למשל, Kryo 240.
• ‫deviceGpuMake (string): סוג ה-GPU של המכשיר, למשל ARM.
• ‫deviceGpuModel (string): דגם ה-GPU של המכשיר, למשל Mali.
• ‫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): אחוז המשתמשים הייחודיים בתקופת הצבירה שחוו לפחות אירוע 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, בהתאם לגודל הערך.

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): גרסת ה-OS של המכשיר של המשתמש, לדוגמה, T1B2.220916.004.