API Explorer

API Explorerは、開発者ポータルのインタラクティブクエリビルダーです。コードを一切記述しなくても、Vitalsと収益化APIの指標を調べたり、リクエストを視覚的に作成したり、ライブデータに対して実行したりすることができます。APIを自分のアプリに統合する前にクエリを試すのが一番早い方法です。

API Explorerでは、作成するクエリごとに以下が表示されます:

• 完全なJSONレスポンスインライン
• コピー可能なcURLコマンド
• Java、Python、Node.jsのコードスニペット

ビジュアルインターフェイスでは、次の操作を実行できます:

• APIとクエリタイプを選択し、指標とディメンションを選択し、フィルターを適用してクエリを実行する
• オプションを変更すると、生成されたAPIリクエストがリアルタイムで更新されることを確認する
• JSONレスポンス全体をインラインで確認する
• リクエストを独自のコードにコピー

• API Explorerの使用
  • 1. APIを選択する
  • 2. クエリの種類を選択する
  • 3. アプリを選択する
  • 4. 指標セットまたはレポートタイプを選択する
    • Vitals指標セット
    • 収益化指標セット
  • 5. 集計と期間を選択する
  • 6. 指標を選択する
  • 7. 任意： ディメンションを追加する
  • 8. 任意： フィルターを適用する
    • Vitalsフィルター
    • 収益化フィルター
  • 9. ページサイズを設定する
  • 10. クエリを実行する
• リクエストのプレビューパネル
• レスポンスパネル
• ヒント
• 関連トピック

API Explorerの使用

開発者ポータルのアプリアナリティクスセクションにあるAPIアクセスタブからAPI Explorerを開き、次の順序でフォームに入力します。

1. APIを選択する

APIフィールドで、必要なデータを選択します。選択内容によって、使用可能なクエリタイプ、指標セット、ディメンション、およびフィルターが決まります。

API	カバー対象
Vitals	アプリの状態とパフォーマンス： クラッシュレート、ANRレート、LMKレートとその背後にある主な問題に加えて、起動レイテンシー、すぐに使える時間、スロースタートレート、流動性
収益化	定期購入型アイテム： サインアップ、更新、キャンセル、再アクティベーション、アクティブなサブスクリプション、ヘルス、キャンセルに関する調査、フルフィルメント

2. クエリの種類を選択する

Vitalsでは、クエリタイプを選択します。

• 指標： 指標セット（レート、カウント、タイミング）をクエリします。オプションでディメンションごとに分類したり、フィルターで絞り込んだりできます。
• 問題点： 頻度別にランク付けされた上位課題をスタックトレース付きで返します。このモードでは、指標セットの代わりにレポートの種類を選択します。

収益化は指標のみをサポートしているため、クエリタイプは固定されています。

3. アプリを選択します。

Appフィールドで、Androidパッケージ名（たとえばcom.amazon.sampleapp）を選択するか入力します。これは開発者のベンダーアカウントが所有するアプリである必要があります。

4. 指標セットまたはレポートタイプを選択する

問題クエリタイプ（Vitalsのみ）では、レポートタイプを選択します： クラッシュまたはANR。

指標クエリタイプでは、指標セットを選択します。オプションはAPIによって異なります。

Vitals指標セット

指標セット	測定対象
クラッシュ	クラッシュ発生率、ユーザーが認識したクラッシュ発生率、クラッシュイベント数
ANR	ANR発生率、ユーザーが認識したANR発生率、ANRイベント数
LMK	LMK発生率、ユーザーが認識したLMK発生率、LMKイベント数
アプリのレイテンシ	コールドスタートとウォームスタート時に最初のアプリアクティビティが表示されるまでの時間
使用準備完了	コールドスタートでもウォームスタートでも、アプリが完全にレンダリングされて使用できるようになるまでの時間
スロースタートレート	コールドスタートまたはウォームスタートが遅かった個別のデバイスの割合
描画の滑らかさ	フレームドロップ率と、レンダリングが遅い状態を経験したデバイスの割合

収益化指標セット

指標セット	測定対象
サブスクリプションサインアップ	新規購読登録と登録収入
サブスクリプションの更新	サブスクリプションの更新と更新収益
サブスクリプションのキャンセル	キャンセルされたサブスクリプションと払い戻し額
サブスクリプションの再有効化	以前にキャンセルされた再アクティベートされたサブスクリプションと、そのサブスクリプションからの収益
アクティブなサブスクリプション	特定の日のアクティブなサブスクリプションの合計数
定期購入の健全性	自動更新と猶予期間のアクティビティ
キャンセルに関するアンケート	購読者から報告されたキャンセル理由
サブスクリプションフルフィルメント	レシートの配信状況と開発者確認の待ち時間

5. 集計と期間を選択する

• 集計： [HOURLY] または [DAILY] を選択します。
• 期間： プリセット（例：過去7日間または過去30日間）を選択するか、カスタムの日付範囲を選択して正確な日付を指定します。

クエリウィンドウは集計によって異なります。すべての時刻はUTCです。

