App Testerの使用手順
Amazon App Testerを使用してアプリを検証するには、以下の手順を実行します。-
次の構成情報をmanifest.tomlファイルに追加します。
- コンピューターをVDA経由でFire TVに接続します。VDAの詳細を参照してください。
-
次の手順でアプリをサンドボックスモードに設定します。
- JSONファイルを作成し、amazon.config.jsonという名前を付けます。このファイルに次のJSONコンテンツを追加します。
これは、IAPテスターに提供されるJSONファイルとは異なります。- Vega仮想デバイス(VVD)またはデバイス内にディレクトリを作成します。
- JSONファイルを先ほど作成した場所にプッシュします。デバイスにプッシュするには、App Testerをデバイスにインストールする方法を参照してください。
- アプリを再起動(終了してから再び起動)して、変更を適用します。
- JSONファイル内の値を
debugからprodに変更するか、JSONファイルを削除して、サンドボックスモードを無効にします。
- Amazon App Testerを再インストールします。 Amazon App Testerの既存バージョンをアンインストールしてから、最新バージョンをダウンロードし、デバイスで開きます。
IAP APIの選択
App Testerアプリを初めて起動すると、次のスプラッシュ画面が表示されます。
Appstore SDK APIのプロンプトをタップして開始します。
IAP APIのナビゲーションオプションが表示されます。
- User Account Settings: アプリのテストユーザーアカウントを構成します。
- Subscription Purchase Settings: 定期購入型アイテムの購入設定を使用して、RVS Sandboxのレスポンスをテストします。
- IAP API Response Settings: テストケースの条件やレスポンスを構成します。
- Manage Transactions: アプリのアクティブなIAPトランザクションを管理します。
- Notification Settings: ドロワーに追加される通知を有効または無効にします。
- 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 standard(英語のみ)の国コード一覧にあるほとんどのコードがサポートされています。 ただし、ISO国コード一覧の次のコードは除外されます。- AF: アフガニスタン
- BQ: ボネール、シント・ユースタティウスおよびサバ
- CU: キューバ
- CW: キュラソー
- IQ: イラク
- IR: イラン・イスラム共和国
- KM: コモロ
- LY: リビア
- SD: スーダン
- SS: 南スーダン
- SX: シント・マールテン(オランダ領)
- SY: シリア・アラブ共和国
- AN: オランダ領アンティル
ユーザープロフィールへのアクセスの同意ステータスを選択する方法
App Testerには、同意ステータスについて UNAVAILABLEとCONSENTEDという2つのオプションがあります。同意ステータスを変更するには、[User Profile Access] > [Consent Status] で、テストに使用するステータスを選択します。定期購入型アイテムの設定
定期購入型アイテムの購入設定を使用して、RVS Sandboxのレスポンスをテストします。
APIレスポンスの設定
IAP APIのテスト呼び出しの条件やレスポンスを設定するには、[IAP API Response Settings] タブを使用します。
レスポンスとして [Default] を選択すると、既存のデフォルト設定が使用されます。「Default」という設定が存在するわけではありません。SUCCESSFULやFAILEDなどの値を明示的に選択した場合は、その値がApp Testerから返されます。たとえば、JSON ファイルにリクエストされたSKUが含まれている場合は、 getProductDataはSUCCESSFULを返します。ユーザーが**[User Account Settings]で[Logged Out]**している場合、GetUserDataは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ファイルが正しく追加されていない場合、このタブには、エラーメッセージまたはJSONファイルが存在しないという通知が表示されます。
ユーザーエクスペリエンスのシミュレーション
App Testerは、APIレスポンスを返すだけでなく、公開されたライブ状態のアプリと同じように購入フローダイアログを表示します。これらのダイアログは、アプリの購入プロセスのユーザーエクスペリエンスを評価するために役立ちます。 App Testerは、購入リクエストごとに2つのインタースティシャルダイアログを表示します。1つ目は詳細画面で、購入価格などの詳細情報が表示されます。次のIAPの例を参照してください。 アプリ内課金の例は次のとおりです。
2番目のダイアログは、購入者へのお礼を表示する画面です。このページは、ユーザーが右上隅の [X] ボタンをタップして手動で閉じる必要があります。次の画像は閉じるボタンの例です。
IAPテスターのログ
IAPテスターのログに関する詳細は次のとおりです。- 詳細については、アプリのデバッグを参照してください。
-
IAPテスターのログを取得するには、次のキーワードで検索します:
AmazonIAPTester

