מבוא לקבוצות מדדים

ה-Google Play Developer Reporting API מאפשר לכם לגשת למדדים, לדוחות ולמידע על ציר הזמן של האפליקציות שלכם. כדי לפשט ככל האפשר את השימוש ב-API, קבוצות מדדים מאפשרות גישה סטנדרטית למדדים. קבוצת מדדים היא קיבוץ לוגי של מדדים קשורים שחולקים מאפיינים משותפים (כמו עדכניות וגרנולריות) ואפשר להריץ עליהם שאילתות ביחד. קבוצת מדדים מכילה גם מספר מאפיינים שבהם אפשר להשתמש כדי לסנן או ליצור פירוטים. אלא אם צוין אחרת, אפשר לפרט את כל המדדים או לסנן אותם לפי כל המאפיינים הזמינים.

עדכניות

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

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

שאילתות נתונים

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

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

קבוצות מדדים זמינות

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

קבוצת מדדים תיאור מדדים נתמכים
vitals.anrrate הדוח מכיל נתוני ANR בשילוב עם נתוני שימוש, כדי ליצור מדד מנורמל שלא תלוי במספר המשתמשים. ‫anrRate (google.type.Decimal): אחוז המשתמשים הייחודיים בתקופת הצבירה שחוו לפחות ANR אחד.
anrRate7dUserWeighted (google.type.Decimal): הממוצע המשוקלל לפי משתמש של מדד anrRate ב-7 הימים שעד התאריך כולל.
‫anrRate28dUserWeighted (google.type.Decimal): הממוצע המשוקלל לפי משתמש של המדד anrRate ב-28 הימים האחרונים, כולל התאריך.
userPerceivedAnrRate (google.type.Decimal): אחוז המשתמשים הייחודיים בתקופת הצבירה שחוו לפחות ANR אחד שהשפיע על המשתמשים. נכון לעכשיו, נספרים רק מקרי ANR מסוג Input dispatching (שליחת קלט).
userPerceivedAnrRate7dUserWeighted (google.type.Decimal): הממוצע המשוקלל לפי משתמש של המדד userPerceivedAnrRate ב-7 הימים האחרונים, כולל התאריך.
userPerceivedAnrRate28dUserWeighted (google.type.Decimal): הממוצע המשוקלל לפי משתמשים של המדד userPerceivedAnrRate ב-28 הימים האחרונים, כולל התאריך.
distinctUsers (google.type.Decimal): המספר המשוער של המשתמשים שעבורם הנתונים היו זמינים בתקופת הצבירה.
vitals.crashrate הדוח מכיל נתוני קריסה בשילוב עם נתוני שימוש, כדי ליצור מדד מנורמל שלא תלוי במספר המשתמשים. ‫crashRate (google.type.Decimal): אחוז המשתמשים הייחודיים בתקופת הצבירה שחוו קריסה אחת לפחות.
crashRate7dUserWeighted ‏ (google.type.Decimal): הממוצע המשוקלל לפי משתמשים של מדד crashRate ב-7 הימים שעד התאריך כולל.
crashRate28dUserWeighted (google.type.Decimal): הממוצע המשוקלל לפי משתמשים של המדד crashRate ב-28 הימים עד התאריך כולל.
userPerceivedCrashRate (google.type.Decimal): אחוז המשתמשים הייחודיים בתקופת הצבירה שחוו לפחות קריסה אחת בזמן שהאפליקציה הייתה בשימוש פעיל.
userPerceivedCrashRate7dUserWeighted (google.type.Decimal): הממוצע המשוקלל לפי משתמש של המדד userPerceivedCrashRate ב-7 הימים עד התאריך כולל.
userPerceivedCrashRate28dUserWeighted (google.type.Decimal): הממוצע המשוקלל לפי משתמשים של המדד userPerceivedCrashRate ב-28 הימים עד התאריך כולל.
distinctUsers (google.type.Decimal): המספר המשוער של המשתמשים שעבורם הנתונים היו זמינים בתקופת הצבירה.
vitals.lmkrate הדוח מכיל נתוני LMK (הפסקת תהליכים בגלל מחסור בזיכרון) בשילוב עם נתוני שימוש, כדי ליצור מדד מנורמל שלא תלוי במספר המשתמשים. ‫userPerceivedLmkRate (google.type.Decimal): אחוז המשתמשים הייחודיים בתקופת הצבירה שחוו לפחות אירוע LMK (הפסקת תהליכים בגלל מחסור בזיכרון) בזמן שהם השתמשו באפליקציה באופן פעיל. אפליקציה נחשבת לשימוש פעיל אם היא מציגה פעילות כלשהי או מבצעת שירות כלשהו בחזית.
userPerceivedLmkRate7dUserWeighted (google.type.Decimal): הממוצע המשוקלל לפי משתמש של המדד userPerceivedLmkRate ב-7 הימים עד התאריך כולל.
userPerceivedLmkRate28dUserWeighted ‏ (google.type.Decimal): הממוצע המשוקלל לפי משתמש של המדד userPerceivedLmkRate ב-28 הימים האחרונים, כולל התאריך.
distinctUsers (google.type.Decimal): המספר המשוער של המשתמשים שעבורם הנתונים היו זמינים בתקופת הצבירה.
vitals.excessivewakeuprate מכיל נתונים של ספירת ההתעוררות של AlarmManager בשילוב עם נתונים של מצב התהליך, כדי ליצור מדד מנורמל שלא תלוי בספירת המשתמשים. ‫excessiveWakeupRate (google.type.Decimal): אחוז המשתמשים הייחודיים בתקופת הצבירה שהיו להם יותר מ-10 התעוררויות בשעה. ‫excessiveWakeupRate7dUserWeighted (google.type.Decimal): הממוצע המשוקלל לפי משתמש של המדד excessiveWakeupRate ב-7 הימים עד התאריך כולל.
excessiveWakeupRate28dUserWeighted (google.type.Decimal): הממוצע המשוקלל לפי משתמש של המדד excessiveWakeupRate ב-28 הימים עד התאריך כולל.
distinctUsers (google.type.Decimal): המספר המשוער של המשתמשים שעבורם הנתונים היו זמינים בתקופת הצבירה.
vitals.stuckbackgroundwakelockrate מכיל נתונים של משך הזמן של נעילת המכשיר (wakelock) ב-PowerManager בשילוב עם נתונים של מצב התהליך, כדי ליצור מדד מנורמל שלא תלוי במספר המשתמשים. ‫stuckBgWakelockRate (google.type.Decimal): אחוז המשתמשים הייחודיים בתקופת הצבירה שהייתה להם חסימה של מצב שינה ברקע שנמשכה יותר משעה. ‫stuckBgWakelockRate7dUserWeighted (google.type.Decimal): הממוצע המשוקלל לפי משתמשים של המדד stuckBgWakelockRate ב-7 הימים עד התאריך כולל.
stuckBgWakelockRate28dUserWeighted (google.type.Decimal): The user-weighted average of the stuckBgWakelockRate metric in the 28 days up to and including the date.
distinctUsers (google.type.Decimal): המספר המשוער של המשתמשים שהנתונים שלהם היו זמינים בתקופת הצבירה.
vitals.slowstartuprate הדוח מכיל נתונים על הפעלה איטית של האפליקציה, שמחולקים לפי סוג ההפעלה (cold, warm, hot). ‫slowStartRate (google.type.Decimal): אחוז המשתמשים הייחודיים בתקופת הצבירה שהפעילו אירוע התחלה איטית. ‫slowStartRate7dUserWeighted ‏ (google.type.Decimal): הממוצע המשוקלל לפי משתמש של המדד slowStartRate ב-7 הימים עד התאריך כולל.
slowStartRate28dUserWeighted (google.type.Decimal): הממוצע המשוקלל לפי משתמש של מדד slowStartRate ב-28 הימים עד התאריך כולל.
distinctUsers (google.type.Decimal): המספר המשוער של המשתמשים שהנתונים שלהם היו זמינים בתקופת הצבירה.
vitals.errors.counts מכיל ספירות של דוחות שגיאות לא מנורמלים. הערה: המשאב הזה זמין כרגע רק בגרסת אלפא v1 של ה-API.
errorReportCount (google.type.Decimal): מספר מוחלט של דוחות שגיאה נפרדים שהתקבלו לגבי אפליקציה.

