テスト特典

Play Billing Lab は、Google Play 課金システムとの統合をテストするのに役立つコンパニオン アプリです。Play Billing Lab のアプリ外で行われた購入（OOAP）プレビュー テストを使用すると、Play Games の特典など、アプリ外で取得されたアイテムを処理するようにバックエンドが適切に構成されていることを検証できます。

OOAP プレビュー機能を使用すると、Google Play のアプリの詳細ページなど、アプリ外のサーフェスに表示する特定のアイテムや特典を選択し、利用資格の取得とフルフィルメントのエンドツーエンドのフローを確認できます。

前提条件

Play Billing Lab を使用してアプリ外で行われた購入（OOAP）フローをテストし、Play Games の特典の設定を検証する前に、次の要件を満たしていることを確認してください。

1. Play Games の特典の EAP に登録する。

2. ライセンス取得済みのテスターのステータス: テスト アカウントは、ゲームのライセンス取得済みのテスターとして登録されている必要があります。詳細については、Google Play のライセンス テスターに関するドキュメントをご覧ください。

   注: Play Billing Lab アプリはどのユーザーでも表示できますが、OOAP オーバーライドを構成してトリガーできるのは、許可リストに登録されている EAP デベロッパーのライセンス テスターのみです。

3. サーフェス間でのアカウントの一貫性: Play Billing Lab と Google Play ストアには、同じライセンス取得済みテスターのアカウントを使用してログインする必要があります。アカウントが一致しない場合、Google Play ストアはオーバーライドされたテスト用のアイテムや特典を表示しないか、テスト購入を完了しない可能性があります。

ダウンロードとインストール

Play Billing Lab は、Google Play からダウンロードしてインストールできます。

• Google Play ストア（Android）: Play Billing Lab アプリ
• ウェブテスト トラック: Play Billing Lab のウェブ オプトイン

EAP の統合とテストの詳細なガイド

次の手順では、Play Billing Lab を使用して Play Games の特典を統合してテストする方法について説明します。

ステップ 1: Play Billing Lab を起動してログインする

インストール後に Play Billing Lab を初めて開く場合:

• [Google でログイン] をタップします。
• アプリのライセンス テスターとして登録されている Google アカウントを選択します。
• ログインすると、メインのダッシュボードが表示されます。

ステップ 2: アプリ外で行われた購入（OOAP）のテストに移動する

• [ダッシュボード] で、[アプリ外で行われた購入] カードを見つけます。
• [Test] をタップして、OOAP 構成のセットアップ画面を開きます。

ステップ 3: アプリ パッケージ名とプロダクト ID を指定する

OOAP の設定画面で、必要なアプリ ID を入力します。

1. パッケージ名: アプリの正確な Android パッケージ名（例: com.example.app）。
2. 商品タイプ: プルダウン メニューを使用して、[1 回限りのアイテム]（アプリ内アイテム）または [定期購入] を選択します。
3. プロダクト ID（SKU）: テストするアプリ内アイテムまたは定期購入のプロダクト ID。

ステップ 4: 対象となる特典を選択する

パッケージ名、商品 ID、商品タイプを入力すると、Play Billing Lab がバックエンドにクエリを実行し、その商品で利用可能な特典のリストを表示します。

• 1 回限りのアイテムの場合: 該当する購入オプションまたは特典を選択します。

  

ステップ 5: OOAP テストを開始する

特典を選択したら、[テストを開始] をタップします。構成が保存され、Google Play バックエンド サーバーと同期されます。

有効化すると、ダッシュボードの [アプリ外で行われた購入] カードに [有効] バッジが表示され、設定されたパッケージ名、商品 ID（SKU）、残りの期間が表示されます。

• テスト ウィンドウ: 有効な OOAP テスト構成は、デフォルトで 2 時間有効なままになり、その後自動的に期限切れになります。

• バックエンドのオーバーライド: 有効な場合、この構成はさまざまな OOAP サーフェス（Google Play ストアのアプリの詳細ページなど）で最優先として表示されます。

  

