Method: vitals.anrrate.query

在指標組合中查詢指標。

HTTP 要求

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/anrRateMetricSet}:query

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

必要欄位。資源名稱。

格式：apps/{app}/anrRateMetricSet

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
欄位
timelineSpec

object (TimelineSpec)

時間軸匯總參數的規格。

支援的匯總期間：

  • DAILY：依日曆日期間隔匯總指標。基於過往限制，預設且僅支援 America/Los_Angeles 時區。
  • HOURLY：指標以每小時間隔匯總。預設時區為 UTC。
dimensions[]

string

做為指標分類依據的維度。

支援的尺寸：

  • apiLevel (string)：在使用者裝置上執行的 Android API 級別，例如26.
  • versionCode (int64)：使用者裝置上執行的應用程式版本。
  • deviceModel (string)：使用者裝置型號的專屬 ID。ID 的格式為「deviceBrand/device」，其中 deviceBrand 等於 Build.BRAND，裝置則對應至 Build.DEVICE，例如 google/coral。
  • deviceBrand (string)：使用者裝置品牌的專屬 ID，例如 Google。
  • deviceType (string)：使用者裝置的類型 (也稱為板型規格)，例如電話號碼。
  • countryCode (string)：使用者裝置的國家/地區，依據使用者的 IP 位址，以 2 個字母的 ISO-3166 代碼表示 (例如美國為 US)。
  • deviceRamBucket (int64)：裝置的 RAM，以 MB 為單位，以值區為單位 (3 GB、4 GB 等)。
  • deviceSocMake (string)：裝置的主要系統晶片組，例如Samsung。參考資料
  • deviceSocModel (string)：裝置主要系統晶片型號，例如「Exynos 2100」。參考資料
  • deviceCpuMake (string)：裝置 CPU 的組成元素，例如Qualcomm
  • deviceCpuModel (string)：裝置 CPU 的型號，例如「Kryo 240」。
  • deviceGpuMake (string)：由裝置的 GPU 組成，例如ARM。
  • deviceGpuModel (string)：裝置的 GPU 型號，例如馬利。
  • deviceGpuVersion (string)：裝置的 GPU 版本，例如T750。
  • deviceVulkanVersion (string)：裝置的 Vulkan 版本，例如「4198400」。
  • deviceGlEsVersion (string)：裝置的 OpenGL ES 版本，例如「196610」。
  • deviceScreenSize (string)：裝置的螢幕大小，例如NORMAL、LARGE。
  • deviceScreenDpi (string)：裝置的螢幕密度，例如 mdpi、hdpi。
metrics[]

string

要匯總的指標。

支援的指標：

  • anrRate (google.type.Decimal)：在匯總期間內，遇到至少一次 ANR 的不重複使用者百分比。
  • anrRate7dUserWeighted (google.type.Decimal)：過去 7 天的累計平均值 anrRate。系統會根據當天不重複使用者人數對每日價值進行加權。精細程度不支援 HOURLY。
  • anrRate28dUserWeighted (google.type.Decimal)：過去 28 天的累計平均值 anrRate。系統會根據當天不重複使用者人數對每日價值進行加權。精細程度不支援 HOURLY。
  • userPerceivedAnrRate (google.type.Decimal)：在匯總期間，遇到至少一次使用者感知 ANR 事件的不重複使用者百分比。使用者感知的 ANR 事件目前屬於「輸入分派」類型。
  • userPerceivedAnrRate7dUserWeighted (google.type.Decimal)：過去 7 天的累計平均值 userPerceivedAnrRate。系統會根據當天不重複使用者人數對每日價值進行加權。精細程度不支援 HOURLY。
  • userPerceivedAnrRate28dUserWeighted (google.type.Decimal)：過去 28 天的累計平均值 userPerceivedAnrRate。系統會根據當天不重複使用者人數對每日價值進行加權。不是 . 並以 HOURLY 為單位
  • distinctUsers (google.type.Decimal)：匯總期間的不重複使用者人數，用於 anrRate 和 userPerceivedAnrRate 指標的正規化值。如果使用者在匯總期間在前景使用應用程式，系統就會將該使用者計入這項指標。請小心不要再匯總這個計數，因為這樣可能會導致系統重複計算同一名使用者。視值的規模而定，系統會將這個值四捨五入為最接近的 10、100、1,000 或 1,000,000 的倍數。
filter

string

要套用至資料的篩選器。篩選運算式符合 AIP-160 標準，支援按所有細分維度的相等條件進行篩選。
pageSize

integer

傳回資料的大小上限。

如未指定，最多會傳回 1000 個資料列。許可的最大值為 100,000；超出的數值將一律指定為 100,000。
pageToken

string

屬於接收自前一個呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供給要求的所有其他參數都必須與提供網頁權杖的呼叫相符。
userCohort

enum (UserCohort)

要選取的使用者檢視畫面。輸出資料會對應至所選檢視表。

支援的值：

  • OS_PUBLIC 用於選取所有公開發布的 Android 版本資料。此為預設值。支援上述所有維度。
  • APP_TESTERS針對選擇加入測試人員的使用者選取資料。支援上述所有維度。
  • OS_BETA 僅選取 Android Beta 版的資料，排除已發布 Android 版本的資料。系統僅支援以下維度：

  • versionCode (int64)：使用者裝置上執行的應用程式版本。

  • osBuild (string)：使用者裝置的 OS 版本，例如「T1B2.220916.004」。

回應主體

anrrate.query 的回應訊息。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
欄位
rows[]

object (MetricsRow)

傳回的資料列。
nextPageToken

string

用於擷取下一頁資料的接續權杖。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/playdeveloperreporting

詳情請參閱 OAuth 2.0 總覽。