Google Play Developer Reporting API を使用して、アプリに関する指標、レポート、タイムライン情報にアクセスできます。 API の使用を可能な限り簡素化するため、指標セットによって指標アクセスが標準化されます。指標セットは、共通の属性（鮮度や粒度など）を共有する関連する指標の論理的なグループであり、一緒にクエリできます。指標セットには、内訳のフィルタリングや生成に使用できるディメンションも多数含まれています。特に指定のない限り、すべての指標は使用可能なディメンションで分割またはフィルタリングできます。
鮮度
各指標セット リソースには、鮮度と呼ばれる最新のデータポイントの日時を取得する標準の GET メソッドが用意されています。指標セットは複数の粒度（毎日、毎時間）をサポートできるため、サポートされている粒度ごとにオペレーションは 1 つの鮮度値を返します。
鮮度の値は、クエリ期間内のエンドポイントとして直接使用できます。
データクエリ
指標セットのデータにアクセスするには、カスタム QUERY メソッドを使用してクエリを発行します。クエリごとに粒度と期間を指定する必要があります。アクセスする指標とともに、集計の分割に使用するディメンションを指定する必要があります。
期間をリクエストするタイムラインをリクエストする際は、期間のサイズとアプリのサイズや内訳の数に反比例するように、注意が必要です。 たとえば、サイズの大きいアプリでは、1 つのクエリ リクエストで選択する日数を減らすと、大量のデータの読み取りによるクエリのタイムアウトを回避できます。
使用可能な指標セット
以下のインデックスは、リクエストできるすべてのエンドポイントと関連データを示しています。
| 指標セット | 説明 | サポートされる指標 |
|---|---|---|
vitals.anrrate |
ANR データと使用状況データを組み合わせて、ユーザー数に関係なく正規化された指標を生成します。 |
anrRate（google.type.Decimal）: 集計期間中に 1 回以上 ANR が発生したユーザーの割合。 anrRate7dUserWeighted（google.type.Decimal）: 日付を含む 7 日間の arRate 指標の加重平均。 anrRate28dUserWeighted（google.type.Decimal）: 日付までの 28 日間における anrRate 指標の加重平均。 userPerceivedAnrRate（google.type.Decimal）: 集計期間中に 1 回以上 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 日間の CrashRate 指標の加重平均。 crashRate28dUserWeighted（google.type.Decimal）: 過去 28 日間（日付を含む）の CrashRate 指標の加重平均。 userPerceivedCrashRate（google.type.Decimal）: 集計期間中、アプリが使用中に少なくとも 1 回クラッシュが発生したユーザーの割合。 userPerceivedCrashRate7dUserWeighted（google.type.Decimal）: 過去 7 日間（日を含む）の userPerceivedCrashRate 指標の加重平均。 userPerceivedCrashRate28dUserWeighted（google.type.Decimal）: 日付を含む 28 日間の userPerceivedCrashRate 指標の加重平均。 distinctUsers（google.type.Decimal）: 集計期間中にデータが利用可能だったユーザーのおおよその数。 |
vitals.excessivewakeuprate |
AlarmManager wakeup 数とプロセス状態データを組み合わせて、ユーザー数に関係なく正規化された指標を生成します。 |
excessiveWakeupRate (google.type.Decimal): 集計期間中に 1 時間に 10 回を超える wakeup が発生したユニーク ユーザーの割合。excessiveWakeupRate7dUserWeighted（google.type.Decimal）: 日付を含む 7 日間までの WakeupRate 指標の加重平均。 excessiveWakeupRate28dUserWeighted（google.type.Decimal）: 日付までの 28 日間における WakeupRate 指標の加重平均。 distinctUsers（google.type.Decimal）: 集計期間中にデータが利用可能だったユーザーのおおよその数。 |
vitals.stuckbackgroundwakelockrate |
PowerManager のウェイクロック持続時間とプロセス状態のデータを組み合わせて、ユーザー数に関係なく正規化された指標を生成します。 |
stuckBgWakelockRate（google.type.Decimal）: バックグラウンドで 1 時間以上ウェイクロックを保持していた集計期間内のユーザーの割合です。stuckBgWakelockRate7dUserWeighted（google.type.Decimal）: 日付を含む過去 7 日間の StickBgWakelockRate 指標の加重平均。 stuckBgWakelockRate28dUserWeighted（google.type.Decimal）: 日付までの 28 日間でユーザーが停止した BgWakelockRate 指標の加重平均。 distinctUsers（google.type.Decimal）: 集計期間中にデータが利用可能だったユーザーのおおよその数。 |
vitals.slowstartuprate |
アプリの起動タイプ（コールド、ウォーム、ホット）ごとに分類した、アプリの低速な起動データが含まれています。 |
slowStartRate（google.type.Decimal）: 集計期間に開始イベントが遅かったユニーク ユーザーの割合。slowStartRate7dUserWeighted（google.type.Decimal）: 過去 7 日間（日付を含む）の遅い StartRate 指標のユーザー加重平均。 slowStartRate28dUserWeighted（google.type.Decimal）: 日付までの 28 日間で速度が遅い StartRate 指標のユーザー加重平均。 distinctUsers（google.type.Decimal）: 集計期間中にデータが利用可能だったユーザーのおおよその数。 |
vitals.errors.counts |
非正規化エラーレポートの数が含まれます。 |
注: このリソースは、現在は API v1 アルファ版でのみ利用可能です。 errorReportCount (google.type.Decimal): アプリで受信した個々のエラーレポートの絶対数。 |
ディメンション
各指標セットは、フィルタリングと分類のために別々のディメンションのセットをサポートしています。API で使用可能なディメンションのリストについては、下記のディメンション インデックスをご覧ください。
| ディメンション | 説明 |
|---|---|
versionCode |
データのキャプチャ時にユーザーのデバイス上で実行されていたアプリのバージョン コード。このディメンションの文字列値は、整数として解析できます。Android でのアプリのバージョニングの仕組みについて詳しくは、こちらをご覧ください。 |
countryCode |
ユーザーの国や地域の IP アドレスに基づく識別子。2 文字の ISO-3166 コード（米国の場合は US など）で表されます。 |
デバイスの寸法
ディメンションはデバイスと、ソフトウェアおよびハードウェアの特性に固有のものです。
| ディメンション | 説明 |
|---|---|
apiLevel |
データのキャプチャ時にユーザーのデバイスで実行されていた Android の API レベル。このディメンションの文字列値は、整数として解析できます。Android リリースの一覧と、各 API レベルに対するマッピングについては、こちらをご覧ください。 |
deviceModel |
特定のデバイスモデルの識別子。Google Play Console デバイス カタログによって定義されます。 |
deviceType |
特定のデバイス フォーム ファクタの識別子。Google Play Console デバイス カタログで使用されます。 |
deviceRamBucket |
デバイスの RAM（MB 単位、バケット単位（3 GB、4 GB など）） |
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 |
デバイスの画面サイズ（例:通常、大。 |
deviceScreenDpi |
デバイスの画面密度（mdpi、hdpi など）。 |