指標集簡介

您可以使用 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 天 (包括當天) 的當機率使用者加權平均值。
crashRate28dUserWeighted (google.type.Decimal)：在指定日期 (含當天) 之前的 28 天內，以使用者權重計算的 crashRate 指標平均值。
userPerceivedCrashRate (google.type.Decimal)：在匯總期間，應用程式處於使用中狀態時，至少發生一次當機狀況的不重複使用者百分比。
userPerceivedCrashRate7dUserWeighted (google.type.Decimal)：在指定日期 (含當天) 前 7 天內，以使用者權重計算的 userPerceivedCrashRate 指標平均值。
userPerceivedCrashRate28dUserWeighted (google.type.Decimal)：使用者加權平均值，計算方式為截至指定日期 (含當天) 的 28 天內，userPerceivedCrashRate 指標的平均值。
distinctUsers (google.type.Decimal)：在匯總期間內，可取得資料的概略使用者人數。
vitals.lmkrate 包含記憶體耗盡 (LMK) 資料，並結合使用資料產生與使用者人數無關的正規化指標。 userPerceivedLmkRate (google.type.Decimal)：在彙整期間，至少發生一次 LMK (記憶體耗盡) 事件的獨立使用者百分比。使用者主動使用應用程式時，如果應用程式顯示任何活動或執行任何前景服務，即視為處於使用中狀態。
userPerceivedLmkRate7dUserWeighted (google.type.Decimal)：使用者加權平均值，計算方式為在指定日期 (含當天) 前 7 天內，userPerceivedLmkRate 指標的使用者加權平均值。
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.slowstartrate 包含應用程式啟動緩慢的資料，並依應用程式啟動類型 (冷啟動、暖啟動、熱啟動) 細分。 slowStartRate (google.type.Decimal)：在匯總期間內，發生啟動緩慢事件的不重複使用者百分比。 slowStartRate7dUserWeighted (google.type.Decimal)：使用者加權平均值，代表日期當天和前 6 天的 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 型號，例如 Mali。
deviceGpuVersion 裝置 GPU 的版本，例如 T750。
deviceVulkanVersion 裝置的 Vulkan 版本，例如「4198400」。
deviceGlEsVersion 裝置的 OpenGL ES 版本，例如「196610」。
deviceScreenSize 裝置螢幕大小，例如 NORMAL、LARGE。
deviceScreenDpi 裝置的螢幕密度，例如 mdpi、hdpi。