• DAILY： 完了した日数のみをカウントし、昨日で終了します。今日はまだ終わっていないので除外されます。たとえば、今日が9月28日の場合、過去30日間は8月29日から9月27日までの期間を含みます。最大ルックバック期間は30日間です。
• HOURLY： 収益化指標では最大T-3時間、Vitals指標ではT-2時間になります。

6. 指標を選択する

指標複数選択ドロップダウンを使用して、含める指標を選択します。空欄のままにすると、選択した指標セットのすべての指標についてクエリが実行されます。

使用可能な指標は、指標セットによって異なります。以下に例を示します。

• Vitals LMK: lmkRate, lmkRate7dUserWeighted, lmkRate28dUserWeighted, userPerceivedLmkRate, userPerceivedLmkRate7dUserWeighted, userPerceivedLmkRate28dUserWeighted, distinctDevices, lmkCount
• 収益化サブスクリプションサインアップ：signups, signupRevenue
• 収益化サブスクリプションフルフィルメント：totalReceipts, fulfilled, unavailable, pending, notEligible, existingPurchase, notDelivered, p50AcknowledgementDelay, p90AcknowledgementDelay, p95AcknowledgementDelay

7. 任意： ディメンションを追加する

ディメンションを選択して結果の内訳を示します。各ディメンションは出力に列を追加します。使用可能なディメンションは、選択した API と指標セットによって異なります:

• Vitals： バージョンコード、国コード、デバイスモデル、デバイスタイプ、デバイスOS、OSバージョン
• 収益化： マーケットプレイス、期間限定SKU、デバイスタイプ、デバイスOS、サブスクリプションタイプ、更新タイプ、キャンセルタイプ、キャンセル理由、購入チャネル

8. 任意： フィルターを適用する

フィルターを使用すると、内訳を追加せずに結果を絞り込むことができます。1 つまたは複数のフィルター値を設定します。使用可能なフィルターは API によって異なります。

Vitalsフィルター

• バージョンコード: 特定のアプリのバージョンで絞り込みます。
• 国： 1つ以上の国（例：US）に絞り込む
• デバイスモデル： 特定のデバイスモデルに絞り込みます。
• デバイスタイプ： デバイスファミリーで絞り込む
• デバイスのOS： Fire OSまたはVega OSのデバイスで絞り込みます
• OSのバージョン： OSのバージョンで絞り込みます

収益化フィルター

• マーケットプレイス： 特定のマーケットプレイスに絞り込む
• 期間のSKU： 特定のサブスクリプション製品 SKU に絞り込む
• デバイスタイプ： デバイスファミリーで絞り込む
• デバイスのOS： Fire OSまたはVega OSのデバイスで絞り込みます
• サブスクリプションタイプ、更新タイプ、キャンセルタイプ、キャンセル理由、購入チャネル 対応するサブスクリプション属性で絞り込む

9. ページサイズを設定する

応答あたりの最大行数を選択します（デフォルト：1,000、最大：100,000）。

10. クエリを実行する

クエリを実行を選択します。レスポンスは右側の[レスポンス] パネルに表示されます。

リクエストのプレビューパネル

クエリを設定すると、[リクエストのプレビュー] パネルがリアルタイムで更新され、以下が表示されます。

• 完全なPOST URL
• 完全なcURLコマンドとJSONリクエスト本文

応答を全画面表示に展開して、大きな結果セットを確認できます。

レスポンスパネル

クエリを実行すると、[レスポンス]パネルに、以下を含む完全な JSON レスポンスが表示されます。

• rows[]それぞれ期間、ディメンション値、指標値
• ページネーショントークン (nextPageToken)さらに多くの結果が得られる場合

応答を全画面モーダルに展開して、大きな結果セットを調べることができます。

ヒント

API Explorerを使用する際は、以下のヒントを参照してください。

• シンプルに始める： 最初にディメンションやフィルターを指定せずにクエリを実行して、アプリにデータがあることを確認してから、内訳を追加します。
• 空の結果を確認： 結果が空の場合、選択した期間が利用可能なデータより未来になっている可能性があります。詳細については、クエリウィンドウのstep 5を参照してください。それよりも以前の日付範囲を試してみてください。
• コピーして統合： [リクエストプレビュー] を使用して、正確なリクエストをアプリコードにコピーします。
• 28日間の指標にはDAILYが必須：28日間のユーザー加重指標はHOURLY集計には使用できません。集計をDAILYに切り替えます。
• カウントと発生率： 絶対イベントボリュームには、crashCount、anrCount、またはlmkCountを使用してください。発生率指標は、バージョンまたはデバイス間で正規化された傾向を比較する場合に使用します。

関連トピック

• Reporting API： 売上、収益、定期購入レポートのダウンロード
• Vitals API V2の概要： 使用可能な指標とディメンション
• Vitals API V2リファレンス： 認証、エンドポイント、コード例、エラー処理
• 収益化指標APIの概要： 使用可能な指標とディメンション
• 収益化指標APIリファレンス： 前提条件、認証、APIエンドポイント、コード例、エラー処理、ベストプラクティス

---

Last updated: 2026年10月13日