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

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

עדכניות

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

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

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

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

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

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

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

מדד הוגדר תיאור מדדים נתמכים
vitals.anrrate מכיל נתוני מקרי ANR בשילוב עם נתוני שימוש כדי ליצור מדד מנורמל ללא קשר לספירת המשתמשים. anrRate (google.type.Decimal): אחוז המשתמשים הייחודיים בתקופת הצבירה של מקרה ANR אחד לפחות.
anrRate7dUserWeighted (google.type.Decimal): הממוצע שמשוקלל על ידי המשתמש של הערך arRate במהלך 7 הימים שקדמו לתאריך, כולל.
anrRate28dUserWeighted (google.type.Decimal): הממוצע שמשוקלל על ידי המשתמש של הפרמטר arRate במהלך 28 הימים שקדמו לתאריך, כולל.
userPerceivedAnrRate (google.type.Decimal): אחוז המשתמשים הייחודיים בתקופת הצבירה של מקרי ANR אחת לפחות שהמשתמשים תפסו. נכון לעכשיו, נספרים מקרי ANR של 'שליחת קלט'.
userPerceivedAnrRate7dUserWeighted (google.type.Decimal): הממוצע שמשוקלל על ידי המשתמש עבור המדד userPerceivedAnrRate ב-7 הימים שקדמו לתאריך והכולל.
userPerceivedAnrRate28dUserWeighted (google.type.Decimal): הממוצע שמשוקלל על ידי המשתמש עבור המדד userPerceivedAnrRate במהלך 28 הימים עד וכולל התאריך.
disticatetUsers (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 הימים שקדמו לתאריך כולל.
disticatetUsers (google.type.Decimal): המספר המשוער של משתמשים שהיו זמינים עבורם נתונים בתקופת הצבירה.
vitals.excessivewakeuprate מכיל נתוני הוצאה ממצב שינה של AlarmManager בשילוב עם נתוני מצב תהליך כדי ליצור מדד מנורמל ללא קשר לספירות המשתמשים. excessiveWakeupRate (google.type.Decimal): אחוז המשתמשים הייחודיים בתקופת הצבירה, שהיו יותר מ-10 הוצאות ממצב שינה בשעה. excessiveWakeupRate7dUserWeighted (google.type.Decimal): הממוצע המשוקלל לפי משתמש, של הערך העודף של WakeupRate במהלך 7 הימים שקדמו לתאריך, כולל.
expediveWakeupRate28dUserWeighted (google.type.Decimal): הממוצע המשוקלל לפי משתמש, של המדד החריג המשוקלל ב-WakeupRate במהלך 28 הימים שקדמו לתאריך, כולל.
disticatetUsers (google.type.Decimal): המספר המשוער של משתמשים שהיו זמינים עבורם נתונים בתקופת הצבירה.
vitals.stuckbackgroundwakelockrate מכיל נתוני משך זמן של מצב שינה של PowerManager בשילוב עם נתונים של מצב תהליך כדי ליצור מדד מנורמל ללא קשר לספירת המשתמשים. stuckBgWakelockRate (google.type.Decimal): אחוז המשתמשים הייחודיים בתקופת הצבירה, שה-wakelock היה פעיל ברקע למשך יותר משעה. stuckBgWakelockRate7dUserWeighted (google.type.Decimal): הממוצע המשוקלל לפי משתמש של המדד התקוע BgWakelockRate שנתקע ב-7 הימים שלפני (כולל) התאריך.
stuckBgWakelockRate28dUserWeighted (google.type.Decimal): הממוצע המשוקלל לפי משתמש של המדד התקוע BgWakelockRate שנתקע ב-28 הימים שקדמו לתאריך, כולל.
disticatetUsers (google.type.Decimal): המספר המשוער של משתמשים שהיו זמינים עבורם נתונים בתקופת הצבירה.
vitals.slowstartuprate מכיל נתוני הפעלה איטית של האפליקציה, מפורטים לפי סוג ההפעלה של האפליקציה (קריר, חם, חם). slowStartRate (google.type.Decimal): אחוז המשתמשים הייחודיים בתקופת הצבירה שהיה להם אירוע התחלה איטית. slowStartRate7dUserWeighted (google.type.Decimal): הממוצע המשוקלל לפי משתמש, של המדד startStartRate במהלך 7 הימים שקדמו לתאריך, כולל.
slowStartRate28dUserWeighted (google.type.Decimal): הממוצע שמשוקלל על ידי המשתמש עבור המדד startStartRate במהלך 28 הימים שקדמו לתאריך, כולל.
disticatetUsers (google.type.Decimal): המספר המשוער של משתמשים שהיו זמינים עבורם נתונים בתקופת הצבירה.
vitals.errors.counts מכיל ספירות של דוחות שגיאה לא מנורמלים. לתשומת ליבך: נכון לעכשיו המשאב הזה זמין רק בגרסת ה-API v1 של ה-API.
errorReportCount (google.type.Decimal): ספירה מוחלטת של דוחות שגיאה נפרדים שהתקבלו לאפליקציה.

מידות

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

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

מידות המכשיר

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

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