Amazon Developer

Console

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases

Console

as

開発
設計と開発
公開
リファレンス
サポート
メインコンテンツへスキップ
App Testerは、アプリをAmazonアプリストアに公開する前に、Amazonアプリ内課金（IAP）の機能をテストすることができるツールです。App Testerツールをダウンロードしてインストールし、設定を完了したら、IAP機能のテストを開始できます。 まだApp Testerをアプリ用にセットアップしていない場合は、App Testerをインストールして構成する方法を参照してください。 Amazon App Testerは、Amazonアプリストアでの認証をシミュレートするためのツールです（以前はIAPでのみ使用されていました）。App Testerはこちらからダウンロードできます。

​
App Testerの使用手順

Amazon App Testerを使用してアプリを検証するには、以下の手順を実行します。
  1. 次の構成情報をmanifest.tomlファイルに追加します。
  2. コンピューターをVDA経由でFire TVに接続します。VDAの詳細を参照してください。
  3. 次の手順でアプリをサンドボックスモードに設定します。
    1. JSONファイルを作成し、amazon.config.jsonという名前を付けます。このファイルに次のJSONコンテンツを追加します。
    これは、IAPテスターに提供されるJSONファイルとは異なります。
    1. Vega仮想デバイス（VVD）内またはデバイス上に/tmp/scratch/<アプリID>というディレクトリを作成します。
    2. JSONファイルを先ほど作成した場所にプッシュします。デバイスにプッシュするには、App Testerをデバイスにインストールする方法を参照してください。VVDにプッシュするには、App TesterをVVDにインストールする方法を参照してください。
    3. アプリを再起動（終了してから再び起動）して、変更を適用します。
    4. JSONファイル内の値をdebugからprodに変更するか、JSONファイルを削除して、サンドボックスモードを無効にします。
    サンドボックスモードでは、通常であればAmazonアプリストアクライアントに向かう呼び出しを、強制的にAmazon App Testerアプリへとルーティングします。このモードは、ローカルでのテストにのみ使用します。
  4. Amazon App Testerを再インストールします。 Amazon App Testerの既存バージョンをアンインストールしてから、最新バージョンをダウンロードし、デバイスで開きます。

​
App TesterをVVDにインストールする方法

VVDにApp Testerをインストールするには、次のコマンドを使用します。
VVDからApp Testerをアンインストールするには、次のコマンドを使用します。

​
IAP APIの選択

App Testerアプリを初めて起動すると、次のスプラッシュ画面が表示されます。 スプラッシュ画面 Appstore SDK API’sというプロンプトをタップして開始します。 IAP APIのナビゲーションオプションが表示されます。
  1. User Account Settings：アプリのテストユーザーアカウントを構成します。
  2. Subscription Purchase Settings：定期購入型アイテムの購入設定を使用して、RVS Sandboxのレスポンスをテストします。
  3. IAP API Response Settings：テストケースの条件やレスポンスを構成します。
  4. Manage Transactions：アプリのアクティブなIAPトランザクションを管理します。
  5. Notification Settings：ドロワーに追加される通知を有効または無効にします。
  6. IAP Items in JSON File：JSONファイルからApp Testerに追加されたデータを、人間が簡単に判読できる形式で表示します。

​
ユーザーの管理

ユーザーのログインとログアウト、ユーザーの変更、ユーザーに関連付けられているマーケットプレイスの変更を行うことができます。これらのオプションを設定すると、ユーザーやマーケットプレイスをさまざまに変えて、条件の異なるシナリオを簡単にテストできます。 ユーザー管理画面にアクセスするには、App TesterのランディングページからIAP APIを選択し、[User Account Settings] をタップします。 ユーザーアカウントの設定

​
ログインとログアウトの切り替え

現在のユーザーのログインとログアウトを切り替えるには、[Status] の [Logged in] または [Logged Out] オプションをタップします。

​
現在のユーザーの選択

App Testerには、3つのテストユーザーアカウントが用意されています。テストユーザーには、Amazon User 1、Amazon User 2、Amazon User 3という名前が付いています。 ユーザーを変更するには、[Amazon User Id] で、テストに使用するユーザーIDを選択します。

​
現在のユーザーのマーケットプレイスを選択する方法

App Testerでは、世界中のさまざまなマーケットでアプリをテストできます。現在のユーザーに関連付けられているマーケットプレイスを変更するには、[User Marketplace] で新しいマーケットを選択します。 利用可能なマーケットは次のとおりです。
  • US：米国
  • CA：カナダ
  • BR：ブラジル
  • MX：メキシコ
  • GB：英国
  • DE：ドイツ
  • ES：スペイン
  • FR：フランス
  • IT：イタリア
  • IN：インド
  • JP：日本
  • AU：オーストラリア

​
ユーザーの国コードを選択する方法

App Testerには、さまざまな国コードでアプリをテストする機能があります。ユーザーに関連付けられている国コードを変更するには、[User Country Code] で国を選択します。Amazonアプリストアでは、ISO 3166-1 alpha-2標準（英語のみ）の国コード一覧にあるほとんどのコードがサポートされています。 ただし、ISO国コード一覧の次のコードは除外されます。
  • AF：アフガニスタン
  • BQ：ボネール、シント・ユースタティウスおよびサバ
  • CU：キューバ
  • CW：キュラソー
  • IQ：イラク
  • IR：イラン・イスラム共和国
  • KM：コモロ
  • LY：リビア
  • SD：スーダン
  • SS：南スーダン
  • SX：シント・マールテン（オランダ領）
  • SY：シリア・アラブ共和国
