指標集簡介

您可以透過 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。