Vitals API V2の概要

Vitals API V2を使用して、Fire TVおよびFireタブレットアプリのアプリヘルスメトリックとパフォーマンスメトリックを取得できます。アプリヘルス指標には、クラッシュ率、アプリ無応答（ANR）率、および低メモリキル（LMK）率が含まれます。パフォーマンス指標には、アプリの起動時間、すぐに使用できる時間、スロースタートレート、フレームドロップレート、スローレンダリングレートが含まれます。

APIは関連する指標を指標セットに入れます。指標セットのすべての指標の鮮度は同じです。メトリックスセットのすべてのメトリクスをまとめてクエリできます。各指標セットには、countryCodeなどのディメンションがあります。結果をディメンションの値でフィルタリングできます。また、結果をディメンションごとに分類することもできます。

Vitals APIのバージョン2（V2）は、バージョン1（V1）と以下の点で異なります。

• 各パスはバージョン /v2/ で始まります。
• 時間値はUTC形式のISO 8601文字列でたとえば、2026-08-18T14:00:00Zです。
• メトリックス値はJSON数値です。
• すべての操作で1つのエラー形式が使用されます。

Amazonは引き続きV1をサポートしています。新しい統合にはV2を使用してください。既存のインテグレーションをV2に移行します。必要な変更については、Migrate from V1を参照してください。

Vitals APIの使用にあたっては、Program Materials License Agreementが適用されます。

• 前提条件
• しくみ
  • 鮮度
• データクエリ
• 使用可能な指標セット
  • 指標値
• ディメンション
• 関連トピック

前提条件

リクエストを送信する前に、次のアイテムが必要です。

• Admin-level credentialsを持つAmazon Developerアカウント
• Reporting APIにアタッチされたセキュリティプロファイル。セキュリティプロファイルを作成するには、Developer Console の My Settings > API Access に移動します。
• セキュリティプロファイルのWeb SettingsタブにあるクライアントIDとクライアントシークレット
• LWAスコープadx_reporting::appstore:marketer
• アプリのパッケージ名例:com.example.myapp。デベロッパーアカウントがアプリを所有している必要があります。

動作のしくみ

Amazonは、アプリを実行するFire TVおよびFireタブレットデバイスからクラッシュレポートとパフォーマンスデータを収集します。指標を使用して傾向を見つけ、アプリのバージョン、デバイスモデル、国を比較します。数は概算であり、正確な合計ではありません。AmazonはUTC日とUTC時間ごとにメトリクスを計算します。このページとVitals API V2リファレンスページでは、集計期間はDAILYまたはHOURLYという値です。期間はDAILYクエリの場合は1日HOURLYクエリの場合は1時間です。

• DAILY集計期間では、UTC日ごとに1行ずつ取得されます。1日のデータは通常、翌日（T-1日）に取得できます。
• HOURLY集計期間では、UTC時間ごとに1行ずつ取得されます。通常、1時間のデータは、1時間の開始から2～3時間後（T-2 時間）に入手できます。アプリのバージョンをリリースした直後にHOURLYデータを使用して新しい問題を見つけてください。

最新状況

issuesMetricSetを除く各メトリックスセットには、Check Freshnessオペレーション（GET）があります。利用可能な集計期間ごとにAmazonが処理した最新の期間を返します。

issuesMetricSetにはCheck Freshness 操作がありません。CRASHの問題についてはcrashMetricSetのフレッシュネス値を使用してください。ANRの問題についてはanrMetricSetのフレッシュネス値を使用してください。APIはerrorEventCountの大きい順に課題を並べます。

集計期間	Usual Delay	Recent Query Window
DAILY	T-1日	UTCの最新30日程
HOURLY	T-2時間	UTCの最新15日程

鮮度値は最新の処理期間の開始時間です。たとえば、2026-08-18T00:00:00Z は、AmazonがDAILYに対して8月18日を処理したことを意味します。

