KappSナレッジベース · ブログ

2026年版Google Play課金テスト購入:ライセンステスター向けステップバイステップチュートリアル

ブログ チュートリアル

Google Playのライセンステストは、有料アプリができる最も安価な保険であり、多くのチームが飛ばしてしまうステップです。課金ユーザーが1人でもストア掲載情報に到達する前に、Play Billingを通じて実際のテスト購入を実行し、バックエンドが実際の購入トークンを受け取るのを確認し、カードが拒否されたときに何が起こるかを、誰にも請求せずに正確に把握できます。このチュートリアルでは、デベロッパーが混同しがちな3つの要素、ライセンステスター(Play Consoleのリスト)、テスト用決済手段(テスターが購入ダイアログで目にする支払い方法)、Play Billing Lab(国、更新、アカウント保留を偽装するGoogleアプリ)を順に解説します。

期限はもうひとつあり、これも同じ文脈で押さえる必要があります。テストケースの書き方が変わるからです。アプリとアップデートはPlay Billing Library バージョン8以降でリリースする必要があり、猶予期間は2026年11月1日まで設けられています。バージョン7の挙動を検証するサンドボックスでは、リリースビルドの動作はわかりません。

ステップ1 · 本当に必要なサンドボックスを見極める

「テスト」と呼ばれる3つの異なる設定があり、それぞれ別の問いに答えるものです。デバイスに触れる前に選びましょう。

  • 開発中はライセンステスターを利用しましょう。「クライアントコードは購入、確認応答、消費を正しく処理できるか」という問いに答えます。サイドロードしたビルドで動作するため、何もアップロードせずに反復できます。Googleの公式ドキュメントにも、Billing Libraryは通常、署名されてPlayにアップロードされていないアプリではブロックされるが、ライセンステスターはそのチェックの対象外であると記載されています。
  • テストトラックとライセンステスター。「Google Playが実際に配信するビルドは同じように動作するか?」という問いに答えます。これには内部テストトラックを使用してください。課金関連の作業にGoogleが推奨するトラックです。
  • 通常のGoogleアカウントを使ったテストトラック。「第三者の実際のカードで決済が成功し、正しく請求されるか」を確認できます。これらの購入には実際の費用がかかり、下書きアプリや内部テストトラックのリリースには利用上限が適用されます。

最初の設定だけをいつも実行しているなら、自分の仮定を二度テストしていることになります。3つの設定は累積するものであり、代替ではありません。

ステップ2 · Play Consoleでテスターを追加する

  1. Play Consoleを開き、設定 → ライセンステストに移動します。
  2. テスターはメールリストまたはGoogleグループとして追加します。メールリストは最大2,000件のアドレスを保持でき、Googleグループには人数上限がありません。QAスタッフが入れ替わる代理店がグループを使うのはそのためです。
  3. 変更を保存します。自分の公開アカウントは常にライセンスされたテスターとして扱われるため、最初に購入できるのはあなた自身です。

テスターが実際に商品にたどり着けるかどうかは2つの条件で決まり、これらが「購入ボタンがグレーアウトする」原因の定番です:

  • アプリはオープンテスト、クローズドテスト、内部テスト、または製品版トラックのいずれかで公開されている必要があります。さらにテスターがそのリリースを受け取れる状態、つまりトラック(またはそのGoogleグループ)に追加され、テストのオプトインURLからオプトインしている必要があります。
  • テストしたい単発商品とサブスクリプションは公開済みである必要があります。未公開の商品は、テスターの設定がどうであれ購入フローに存在しません。

テストトラックに公開した後、テスターがインストールできるまで数時間かかる場合があるとGoogleは指摘しています。QAセッションの当日朝ではなく前日からその時間を見込んでください。

ステップ3 · テスターの端末に購入可能なビルドを配置する

ライセンステスターは「署名してアップロード済み」のチェックを免除されるため、デバッグビルドを直接インストールしても購入ダイアログが機能します。厳格な条件が1つあり、パッケージ名がPlay Consoleで設定したアプリと一致している必要があります。.debugサフィックス付きのデバッグバリアントは正常に見えても課金時に失敗します。

アカウントはビルドと同じくらい重要です。テスト用アカウントはテスターの端末に入っている必要があり、端末に複数のGoogleアカウントがある場合、購入はアプリをダウンロードしたアカウントで行われます。どのアカウントもダウンロードしていない場合は、端末の最初のアカウントで行われます。購入ダイアログを展開すると支払い中のアカウントが表示されるので、購入が誤ったユーザーに紐づく問題を診断する最短の方法です。

ステップ4・テスト用ツールで購入する

ライセンステスターには実際のカードではなくテスト用の支払い方法が割り当てられる。そのうち2つが価値の大半を占める:

  • テスト用インストゥルメント、常に承認 — 購入を完了してトークンを返すため、エンタイトルメントの配信、レシート検証、確認応答をテストできます。
  • テスト用決済手段、常に拒否 — 課金が失敗するケースで、実際のユーザーが遭遇するまで多くの実装が見落とします。アプリは復旧可能なエラーを表示し、ユーザーには何も残さないようにする必要があります。無料でアンロックされてはいけません。

テスト購入は通常の購入フローを再利用しますが、知っておくべき違いが2つあります。税金は計算されないこと、そしてダイアログの中央に購入がテストであることを示す通知が表示されることです。その通知が見えない場合、テスト購入ではありません。コードではなくアカウントを確認してください。

