您可以透過 Google Play Developer Reporting API 存取應用程式的指標、報表和時間軸資訊。 為提高 API 用量的簡易性,指標組合可將指標存取權標準化。指標組合是相關指標的邏輯分組,具有共同屬性 (例如新鮮度和精細程度),並且可以一起查詢。指標組合也包含許多維度,可用來篩選或產生細目資料。 除非另有指定,否則所有指標都能按所有可用的維度細分或篩選。
即時程度
每個指標集資源都提供標準的 GET
方法,用於擷取最新可用資料點的日期和時間 (又稱為即時性)。由於指標組合支援多種精細程度 (每日、每小時),因此作業會針對各個支援的精細程度傳回一個更新度值。
您可以直接在查詢時間範圍內,直接使用更新間隔值做為端點。
資料查詢
如要存取指標集中的資料,您必須使用自訂 QUERY
方法發出查詢。每個查詢都必須指定精細程度和時間範圍。搭配您想存取的指標,請指定您要用於細分匯總的維度。
要求時間表以指定日期範圍時,請務必謹慎,讓時間範圍的大小與應用程式的大小和細目數量成正比。舉例來說,大型應用程式在單一查詢要求中應選取的天數較少,以免查詢因讀取過量資料而導致逾時。
可用的指標組合
以下索引會列出您可要求的所有端點和相關資料。
指標組合 | 說明 | 支援的指標 |
---|---|---|
vitals.anrrate |
包含 ANR 資料與使用資料,產生正規化指標 (不受使用者計數影響)。 |
anrRate (google.type.Decimal):匯總期間內,經歷至少一次 ANR 情形的不重複使用者百分比。 anrRate7dUserWeighted (google.type.Decimal):截至該日為止的 7 天內,rrRate 指標的加權加權平均值。 anrRate28dUserWeighted (google.type.Decimal):過去 28 天內 (含日期) 過去 28 天內 arRate 指標的使用者加權平均值。 userPerceivedAnrRate (google.type.Decimal):匯總期間內遇到至少一次使用者感知 ANR 情形的不重複使用者百分比。目前「輸入分派」的 ANR 次數會列入計算。 userPerceivedAnrRate7dUserWeighted (google.type.Decimal):使用者 (含日期) 該日 7 日內 UserPerceivedAnrRate 指標的加權平均值。 userPerceivedAnrRate28dUserWeighted (google.type.Decimal):最近 28 天內 (含日期) 使用者 UserPerceivedAnrRate 指標的加權平均值。 distinctUsers (google.type.Decimal):在匯總期間提供資料的預估使用者人數。 |
vitals.crashrate |
包含當機資料與使用資料,產生與常規數量無關的標準化指標。 |
crashRate (google.type.Decimal):匯總期間內,至少有 1 次當機情形的不重複使用者百分比。 crashRate7dUserWeighted (google.type.Decimal):最近 7 天 (含日期) 內,依使用者加權的當機率指標平均值。 crashRate28dUserWeighted (google.type.Decimal):最近 28 天內 (含日期) 使用者加權當機率指標的平均值。 userPerceivedCrashRate (google.type.Decimal):匯總期間內,在應用程式使用期間遇到至少一次當機情形的不重複使用者百分比。 userPerceivedCrashRate7dUserWeighted (google.type.Decimal):最近 7 天內 (含日期) 內使用者 PerceivedCrashRate 指標的加權加權平均值。 userPerceivedCrashRate28dUserWeighted (google.type.Decimal):最近 28 天內 (含日期) 中使用者 PerceivedCrashRate 指標的使用者加權平均值。 distinctUsers (google.type.Decimal):在匯總期間提供資料的預估使用者人數。 |
vitals.excessivewakeuprate |
包含 AlarmManager 喚醒次數資料與處理狀態資料,產生正規化指標,不受使用者計數影響。 |
excessiveWakeupRate (google.type.Decimal):匯總週期內喚醒使用者超過 10 次的不重複使用者百分比。excessiveWakeupRate7dUserWeighted (google.type.Decimal):最近 7 天內 (含日期) 內,超過 WWupupRate 指標的使用者加權平均值。 excessiveWakeupRate28dUserWeighted (google.type.Decimal):最近 28 天 (含日期) 內,超過 WWupupRate 指標的使用者加權平均值。 distinctUsers (google.type.Decimal):在匯總期間提供資料的預估使用者人數。 |
vitals.stuckbackgroundwakelockrate |
包含 PowerManager Wake Lock 持續時間資料與程序狀態資料,產生與使用者計數無關的正規指標。 |
stuckBgWakelockRate (google.type.Decimal):匯總於背景執行 Wake Lock 超過 1 小時的不重複使用者人數百分比。stuckBgWakelockRate7dUserWeighted (google.type.Decimal):截至該日為止的 7 天內,BuckBgWakelockRate 指標的「使用者加權」平均值。 stuckBgWakelockRate28dUserWeighted (google.type.Decimal):使用者在過去 28 天內 (含當天) 中停滯的卡住了 BBWakelockRate 指標的平均值。 distinctUsers (google.type.Decimal):在匯總期間提供資料的預估使用者人數。 |
vitals.slowstartuprate |
含有按應用程式啟動類型 (冷、暖、熱) 細分的應用程式啟動資料。 |
slowStartRate (google.type.Decimal):匯總啟動事件中,具有緩慢啟動事件的不重複使用者百分比。
slowStartRate7dUserWeighted (google.type.Decimal):最近 7 天內 (含日期) 中緩慢啟動率指標的加權加權平均值。 slowStartRate28dUserWeighted (google.type.Decimal):最近 28 天 (含日期) 中,緩慢啟動率指標的加權平均值。 distinctUsers (google.type.Decimal):在匯總期間提供資料的預估使用者人數。 |
vitals.errors.counts |
包含未正規化的錯誤計數。 |
請注意:這項資源目前僅適用於 API v1 Alpha 版本。 errorReportCount (google.type.Decimal):針對應用程式收到的個別錯誤報告,顯示絕對的計數。 |
尺寸
每個指標集都支援一組不同的維度,用於篩選及細分資料。請查看下方的維度索引,瞭解 API 提供的維度清單。
維度 | 說明 |
---|---|
versionCode |
擷取資料時,使用者裝置上執行的應用程式版本版本。這個維度的字串值可剖析為整數。若要進一步瞭解 Android 應用程式版本管理功能的運作方式,請參閱這篇文章。 |
countryCode |
使用者所在國家/地區的 ID,根據 IP 位址以 2 個字母的 ISO-3166 代碼表示 (例如,美國為美國)。 |
裝置尺寸
這些是裝置本身及其軟體和硬體特性的維度。
維度 | 說明 |
---|---|
apiLevel |
擷取資料時,使用者裝置上執行的 Android API 級別。這個維度的字串值可剖析為整數。如要查看 Android 版本清單,以及這些版本對應至 API 級別的方式,請參閱這篇文章。 |
deviceModel |
特定裝置型號的 ID,由 Play 管理中心的裝置目錄定義。 |
deviceType |
特定裝置板型規格 (即 Play 管理中心裝置目錄所使用的 ID)。 |
deviceRamBucket |
值區中的 RAM (以 MB 為單位),例如值區 (3 GB、4 GB 等)。 |
deviceSocMake |
裝置的主要晶片系統 (例如:三星。詳情請參閱這裡。 |
deviceSocModel |
裝置主要晶片系統的型號名稱,例如:「Exynos 2100」。詳情請參閱這裡。 |
deviceCpuMake |
裝置 CPU,例如高通。 |
deviceCpuModel |
裝置的 CPU 型號,例如「Kryo 240」。 |
deviceGpuMake |
裝置的 GPU 組成,例如ARM。 |
deviceGpuModel |
裝置的 GPU 型號,例如馬利。 |
deviceGpuVersion |
裝置的 GPU 版本,例如T750。 |
deviceVulkanVersion |
裝置的 Vulkan 版本,例如「4198400」。 |
deviceGlEsVersion |
裝置的 OpenGL ES 版本,例如「196610」。 |
deviceScreenSize |
裝置的螢幕大小 (例如不需要。 |
deviceScreenDpi |
裝置的螢幕密度,例如 mdpi、hdpi。 |