クエリの終了を鮮度の値またはそれより前に設定します。鮮度だけでは、アプリにその期間のデータがあるかどうかはわかりません。デバイスはデータを送信するのが遅れることがあるため、最新の値が変更されることがあります。最近の期間を再度クエリして最新の値を取得します。

データクエリ

Query Metrics（POST）を使用して、メトリックセットからデータを取得します。集計期間と時間範囲を指定します。以下も指定できます。

• 指標： 返されるメトリクス。これらを省略すると、APIは集計期間をサポートするすべてのメトリクスを返します。
• ディメンション： ブレークダウンのディメンション例：versionCode。
• フィルター： 含めるディメンション値。フィルターは分類を追加しません。フィルターでは、dimensionsに含まれていないディメンションを使用できます。

ディメンションがないと、データを含む各期間に1行ずつ表示されます。ディメンションでは、ディメンション値とデータを含む期間の組み合わせごとに1行が表示されます。APIはデータがない期間を省略します。メトリックス値はnullであってもかまいません。

UTC時刻の値はYYYY-MM-DDThh:mm:ssZという形式で使用してください。時間範囲にはstartTimeとendTimeの期間が含まれます。

クラッシュやANRに関する問題のうち、最も多く発生しているものを取得するには、Query Issues（issuesMetricSet）を使用してください。

すべてのオペレーションは1つのレート制限を共有します。詳しくは、Rate limits, retries, and best practicesを参照してください。

使用可能な指標セット

以下の表は、使用可能なすべての指標セットとサポートされている指標の一覧です。

指標セット	指標
crashMetricSet	crashRate（レート）： クラッシュが発生したアクティブなデバイスの割合 crashRate7dUserWeighted（レート）：7日間のクラッシュ率、アクティブなデバイスで加重 crashRate28dUserWeighted（レート）：28日間のクラッシュ率、アクティブなデバイスで加重 userPerceivedCrashRate（レート）： フォアグラウンドクラッシュが発生したアクティブなデバイスの割合 userPerceivedCrashRate7dUserWeighted（レート）： 7日間のフォアグラウンドクラッシュ率 userPerceivedCrashRate28dUserWeighted（レート）：28日間のフォアグラウンドクラッシュ率 distinctDevices（カウント）： およそのアクティブデバイス数 crashCount（カウント）： クラッシュイベントの総数
anrMetricSet	anrRate（レート）： ANR が適用されているアクティブデバイスの割合 anrRate7dUserWeighted（レート）：7日間のANRレート、アクティブデバイスで加重 anrRate28dUserWeighted（レート）：28日間のANRレート、アクティブデバイスで加重 userPerceivedAnrRate（レート）： フォアグラウンドANRを備えたアクティブデバイスの割合 userPerceivedAnrRate7dUserWeighted（レート）： 7日間のフォアグラウンドANRレート userPerceivedAnrRate28dUserWeighted（レート）：28日間のフォアグラウンドANRレート distinctDevices（カウント）： およそのアクティブデバイス数 anrCount（カウント）： ANR イベントの総数
lmkMetricSet	lmkRate（レート）： LMK イベントが発生したアクティブなデバイスの割合 lmkRate7dUserWeighted（レート）： 7日間の LMK レート、アクティブなデバイスで加重 lmkRate28dUserWeighted（レート）：28日間の LMK レート、アクティブなデバイスで加重 userPerceivedLmkRate（レート）： フォアグラウンドの LMK イベントが発生したアクティブなデバイスの割合 userPerceivedLmkRate7dUserWeighted（レート）：7日間のフォアグラウンドANRレート userPerceivedLmkRate28dUserWeighted（レート）：28日間のフォアグラウンドANRレート distinctDevices（カウント）： およそのアクティブデバイス数 lmkCount（カウント）： LMK イベントの合計数
issuesMetricSet	errorEventCount（カウント）： 問題のクラッシュイベントまたはANRイベントの総数 affectedDeviceCount（カウント）： 影響を受けた個別のデバイスの数
appLatencyMetricSet	coldStartAppLaunchTime（時間）： コールドスタート後の最初のアプリウィンドウまでの時間 warmStartAppLaunchTime（時間）： ウォームスタート後の最初のアプリウィンドウまでの時間
readyToUseMetricSet	coldStartReadyToUseTime（時間）： コールドスタート後にアプリが完全に描画されるまでの時間 warmStartReadyToUseTime（時間）： ウォームスタート後、アプリが完全に描画されるまでの時間
slowStartRateMetricSet	slowStartRate（レート）： 起動が遅いデバイスの割合 起動タイプ別 slowStartRate7dDeviceWeighted（レート）： 7日間のスロースタートレート、デバイスで加重 slowStartRate28dDeviceWeighted（レート）：28日間のスロースタートレート、デバイスで加重 distinctDevices（カウント）： 選択したタイプから始まるデバイスのおおよその数
fluidityMetricSet	frameDropRate（レート）： レンダリングされたUIフレームのうち、ドロップされたものの割合。この指標では、メディア再生フレームはカウントされません。 slowRenderingRate（レート）： フレームドロップ率が 25%を超えるデバイスの割合 slowRenderingRate7dDeviceWeighted（レート）：7日間の遅いレンダリングレート、デバイスで加重 slowRenderingRate28dDeviceWeighted（レート）：28日間の遅いレンダリングレート、デバイスで加重 distinctDevices（カウント）： フレームデータを送信したデバイスの数