以下は、ISO国コード一覧に含まれていない追加のコードです。
  • AN：オランダ領アンティル

​
ユーザープロフィールへのアクセスの同意ステータスを選択する方法

App Testerには、同意ステータスについてUNAVAILABLEとCONSENTEDという2つのオプションがあります。同意ステータスを変更するには、[User Profile Access] > [Consent Status] で、テストに使用するステータスを選択します。

​
定期購入型アイテムの設定

定期購入型アイテムの購入設定を使用して、RVS Sandboxのレスポンスをテストします。 定期購入型アイテム購入の設定

​
APIレスポンスの設定

IAP APIのテスト呼び出しの条件やレスポンスを設定するには、[IAP API Response Settings] タブを使用します。 IAP API Response Settings レスポンスとして [Default] を選択すると、既存のデフォルト設定が使用されます。「Default」という設定が存在するわけではありません。SUCCESSFULやFAILEDなどの値を明示的に選択した場合は、その値がApp Testerから返されます。たとえば、getProductDataは、リクエストされたSKUがJSONファイルに含まれているとSUCCESSFULを返します。GetUserDataは、[User Account Settings] でユーザーが [Logged Out] に設定されているとFAILEDを返します。 各IAP APIで選択できるレスポンスは次のとおりです。

​
トランザクションの管理

現在のユーザーの購入トランザクションの表示、キャンセル、削除を行うには、[Manage Transactions] タブを使用します。トランザクションのキャンセルと削除は、非消費型アイテムや定期購入型アイテムをテストするときに役立ちます。このタブには、現在のユーザーのすべてのトランザクションが表示されます。 トランザクションの管理 [Manage Transactions] タブには、トランザクションごとに次の情報が表示されます。
  • RECEIPT：購入された商品のタイプ。IAPで有効な値は、CONSUMABLE、ENTITLEMENT、SUBSCRIPTIONです。
  • RECEIPT ID：トランザクションの一意の識別子。
  • SOLD BY：アイテムを販売したアプリ。
  • PURCHASED ON：ユーザーがアイテムを購入した日付。
  • STATUS：トランザクションのステータス。有効な値は、PURCHASEDまたはCANCELEDです。これらのApp Testerの値はそれぞれ、IAP APIの値FULFILLEDとUNAVAILABLEに対応しています。
アプリがPurchasingService.notifyFulfillment({receiptId: receipt.receiptId, fulfillmentResult: FulfillmentResult.FULFILLED})を呼び出すと、[Manage Transaction] セクションにレシートが FULFILLEDというステータスで表示されます。 [Manage Transactions] タブでは、以下を実行できます。
  • 現在のユーザーのトランザクションの一覧を最新の状態に更新する。
  • 現在のユーザーのトランザクションをすべて削除する。
  • 個々のトランザクションをキャンセルする。
  • 個々のトランザクションを削除する。

​
通知の有効化または無効化

[Notification Settings] タブを使用すると、ドロワーに追加される通知を簡単に有効または無効にすることができます。 次の図は [Notification Settings] タブを示しています。 通知の設定 次の通知を設定できます。
  • [Purchase Updates Notifications]：デフォルトでは、アプリが購入ダイアログを読み込んだ後、getPurchaseUpdates()を呼び出さなかった場合に、Amazonから通知が送信されます。アプリでgetPurchaseUpdates()を1回呼び出すと、この通知は送信されなくなります。この通知のオンとオフは、[Purchase Updates Notifications] の設定で切り替えることができます。
  • [Notify Fulfillment Notifications]：デフォルトでは、ユーザーが購入を行った後、30秒以内にアイテムが付与されなかった場合に、Amazonから通知が送信されます。この通知のオンとオフは、[Notify Fulfillment Notifications] で切り替えることができます。
  • [Reset Purchase Updates]：この設定により、getPurchaseUpdates()が呼び出されたかどうかを示す状態をリセットできます。

​
JSONファイル内のIAPアイテムの確認

[IAP Items in JSON File] タブをタップすると、構成したJSONファイル内のIAPアイテムを簡単に確認できます。有効なJSONファイルが正しく追加されていれば、App Testerによってファイルの内容が解析され、このタブに表示されます。 JSONファイルのIAPアイテム 有効なJSONファイルが正しく追加されていない場合、このタブには、エラーメッセージまたはJSONファイルが存在しないという通知が表示されます。

​
ユーザーエクスペリエンスのシミュレーション

App Testerは、APIレスポンスを返すだけでなく、公開されたライブ状態のアプリと同じように購入フローダイアログを表示します。これらのダイアログは、アプリの購入プロセスのユーザーエクスペリエンスを評価するために役立ちます。 App Testerは、購入リクエストごとに2つのインタースティシャルダイアログを表示します。1つ目は詳細画面で、購入価格などの詳細情報が表示されます。次のIAPの例を参照してください。 アプリ内課金の例は次のとおりです。 アプリ内課金 2番目のダイアログは、購入者へのお礼を表示する画面です。このページは、ユーザーが右上隅の [X] ボタンをタップして手動で閉じる必要があります。次の画像は閉じるボタンの例です。 定期購入ダイアログ

​
IAPテスターのログ

IAPテスターのログに関する詳細は次のとおりです。
  • 詳細については、アプリのデバッグを参照してください。
  • IAPテスターのログを取得するには、AmazonIAPTesterというキーワードをgrep検索します。
最終更新日 2026年10月26日