ステップ 6: アプリ外の特典のエンドツーエンドの獲得フローをテストする

Play Billing Lab で OOAP テストが有効になっている間に、同じライセンス テスター アカウントでログインした Google Play ストア アプリを開きます。

1. Google Play ストアのキャッシュを削除する:
   1. 端末の [設定] を開きます。
   2. [アプリ] > [Google Play ストア] をタップします。
   3. タップストレージとキャッシュそしてタップしますキャッシュをクリアそしてクリアストレージ。
2. Google Play ストア アプリを起動
3. アプリの詳細ページに移動します。

4. テスト購入を完了する（Play Express オーバーレイ）: アイテムのカードをタップします。Google Play ストアにネイティブの Google Play Express の購入手続きボトムシートがオーバーレイされます。

   • 価格、お支払い方法（ライセンスを取得したテスターのテスト方法）、特典の詳細を確認します。
   • [1 タップで購入] をタップして取引を完了します。

   

5. バックエンドの統合を確認する:

   • 購入が成功したら、Google Play からバックエンド サーバーにリアルタイム デベロッパー通知（RTDN）が送信されることを確認します。
     • 注: リワードでも RTDN が送信されます。
   • サーバーが Google Play Developer API を呼び出して購入を承認し、ユーザーに利用資格を付与していることを確認します。
   • Google Play ストア アプリでユーザーの購入履歴をチェックして、テスト注文が記録されていることを確認します。

ステップ 7: OOAP テストを停止してクリアする

テストが完了したら、次の操作を行います。

1. [アプリ外で行われた購入] ページに移動します。
2. [Clear test] をタップして、OOAP テストを停止し、OOAP テストの設定をクリアします。

テスト構成の変更

OOAP プレビュー テストの実行中は、パッケージ名、プロダクト ID、特典の選択、Google Play ストアの国のオーバーライドを変更することはできません。

これを行うには、現在の OOAP テストを停止してクリアする必要があります

商品または特典を編集する方法

現在 OOAP テストを実施していて、別の商品または特典をテストする場合は、次の手順を行います。

1. Play Billing Lab を開き、有効な [アプリ外で行われた購入] カードの [表示] をタップします。
2. [編集] をタップして、パッケージ名、商品 ID、テスト用特典を変更します。
3. プロンプトが表示されたら、[テストを停止] を確定します。テストが停止され、関連する入力がすべて消去されます。
4. 新しい商品を入力するか、新しいオファーを選択して、テストを再開します。

国別のオーバーライドを使用してローカル価格設定をテストする方法

Play Billing Lab では、Google Play ストアの国をオーバーライドして、地域別の価格設定と通貨形式をテストできます。ただし、国の変更は、OOAP テストと完全に同期する必要があります。

1. アクティブな OOAP テストを停止する: OOAP テストがアクティブなときに、ダッシュボードまたはアプリ外購入ページから国オーバーライドを編集しようとすると、Play Billing Lab に警告が表示され、最初にテストを停止するよう求められます。[テストを停止] をタップして確定すると、現在の OOAP テストが停止し、テスト入力が消去されます。

2. 国のオーバーライドを設定する: OOAP テストを停止した後、[構成設定] ページで国の設定を編集できます。対象国（日本、英国など）を選択し、[適用] をタップします。

3. OOAP テストを再開する: 国のオーバーライドが有効になったら、[アプリ外で行われた購入] カードに戻り、アイテムと特典を選択して、[テストを開始] をタップします。

   ダッシュボードに、有効な国オーバーライドと有効な OOAP テストの両方が表示されます。

4. Google Play ストアでローカライズされた価格を確認する: Google Play ストアを開き、アプリの詳細ページにアクセスします。表示された UI カードと Play Express ボトムシートに、オーバーライドした国の現地通貨でフォーマットされた商品価格が表示されるようになります。

トラブルシューティングとよくある質問