すぐに使えるメトリクスには、アプリからのシグナルが必要です。

• Fire OSでは、アプリが完全に描画されたらActivity.reportFullyDrawn()を呼び出します。アプリ起動時の動作の改善を参照してください。
• Vega OS では、useReportFullyDrawn()を@amazon-devices/kepler-performance-api。メイン画面と初期データの準備が整ったら、返されたコールバックを呼び出します。アプリがバックグラウンドから戻って応答するようになったら、コールバックを再度呼び出します。アプリのKPIの測定を参照してください。

指標値

レートは 0 から 1までの JSON 番号です。カウントは整数です。所要時間はミリ秒単位です。各期間指標には次の3つの統計があります。 Average、P90、とP95。パーセンタイル値はおおよその値です。null値は0ではありません。

distinctDevicesは概算値であり、指標セットごとに意味が異なります。行や期間をまたいで値を追加しないでください。アプリ全体のレートを得るには、フィルターやディメンションなしでクエリを実行してください。

異なる行のレートを追加しないでください。複数のディメンション値のレートを取得するには、filterを使用し、dimensionsは指定しません。

ディメンション

すべての指標セットは、次の表の最初の 6 つのディメンションをサポートしています。slowStartRateMetricSetのみがstartTypeをサポートしています。startTypeはdimensionsに必要です。各ディメンションは、分類とフィルターに使用できます。

ディメンション	型	説明	値
versionCode	文字列	デバイスがデータを記録したときのアプリのバージョンコード	例えば、151
countryCode	文字列	大文字の2文字の ISO 3166-1 アルファ2国コード	例えば、US
deviceModel	文字列	デバイスモデルのコードネーム	たとえば、AFTSS
deviceType	文字列	デバイスファミリー	FIRE_TV、FIRE_TABLET、またはOTHER
deviceOs	文字列	デバイスのオペレーティングシステム	FIRE_OSまたはVEGA_OS。
osVersion	文字列	オペレーティングシステムのバージョン	たとえば、PS7713/5443
startType	文字列	アプリ起動のタイプ	COLDまたはWARM

関連トピック

• Vitals API V2リファレンス： 前提条件、認証、APIエンドポイント、コード例、エラー処理、ベストプラクティス
• Reporting API： 売上、収益、定期購入レポートのダウンロード
• アプリ健全性インサイトダッシュボード： 同じ指標の視覚的なダッシュボード
• APIの確認： 開発者コンソールのReporting API Explorerへのリンク

---

Last updated: 2026年10月13日