サブスクリプションは、テスト用の仕組みが通用しなくなる領域です。テストの更新は実際の請求期間を待たないため、更新、猶予期間、アカウント保留のロジックには、Play Billing Labの高速化機能か、記録済みの購入トークンに対するサーバー側シミュレーションのいずれかが必要です。

ステップ5 · 3分以内に確認応答する

Googleのドキュメントはこの点を異例なほど具体的に説明しています。ライセンステスターによる購入で、アプリが購入を確認(acknowledge)しない場合、注文は3分後に返金され、キャンセルに関するメールが届きます。同じことはPlay Consoleの注文タブでも確認できます。

この3分間の猶予は厄介な仕様ではなく、機能です。これにより確認処理が目に見えるテストになります。購入し、確認する前にアプリを終了し、待ってから注文を確認します。注文が残っていれば、確認処理が想定外の場所で発火しています。多くの場合、壊れたサーバー呼び出しを隠すリトライループです。同じテストで逆のバグも見つかります。非消耗型アイテムを消費型として扱うと、本来は二度買えない商品が二度買えるようになります。

ステップ6 · Play Billing Labで困難な状態をリハーサルする

Play Billing LabはGoogleが公開する独立したAndroidアプリで、テストビルドと課金バックエンドの間に位置します。Googleのドキュメントによると、得られるものは次のとおりです。

  • テスト用に配信国を変更すれば、拠点を移さずに地域別の価格表示と利用資格を確認できます。
  • トライアルと導入オファーは同じアカウントで繰り返し利用できるように。そうしなければ特典は初回で使い切りの一度きりになります。
  • 他の有効な購読者に影響を与えずにサブスクリプション価格の変更をテストできます。
  • サブスクリプションの状態遷移を高速化:更新を強制実行し、何日も待たずに1回の操作でサブスクリプションを猶予期間やアカウント保留に移行できます。
  • 特定の購入フローのリスクシグナルを回避するには、実際の支払い方法を使用してください。
  • アプリ外での購入をテストし、アプリ内で開始されたことを検知していない取引もバックエンドで処理できるようにしてください。

同じドキュメントに書かれている運用上の注意点が3つあり、どれも後から知ると半日を無駄にします。Play Billing Labには課金に使っているものと同じアカウントでサインインすること、そのアカウントがテスト対象アプリのライセンステスターであること、そして設定は2時間で失効することです。変更が反映されていないように見える場合は、サインインし直して再試行し、テストを実行する端末のPlayストアのキャッシュをクリアしてください。

ステップ7 · その後、意図的にサンドボックスを壊す

最後に忘れられがちなのが、ライセンステスターではないアカウントでの購入の繰り返しです。ライセンステスターにはテスト向けに調整された挙動(わかりやすい例では更新期間)が適用されるため、ライセンステスターとしかテストしてこなかったアプリは、テスト環境に暗黙的に依存したロジックをリリースしてしまう可能性があります。まさにこの理由から、また大きな課金変更の後には、通常のアカウントで時折テストすることをGoogleは推奨しています。

これらの購入は実際の課金であり、返金はサポートフローであってトグルではないため、予算を見込んでおいてください。低価格の商品で実行し、注文IDを保管し、ユーザーに異議申し立てを求めるのではなくPlay Consoleから意図的に返金してください。

大半を占める6つの失敗要因

  1. パッケージ名の不一致。 デバッグ版はPlay ConsoleのapplicationIdとは異なるIDでインストール・課金されるため、課金が役立つメッセージもなく失敗します。
  2. 商品が公開されていません。ライセンステストが設定され、テスターも追加されているのにSKUが表示されないのは、単発商品またはサブスクリプションが有効化されていないためです。
  3. テスターがトラックに未登録。 ライセンステストとトラックのメンバーシップは別々のリストです。一方に登録されていても、もう一方には登録されません。
  4. 端末上のGoogleアカウントが違う。 購入はアプリをダウンロードしたアカウントに紐づきます。誰もダウンロードしていない場合は最初のアカウントに紐づきます。
  5. 未確認の購入が3分後に返金されました。 多くの場合はサーバー呼び出しの欠落で、まれにリトライ用ラッパーに握りつぶされた例外が原因です。
  6. ライセンステスターしかテストされていなかった。リリースはサンドボックスでは動作するものの、課金ユーザーには不具合が発生します。テスター以外の経路が一切検証されていなかったためです。

出典:Play Console ヘルプ「アプリケーションのライセンスでアプリ内課金をテストする」(ライセンステスターのリスト、公開済みプロダクト、テストトラックの対象条件)、およびAndroid Developers「Google Play Billing Library の統合をテストする」(サイドロードの例外、テスト用インストゥルメント、3分間の返金ルール、Play Billing Labの機能、2時間の設定有効期限)。Googleは課金リスクシグナルの許容基準を公開していないため、本記事では推測していません。

デベロッパーアカウントを大規模に運用中ですか? 運用面は当社が対応します。

クリックしてファイルを選択 · 右クリック→貼り付け、またはCtrl/⌘+Vでスクリーンショットを貼り付け

このボックスにファイルをドラッグすることもできます。

ご提供いただいたメールに返信します。お客様の情報はKappS内に留まります。

✔ 送信済み

メッセージを受け付けました。24時間以内に返信します。


← 編集に戻る