テスト特典

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 からダウンロードしてインストールできます。

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

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

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

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

  • [Google でログイン] をタップします。
  • アプリのライセンス テスターとして登録されている Google アカウントを選択します。
  • ログインすると、メインのダッシュボードが表示されます。
Play Billing Lab ダッシュボード
Play Billing Lab のダッシュボード。
  • [ダッシュボード] で、[アプリ外で行われた購入] カードを見つけます。
  • [Test] をタップして、OOAP 構成のセットアップ画面を開きます。

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

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

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

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

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

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

    対象となる特典を選択する
    対象となる特典を選択します。

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

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

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

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

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

    OOAP テストを開始する
    OOAP テストを開始します。

ステップ 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 テストを停止してクリアする
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 ボトムシートに、オーバーライドした国の現地通貨でフォーマットされた商品価格が表示されるようになります。

国別のオーバーライドを使用してローカライズされた価格設定をテストする
国別のオーバーライドを使用して、ローカライズされた価格をテストします。

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

設定したテスト特典が Google Play ストアのアプリの詳細ページに表示されないのはなぜですか？

  • アカウントの一貫性: Google Play ストア アプリにログインしているアカウントが、Play Billing Lab にログインしているアカウントとまったく同じであることを確認します。
  • EAP 許可リストとライセンス テスターのステータス: デベロッパー アカウントが Play Billing Lab OOAP プレビュー EAP の許可リストに登録されていること、およびアカウントが Google Play Console で有効なライセンス テスターとして登録されていることを確認します。
  • 有効期限: 有効な OOAP テストは 2 時間後に期限切れになります。Play Billing Lab を開き、テストタグが [Expired] に変更されているかどうかを確認します。その場合は、新しいテストを開始します。

Play Billing Lab でアイテムを設定する際に、特典を選択または表示できないのはなぜですか？

  • 特典の利用資格: Play Billing Lab には、特定のテスター アカウントが現在購入できる特典のみが表示されます。

Play Express オーバーレイでテスト購入が失敗したのはなぜですか？

  • テストデバイスに Android 12（API レベル 31）以降が搭載され、最新バージョンの Google Play ストアがインストールされていることを確認します。
  • アプリのバックエンドの RTDN Webhook と API の統合を確認してください。Google Play ストア経由でテストする場合、購入はアプリの標準 UI の外部で行われます。バックエンド サーバーは、Google Play から RTDN メッセージを確実に受信し、非同期で購入を承認する必要があります。

2 時間のタイマーが切れる前に、アクティブなテストを停止またはクリアするにはどうすればよいですか？

  • Play Billing Lab を開き、有効なカード（[アプリ外で行われた購入] または [構成設定]）を見つけて、[停止] または [削除] をタップします。 プロンプトが表示されたら、選択内容を確認します。オーバーライドは Google Play サーバーから直ちに削除されます。