メインコンテンツまでスキップ

アプリ内課金のテスト（サンドボックス環境）

Aptoide Connect でアプリ内課金（IAP）を含む iOS アプリケーションを配布するには、アプリに当社の課金ソリューションが実装されている必要があります。当社の Swift SDK または Unity プラグイン のいずれかを統合することを選択できます。

これらのソリューションのいずれかを実装した後、アプリの IAP をテストして、統合が正しく機能しているかどうかを確認する必要があります。このため、IAP をテストするためのサンドボックス環境を開発しました。

アプリの IAP をテストするには、次のことを行う必要があります。

  1. テスト用ウォレットアドレスを取得します。
    Swift では、次を呼び出して行うことができます。 
    Sandbox.getTestingWalletAddress()
    Unity では次のとおりです。 
    AppCoinsSDK.Instance.GetTestingWalletAddress()
  2. テスト用ウォレットアドレスを、開発者コンソールのサンドボックスメニューに追加します。
  3. そのテスト用ウォレットアドレスを使用して、アプリで購入を行います。
🚧
サンドボックスウォレットにアカウントを関連付ける

ウォレットの種類の理解:

  • デフォルトでは、SDK はゲストウォレット（一時的でデバイス固有）を使用します
  • .getTestingWalletAddress() を呼び出すと、現在アクティブなウォレットアドレスが返されます

永続的なサンドボックスウォレットを使用するには:

  1. アプリで任意の購入を開始します
  2. チェックアウト画面が表示されたら、アカウントにログインします
  3. ログインすると、アカウントが永続的なウォレットに関連付けられます
  4. 以降、.getTestingWalletAddress() はこのアカウントのウォレットアドレスを返します

メリット:

  • サンドボックスウォレットがアプリの起動をまたいで永続化されます
  • 同じアカウントにログインすることで、複数のデバイスで同じウォレットにアクセスできます
  • テスト用のサンドボックス資金を管理および再利用しやすくなります
🚧
サンドボックス環境を使用するには、アプリの所有権を持っていることが必須です

Aptoide Wallet でサンドボックス環境を確認し、アプリのアプリ内課金をテストできるようにするには、Aptoide Connect でアプリの所有権を持っていることが必須です。

アプリをアカウントに追加し、アプリの所有権を正常に証明した後にのみ、サンドボックス環境（Aptoide Wallet 上で支払い方法として表示されます）を確認できるようになります。

サンドボックス環境の使用​

サンドボックスメニューにアクセスするには、Aptoide Connect の開発者コンソールに移動し、Apps > Sandbox をクリックします。

Aptoide Connect 開発者コンソールのサンドボックスメニュー

​

このメニューでは、テスト専用のウォレットアドレスを追加し、アカウントに追加されたすべてのウォレットアドレスを確認し、それらを管理できます。

テスト用の新しいウォレットアドレスを追加するには、「Add」をクリックし、サンドボックス環境でテスト専用のウォレットアドレスを貼り付けて、「Add」をクリックします。

​

サンドボックスメニューの「Added」列は、ウォレットアドレスが Aptoide Connect アカウントに追加された日時を指します。「Expiration」列は、ウォレットアドレスが自動的に非アクティブに設定される日時を示します。最後に、「Active」列は、特定のウォレットアドレスがサンドボックス環境を使用できるかどうかを切り替えて変更できる場所です。

ステータスと有効期限の列があるサンドボックスウォレットアドレスのリスト
📘
サンドボックスメニューに追加されてから 30 日後、ウォレットアドレスは自動的に「Inactive」に設定されます

ウォレットアドレスがサンドボックスメニューに追加されると、サンドボックス環境で使用できるよう、トグルが「Active」に設定されます。30 日後、このトグルは自動的に変更され、テスト用ウォレットアドレスは「Inactive」に設定されます。

非アクティブになると、ウォレットアドレスは通常のウォレットになり、サンドボックス環境で使用することはできません。テストのために再び使用できるようにするには、トグルを再び「Active」に変更する必要があります。

ウォレットアドレスが自動的に非アクティブに設定される日時は、「Expiration」列の日付を見ることで確認できます。

あるいは、アプリ申請フォームの画面でサンドボックスメニューにアクセスすることもできます。

アプリ申請フォームからアクセスできるサンドボックスメニュー
❗️
サンドボックス環境を使用するにはログイン確認を設定する必要があります

アプリのアプリ内課金をテストするためにサンドボックス環境を使用するには、ログイン確認を設定してアクティブにする必要があることに注意してください。これを行う方法については、こちらをクリックしてください。

アプリ内課金のテスト​

Aptoide Connect でウォレットアドレスを追加した後、次の手順に従ってアプリ内でアプリ内課金をテストできます。​

  • アプリで購入したいアイテムを選択します。
  • 下にスクロールして、購入を続行するために Sandbox オプションを選択します。
モバイルでのアプリ内課金中のサンドボックス支払いオプション

​

購入が完了すると、購入が完了したことを示すポップアップメッセージが画面に表示されます。アプリ内課金が正常に完了したことを確認するには、Aptoide Connect の開発者コンソールの上部メニューバーにある ウォレット にアクセスし、「Only display sandbox transactions」オプションにチェックを入れます。

サンドボックス取引フィルターが有効になったウォレットページ

そこで、サンドボックス環境で行われた取引のリストを確認し、たった今行った購入を確認できます。また、アプリでアイテムが受け取られたかどうかも確認してください。

購入を行い、アイテムを正しく受け取り、エラーが発生しなければ、当社の課金ソリューションの統合に成功したことになります。

よくある質問 (FAQ)​

サンドボックスでテストする前にアプリをアップロードする必要がありますか?​

簡潔な回答: いいえ、iOS では Xcode ビルドから直接テストできます。

詳細: iOS のアプリ内課金は、事前のアップロードなしで、Xcode ビルドからそのままサンドボックスでテストできます。（Android では、フローが異なります。まず Aptoide Connect コンソールでアプリ内製品を追加し、サンドボックス環境にウォレットを追加します。アプリ内課金のテストを参照してください。）

iOS のサンドボックステストを Simulator で実行できますか?​

簡潔な回答: いいえ、課金の分岐（Apple IAP と Aptoide 課金）をテストするには実機が必要です。

詳細: インストール元を識別する Apple の AppDistributor フレームワークは Simulator では利用できないため、.isAvailable() は常に true を返します。このため、Simulator では Apple のアプリ内課金と Aptoide 課金の間の分岐を検証できません。実機を使用してください。

サンドボックスのテスト購入を返金するにはどうすればよいですか?​

簡潔な回答: サンドボックスのテスト購入の返金は手動で行います。

詳細: 取引 UID を Aptoide サポートチームに共有し、返金を依頼してください。

一般的な問題​

iOS のサンドボックス環境を選択できない​

簡潔な回答: テスト用ウォレットがアクティブになっていません。

修正方法: 開発者コンソールの Sandbox セクションで、テスト用ウォレットアドレスが追加されていること、および その Active スイッチがオンになっていることを確認してください。

ウォレットアドレスを入力するとウォレットの復元に失敗する​

簡潔な回答: アドレス（0x...）を手動で入力してウォレットを復元することはできません。

修正方法: Aptoide Wallet アプリでウォレットを作成した際に保存されたバックアップファイルまたは復元用テキストを使用してください。