מידות

כל קבוצת מדדים תומכת בקבוצה נפרדת של מימדים לסינון ולפירוט. ברשימת המאפיינים שבהמשך מפורטים המאפיינים שזמינים ב-API.

מאפיין תיאור
versionCode קוד הגרסה של האפליקציה שפעלה במכשיר של המשתמש בזמן שהנתונים נאספו. אפשר לנתח את ערך המחרוזת של המאפיין הזה כמספר שלם. כאן אפשר לקבל פרטים נוספים על אופן הפעולה של ניהול הגרסאות של אפליקציות ב-Android.
countryCode מזהה של המדינה או האזור של המשתמש על סמך כתובת ה-IP שלו, שמוצג כקוד בן 2 אותיות בתקן ISO-3166 (למשל, US לארצות הברית).

מאפייני מכשיר

אלה המאפיינים הספציפיים למכשיר ולמאפייני התוכנה והחומרה שלו.

מאפיין תיאור
apiLevel רמת ה-API של Android שפעלה במכשיר של המשתמש בזמן איסוף הנתונים. אפשר לנתח את ערך המחרוזת של המאפיין הזה כמספר שלם. כאן אפשר לראות את רשימת הגרסאות של Android והמיפוי שלהן לרמות ה-API.
deviceModel מזהה של דגם מכשיר מסוים, כפי שמוגדר בקטלוג המכשירים של Play Console.
deviceType מזהה של גורם צורה מסוים של מכשיר, כפי שמופיע בקטלוג המכשירים של Play Console.
deviceRamBucket זיכרון ה-RAM של המכשיר, במגה-בייט, בקבוצות (3GB,‏ 4GB וכו').
deviceSocMake יצרן המערכת הראשית על שבב (SoC) של המכשיר, למשל: סמסונג. כאן מוסבר איך בוחרים אפשרות.
deviceSocModel שם הדגם של המערכת העיקרית על שבב במכשיר, למשל ‫Exynos 2100. כאן מוסבר איך בוחרים אפשרות.
deviceCpuMake יצרן המעבד של המכשיר, למשל, Qualcomm.
deviceCpuModel דגם המעבד (CPU) של המכשיר, למשל, ‪"Kryo 240".
deviceGpuMake היצרן של ה-GPU במכשיר, למשל, ARM.
deviceGpuModel הדגם של ה-GPU של המכשיר, למשל מאלי.
deviceGpuVersion גרסת ה-GPU של המכשיר, לדוגמה, T750.
deviceVulkanVersion גרסת Vulkan של המכשיר, למשל: ‫"4198400".
deviceGlEsVersion גרסת OpenGL ES של המכשיר, למשל, ‫"196610".
deviceScreenSize גודל המסך של המכשיר, למשל, NORMAL, LARGE.
deviceScreenDpi דחיסות המסך של המכשיר, למשל mdpi,‏ hdpi.