דף זה תורגם על ידי Cloud Translation API.

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

ה-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.