透過 Google Play Developer Reporting API，您可以存取應用程式的指標、報表和時間軸資訊。 為盡可能簡化 API 用量，指標集會標準化指標存取權。 指標集是相關指標的邏輯分組，這些指標共用常見屬性 (例如新鮮度和精細度)，且可以一起查詢。指標集也包含許多維度，可用於篩選或產生細目。 除非另有指定，否則所有指標都可以依所有可用維度細分或篩選。
即時性
每個指標集資源都提供標準 GET 方法，可擷取最新可用資料點的日期和時間，也就是「新鮮度」。由於指標集可支援多種精細程度 (每日、每小時)，因此這項作業會針對每個支援的精細程度傳回一個即時度值。
您可以直接將新鮮度值做為查詢時間範圍的端點。
資料查詢
如要存取指標集中的資料，請使用自訂 QUERY 方法發出查詢。每個查詢都必須指定精細程度和時間範圍。除了要存取的指標，您也應指定用於細分匯總資料的維度。
要求時間軸時，請謹慎要求日期範圍，時間範圍的大小應與應用程式大小和細目數量成反比。舉例來說，大型應用程式應在單一查詢要求中選取較少天數，避免因讀取過多資料而導致查詢逾時。
可用的指標組合
下方的索引列出所有端點和相關資料，供您提出要求。
| 指標集 | 說明 | 支援的指標 |
|---|---|---|
vitals.anrrate |
包含 ANR 資料和使用資料，可產生與使用者人數無關的正規化指標。 |
anrRate (google.type.Decimal)：在匯總期間，至少發生一次 ANR 的不重複使用者百分比。 anrRate7dUserWeighted (google.type.Decimal)：在指定日期 (含) 前 7 天內，anrRate 指標的使用者加權平均值。 anrRate28dUserWeighted (google.type.Decimal)：在指定日期 (含) 前 28 天內，以使用者權重計算的 anrRate 指標平均值。 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)：在匯總期間，至少發生一次當機的相異使用者百分比。 crashRate7dUserWeighted (google.type.Decimal)：使用者加權平均值，代表日期當天 (含) 前 7 天的 crashRate 指標。 crashRate28dUserWeighted (google.type.Decimal)：在指定日期 (含) 前 28 天內，以使用者為權重的當機率平均值。 userPerceivedCrashRate (google.type.Decimal)：在彙整期間，應用程式處於使用中狀態時，至少發生一次當機狀況的不重複使用者百分比。 userPerceivedCrashRate7dUserWeighted (google.type.Decimal)：在指定日期 (含) 前 7 天內，使用者感受到的當機率指標加權平均值。 userPerceivedCrashRate28dUserWeighted (google.type.Decimal)：使用者感受到的當機率指標在 28 天內的使用者加權平均值 (包括當天)。 distinctUsers (google.type.Decimal)：在匯總期間提供資料的概略使用者人數。 |
vitals.lmkrate
|
包含記憶體耗盡 (LMK) 資料和使用資料，可產生與使用者人數無關的正規化指標。 |
userPerceivedLmkRate (google.type.Decimal)：在彙整期間，至少感知到一次 LMK (記憶體耗盡) 事件的獨立使用者百分比。使用者主動使用應用程式時，如果應用程式顯示任何活動或執行任何前景服務，即視為處於使用中狀態。 userPerceivedLmkRate7dUserWeighted (google.type.Decimal)：使用者加權平均值，計算方式為在指定日期 (含當天) 前 7 天內，使用者感知到的 LMK 率指標。 userPerceivedLmkRate28dUserWeighted (google.type.Decimal)：在指定日期 (含) 前 28 天內，以使用者為權重計算的 userPerceivedLmkRate 指標平均值。 distinctUsers (google.type.Decimal)：在匯總期間內，可取得資料的概略使用者人數。 |
vitals.excessivewakeuprate |
內含 AlarmManager 喚醒次數資料，以及程序狀態資料，可產生與使用者人數無關的正規化指標。 |
excessiveWakeupRate (google.type.Decimal)：匯總期間內，每小時喚醒次數超過 10 次的不重複使用者百分比。excessiveWakeupRate7dUserWeighted (google.type.Decimal)：在指定日期 (含當天) 前 7 天，以使用者權重計算的 excessiveWakeupRate 指標平均值。 excessiveWakeupRate28dUserWeighted (google.type.Decimal)：使用者加權平均值，計算方式為截至指定日期 (含當天) 的 28 天內，excessiveWakeupRate 指標的平均值。 distinctUsers (google.type.Decimal)：在匯總期間提供資料的概略使用者人數。 |
vitals.stuckbackgroundwakelockrate |
包含 PowerManager 喚醒鎖定時間資料，以及程序狀態資料，可產生與使用者人數無關的正規化指標。 |
stuckBgWakelockRate (google.type.Decimal)：在彙整期間，有喚醒鎖在背景中保留超過 1 小時的不重複使用者百分比。stuckBgWakelockRate7dUserWeighted (google.type.Decimal)：在指定日期 (含) 前 7 天內，stuckBgWakelockRate 指標的使用者加權平均值。 stuckBgWakelockRate28dUserWeighted (google.type.Decimal)：在指定日期 (含) 前 28 天內，stuckBgWakelockRate 指標的使用者加權平均值。 distinctUsers (google.type.Decimal)：在匯總期間，可取得資料的概略使用者人數。 |
vitals.slowstartuprate |
包含應用程式啟動緩慢的資料，並依應用程式啟動類型 (冷啟動、暖啟動、熱啟動) 分類。 |
slowStartRate (google.type.Decimal)：在匯總期間內，發生啟動緩慢事件的不重複使用者百分比。
slowStartRate7dUserWeighted (google.type.Decimal)：使用者加權平均值，計算方式為從當天起回推 7 天的 slowStartRate 指標。 slowStartRate28dUserWeighted (google.type.Decimal)：使用者加權平均值 在 28 天內 (含當天) 的 slowStartRate 指標。 distinctUsers (google.type.Decimal)：在匯總期間，可取得資料的概略使用者人數。 |
vitals.errors.counts |
包含未標準化的錯誤報告計數。 |
請注意：這項資源目前僅適用於 API 的 v1 Alpha 版。 errorReportCount (google.type.Decimal)：應用程式收到的個別錯誤報告絕對數量。 |
尺寸
每個指標組合都支援一組不同的維度，用於篩選和細分。請參閱下方的維度索引，瞭解 API 適用的維度清單。
| 維度 | 說明 |
|---|---|
versionCode |
擷取資料時，使用者裝置上執行的應用程式版本代碼。這個維度的字串值可以剖析為整數。如要進一步瞭解 Android 應用程式版本管理機制，請參閱這篇文章。 |
countryCode |
根據使用者 IP 位址判斷的國家/地區 ID，以 2 個字母的 ISO-3166 代碼表示 (例如美國為「US」)。 |
裝置尺寸
這些維度與裝置及其軟硬體特性有關。
| 維度 | 說明 |
|---|---|
apiLevel |
擷取資料時，使用者裝置上執行的 Android API 級別。這個維度的字串值可以剖析為整數。如要查看 Android 版本清單及其對應的 API 級別，請參閱這篇文章。 |
deviceModel |
特定裝置型號的 ID，由 Play 管理中心的裝置目錄定義。 |
deviceType |
特定裝置板型規格的 ID，與 Play 管理中心裝置目錄所用 ID 相同。 |
deviceRamBucket |
裝置的 RAM (以 MB 為單位)，以儲存區的形式 (3GB、4GB 等)。 |
deviceSocMake |
裝置主要系統單晶片的廠牌，例如 Samsung。詳情請參閱這篇文章。 |
deviceSocModel |
裝置主要系統單晶片的型號名稱，例如 「Exynos 2100」。詳情請參閱這篇文章。 |
deviceCpuMake |
裝置 CPU 的廠牌，例如 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。 |