Google Play サブスクリプションの基本プランとオファー
Google Playの購読者が実際に支払う金額を決める2つの問いは、2つの異なる場所で答えられます。基本プランが答えるのは「どの請求期間で、いくらで、自動更新かプリペイドか?」。オファーが答えるのは「誰が、どのくらいの期間、より安く始められるか?」です。サブスクリプションのオファーを誤ってモデル化すると、無料トライアルを求めるマーケティングの要望がすべて新品のサブスクリプション商品になってしまいます——カタログは断片化し、一度購入されると削除できない商品をまたいでレポートが分断され、クライアントには誰も触りたくない購入ロジックが残ります。
このチュートリアルは、Play ConsoleとBilling Libraryが実際に課す順序に従います。プロダクトを作成し、基本プランを設定し、対象条件付きのオファーを追加し、クライアントでオファートークンを読み取り、適切な置換モードでプラン変更を処理し、サーバーで権利を検証します。その過程でチームが繰り返しつまずく3つの点があります。クライアントが明示的に渡さなければならないオファートークン、アップグレード時に選択する日割りモード、そして無料トライアルが本物かどうかを判断するサーバー側のチェックです。最後のセクションでは、ローンチ後にしか現れない罠を扱います。地域ごとの価格の抜け、決して表示できないオファー、そして気づかないうちに2つ目の基本プランになってしまう価格変更です。
1. 3層モデル:商品、基本プラン、オファー
Google Playサブスクリプションは3つのレイヤーで構成され、それぞれの寿命はまったく異なります。今日の判断が2年後にも変更できるかどうかを決めるのは、まさにこの点です。
- 商品 — 商品IDで識別されるカタログエントリ。IDは作成後に変更できず、誰かが購入した商品は削除できず、無効化のみ可能です。今四半期のキャンペーン名ではなく、その商品の本質を表す名前を初日から付けてください。「first_month_half_price」は一時的な企画に付ける恒久的なIDです。
- 基本プラン — 経済性を実際に決める層です。請求期間(週次、月次、3か月、6か月、年次)、更新タイプ(自動更新またはプリペイド)、国ごとの価格、さらに猶予期間とアカウント保留の挙動。1つの製品に複数の基本プランを持たせられるので、2つ目の製品を作らずに月次と年次を並べて販売できます。
- オファー — 1つの基本プランに紐づく価格設定:無料トライアル、導入価格、復帰割引。各オファーには適用条件があり、条件を満たすユーザーにしか表示されない。
覚えておく価値のある技術的な帰結が1つあります。クライアントが購入に使うofferTokenは、特定の「基本プラン+オファー」の組み合わせに対する資格情報です。商品に基本プランが複数ある場合、またはオファーが1つでもある場合は、トークンを明示的に渡す必要があります。デフォルトは存在しません。セクション5では、このルールが単なる豆知識ではなく、実際のクラッシュを説明するものになります。
2. ステップ1 — サブスクリプション商品を作成する
Play ConsoleでPlayで収益化 → 商品 → サブスクリプションに進み、サブスクリプションを作成します。この手順は4つのことを行い、そのいずれも取り返しがつかないか、後で高くつきます。
- プロダクトID — 小文字、数字、アンダースコアのみで、アプリ内で一意、不変であり、削除後も再利用できません。名前を変えるには新しいプロダクトを作成する必要があり、新しいIDと新しい購入経路が必要になります。
- 名前 — コンソールで行を識別するためのものです。購入者が購入シートで目にする内容は、基本プランとオファーからPlayが生成します。
- 説明と特典 — サブスクリプションに含まれる内容。このテキストは一部のストア画面に表示され、サポートが回答時に引用する内容でもある。
- 保存 — 下書きが保存されました。商品が購入可能になるのは、ベースプランが少なくとも1つ存在し有効化された後です。
最もよくある構造上のミスは、月額と年額で別々のプロダクトを作ってしまうことです。そうすると購入フローが2つ、状態管理が2セット、解約経路が2本必要になります。一方、Playはもともと両方を1つのプロダクト内の基本プランとして保持する設計です。後からの移行は大きな負担になるため、最初から正しく設定しましょう。
3. ステップ2 — 基本プランを設定する
ベースプランはサブスクリプションの収益構造を決める部分です。各商品に最低1つ、多くの場合は2つ(月額と年額)が必要です。
まず更新タイプを選びましょう。自動更新の基本プランは各期間の終了時に再度課金されます。これはほとんどのコンテンツ系やユーティリティ系のサブスクリプションに必要なものです。プリペイドの基本プランは固定の1期間分を前払いで販売し、期間終了時にユーザーが再度チャージする必要があります。低価格市場や、継続課金を望まないユーザーに適しています。この2つは混在できません。プリペイドプランには更新サイクルも猶予期間の概念もなく、無料トライアルを設定できません。トライアルが成長計画の一部なら、メインプランは自動更新である必要があります。
次に期間と価格を設定します。 期間は請求のリズムを決め、価格は国・地域ごとに入力します。ここがサポートチケットの最も確実な発生源です。Playでは一部の国にしか価格を設定できず、価格のない国では単に購入できません。そこでの購入者には「お住まいの国ではこのアイテムを利用できません」と表示され、購入者には不具合に見えますが、コンソール側では何も表示されません。ローンチ前にすべての対象市場を入力し、表示価格が現地の税務表示ルールを満たしているか確認してください。
最後にライフサイクル設定 — これは課金が成功したときではなく、失敗したときの動作を決めます:
- 猶予期間 — 課金失敗後もユーザーが権利を保持できる期間で、支払い方法を修正する時間を確保します。
- アカウント保留 — 猶予期間が未払いのまま終了すると権利は停止されますが、サブスクリプションの記録は保持されるため、後から支払えば復元されます。
- 再サブスクライブ — 解約したユーザーが購入フローをやり直さずに同じプランで戻れるようにします。
ここでのデフォルト設定が常に正しいとは限りません。ユーティリティ系アプリは通常、猶予期間とアカウント保留を採用し、コンテンツ系アプリはより早いダウングレードを好む場合があります。どちらを選ぶにせよ、サーバー側のマッピングを一致させる必要があります。サブスクリプション状態APIは猶予期間とアカウント保留を区別しているため、両方を「有効」にまとめてしまうと、その情報が失われます。
4. ステップ3 — オファーと対象条件を追加する
オファーはコンバージョンの鍵であり、最も設定を誤りやすいレイヤーでもあります。すべてのオファーには3つの要素があります。オファーID、1つ以上のフェーズ、そして適用条件です。
フェーズは、オファーが時間軸でどう展開するかを決めます。フェーズは無料トライアル(価格ゼロ、日数指定)か、割引価格(指定額で一定期間)のいずれかです。フェーズは積み重ねられ、たとえば「7日間無料、その後初月50%オフ」のように設定できます。ただしフェーズの順序はユーザーが実際に支払う順序そのものなので、逆にすると先に課金して後から無料提供することになり、サポート問い合わせと審査での指摘の両方を招きます。
適格性は、誰がオファーを目にするかを決めるスイッチです。Playでは3つの条件が設定されています:
- 新規サブスクライバー — この製品を一度も購読したことがない。無料トライアルの通常条件。
- アップグレード — 現在、アップグレード対象として該当する別のサブスクリプションを保持しています。
- ウィンバック — 以前に購読し、その後キャンセルまたは期限切れになったユーザー。一律クーポンよりはるかに精度が高く、新規ユーザーが見る価格を汚染しません。
オファータグは飾りではありません。購入とともに引き継がれる情報であり、後から自社のレポートやサーバーロジックでトライアル経由のコンバージョンと通常価格の購入を切り分ける唯一の確実な手段です。これを省略すると、3か月後にはトライアル利用者が継続したのかどうかすら答えられなくなります。
オファーは新規購入にのみ影響します。オファーを編集・無効化しても、すでにそのオファー内にいるサブスクリプション契約者の課金は変わりません。逆に、既存の契約者に新しい価格を適用するには、別のオファーではなく価格変更フローが必要です。
書き留めておくべき境界が2つあります。各基本プランに設定できるオファー数には限りがあるため、プロモーションは無限に作成するのではなく再利用すべきです。また、基本プラン自体が無効な場合、その下のすべてのオファーは販売できません。オファーが「表示されない」ときは、まず基本プランの状態、次に資格条件、最後にクライアントコードを確認してください。
5. ステップ4 — クライアントで正しいオファートークンを読み取る
商品詳細は単一の価格ではなくlistを返します。サブスクリプションを問い合わせるとsubscriptionOfferDetailsが得られ、各エントリは「基本プラン+オファー」の組み合わせで、basePlanId、offerId(空の場合もあり、基本プラン自体の通常価格の経路を意味します)、offerTokenを持ちます。
購入とは、そのリストの1エントリを課金フローに明示的に渡すことです。購入用のProductDetailsParamsを構築し、選択したofferTokenをそれに設定します。ルールは単純で、破ったときの代償は即座に現れます。
- 基本プラン1つでオファーなし — トークンは省略できますが、ライブラリのバージョンをまたぐと明示的に渡すほうが安全です。
- 複数の基本プラン、またはいずれかのオファー — トークンを省略すると購入が失敗します。これが「月額は動くのに年額はエラーになる」という典型的な問題の根本原因です。
- UIに表示する価格は、選択したエントリから取得する必要があり、リストの先頭要素から取得してはいけません。$4.99を表示して$49.99を請求するのは、この記事で最も高くつくバグです。
選択ルールはリストの順序に頼らず、明文化してください。まず認識できるbasePlanIdで基本プランを特定し、その中から返却リストに実際に含まれる最優先のオファーを選び、オファーがなければ基本プランの通常価格エントリーにフォールバックします。購入資格の判定はPlayの役割です。受け取るリストはすでに「このユーザーが今購入できるもの」なので、資格ルールをローカルで再実装して推測してはいけません。
テスト中はライセンステストアカウントを使用し、適用条件はテスターにも当てはまることに注意してください。すでにサブスクリプションを購入済みのアカウントには、新規購読者向けオファーが表示されません。これは想定どおりの動作であり、コードの不具合ではありません。トライアルの表示を確認するには、新しいアカウントを使うのが最短です。
6. ステップ5 — アップグレード、ダウングレード、置き換えモード
ユーザーを月額から年額へ、またはベーシックティアからプレミアムティアへ移行させるのは、2回目の購入ではなく置き換えです。この置き換えがどう振る舞うかは置き換えモードによって決まり、選択を誤るとユーザーに二重請求するか、1期間分の収益を逃すかのどちらかになります。
- 時間比例 — 即時に適用され、旧サブスクリプションの残存価値を新サブスクリプションに充当するため、ユーザーは差額をその場で支払います。
- 日割り価格で課金 — 即時に反映され、日割り額が一度に請求されます。ユーザーが先に利用して後から精算することを避けるため、ダウングレード時によく使われます。
- 全額を請求 — 新しいプランの全額が即時に適用され、残期間分の控除はありません。按分の手間が対象金額を上回る場合にのみ合理的です。
- 日割り計算なし — 即時に反映され、新しいサブスクリプションは次の請求サイクルから課金され、旧期間の残りはそのまま失効します。ユーザーにとって最も優しく、収益としては最も少なく、ダウングレード時の妥当なデフォルトです。
In Billing Library 8 the entry point is unified as setSubscriptionReplacementMode; the older method names from earlier library versions are deprecated. If your code still calls them, the compile error is a gift — cheaper than discovering mid-rollout that the semantics differ.
前払いの基本プランは切り替えの対象外です。更新サイクルがなく、独自のスケジュールで失効します。「月額から年額への切り替え」を促す表示は、前払いユーザーを除外しなければなりません。そうしないと、決して完了できないボタンを見せることになります。
順序のルールが1つあります。置き換えリクエストは失敗するか有効になるかのどちらかで、部分的に適用されることはありません。そのため、送信前にクライアント側でローカルの権利を付与せず、サーバーが新しい購入情報を保持してからアンロックしてください。
7. ステップ6 — サーバー側で検証して承認する
クライアントから返ってくるのは「ユーザーが購入したと言っている」だけです。購入権限はサーバー側で判断します。購入トークンを添えてサブスクリプション照会(purchases.subscriptionsv2)を呼び出し、権威ある状態と有効期限を取得して、自社の購入権限テーブルに書き込んでください。
stateフィールドはユーザーがどのセグメントにいるかを示します。アクティブ、猶予期間中、保留中、一時停止、キャンセル済み、期限切れ、保留。これらは権利付与の分岐に直接対応します。猶予期間は通常アクセスを維持し、アカウント保留は通常アクセスを狭め、一時停止はデータを保持したままサービスを停止すべきです。このマッピングを「有効か無効か」にハードコードすると、Playが提供するまさにその区別を捨ててしまいます。
次に、忘れがちな2つのアクションです。3日以内に購入を確認しないと自動的に返金されます。クライアントを信頼するよりも、サーバーから実行する方が確実です。そして、リアルタイムデベロッパー通知を設定して、更新、キャンセル、猶予期間への移行、復旧、価格変更の確認が届くようにしましょう。通知は確認すべきシグナルであり、最終状態ではありません。通知を受け取ったら完全なサブスクリプションを取得し、メッセージIDで重複排除し、冪等に処理してください。
この3層を正しく構築すればループが完成します。クライアントが開始し、サーバーが判定し、通知がタイムリーに保ちます。
8. ローンチ後にしか現れない落とし穴
これらはテストではほとんど現れず、実際のトラフィックとともに一気に発生します。
- 地域別価格の抜け — 新しい市場が追加されたのに価格表が埋められておらず、その地域の購入者には「提供なし」と表示されます。その地域のアカウントで購入画面を一度確認するほうが、コンソールの表を信じるより確実です。
- 価格の変え方を間違えると — 既存のベースプランを編集すると価格変更フローが始まり、新しい価格が適用される前に既存のサブスクライバーが確認する必要があります。「既存ユーザーは旧価格のまま、新規ユーザーは新価格を支払う」ことが目的なら、通常の答えは編集ではなく、新しいベースプランの作成と販売内容の変更です。価格に触れる前に、どちらの結果を望むのかを決めてください。
- 有効な購読者がいるオファーを無効化する — 無効化は新規購入のみをブロックし、既存の購読者は期間終了までオファーを利用し続けます。バグではありませんが、用意しておくべきサポート用スクリプトです。
- すべてのプロモーションを新商品にしてしまう — 削除できない商品、分断されたレポート、誰もリファクタリングしないクライアントロジックが残ります。
- オファータグの付け忘れ — これがないとトライアルのコンバージョンと直接購入を区別できず、どのプロモーションが実際に継続率に貢献したかを判断できません。
- テスターには見え、ユーザーには見えない — 対象条件はテストアカウントにも適用されます。クリーンなアカウントで確認することが、最も速いデバッグ手段です。
9. KappSの位置づけ
サブスクリプションの設定は製品上の判断ですが、その土台となるのは何年にもわたってコンプライアンスを保ち続ける必要のあるアカウントです。支払いプロフィール、税務情報、デベロッパー本人確認の状況。これらのいずれかが破綻すれば、収益の連鎖は最悪のタイミングで断たれます。KappSはコンプライアンスに適合した資料を準備・提出し、アカウントと公開状態を健全に保つことで、こうした前提条件を変動要因ではなくします。
- アカウントと支払いの整合性 — デベロッパーID、支払いプロファイル、実際の受取人が一致していること。これにより、詳細の不一致で決済が滞ることはありません。
- 税務・地域設定のレビュー — W-8BEN/W-9、源泉徴収率、対象市場をローンチ前に確認し、支払いが不足してから慌てないために。
- 設定をダブルチェックする第二の目 — 基本プラン、オファーの対象条件、クライアント側のトークン処理。特に複数プロダクト・複数地域・複数言語を展開するポートフォリオでは重要です。
プラットフォームのルールを回避するようなものは一切提供していません。価格もトライアルも本物でなければならず、対象条件はPlayの定義に従い、すべての購入はサーバー側の検証を通過しなければなりません。それがルールであり、長く機能し続ける唯一の形でもあります。
出典(Googleドキュメント):Play Console ヘルプ — サブスクリプション、基本プラン、オファーと対象条件、プリペイドプランの作成と設定。Android Developers — Play Billing の統合、サブスクリプションの置き換えモード、サーバー側検証、リアルタイムデベロッパー通知。
デベロッパーアカウントを大規模に運用中ですか? 運用面は当社が対応します。
メッセージを受け付けました。24時間以内に返信します。
← 編集に戻る