定期購入について

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

このドキュメントでは、更新や有効期限など、定期購入のライフサイクル イベントを処理する方法について説明します。また、プロモーションの提供やユーザーによる定期購入の管理など、その他の定期購入機能についても説明します。

アプリの定期購入アイテムを構成していない場合は、アイテムを作成して構成するをご覧ください。

定期購入の概要

定期購入は、ユーザーに特定の利用資格を付与する定期的な取引です。利用資格は、指定された期間にユーザーが利用できる特典のセットを表します。たとえば、定期購入により、ユーザーはプレミアム アクセスの利用資格を獲得できます。

基本プランと特典を使用して、同じ定期購入アイテムについて複数の構成を作成できます。たとえば、アプリを定期購入したことがないユーザーを対象とするお試し特典を作成できます。同様に、すでに定期購入しているユーザーを対象とするアップグレード特典を作成できます。

定期購入アイテム、基本プラン、特典の詳細については、Google Play Console ヘルプセンターのドキュメントをご覧ください。

Play Billing ライブラリは、次の定期購入の種類をサポートしています。

• 単一アイテムのサブスクリプション - このタイプでは、1 つのアイテムが 1 つの利用資格に対応します。たとえば、音楽ストリーミング サービスの定期購入などです。

• アドオン付きサブスクリプション - このタイプでは、1 回の購入で複数の異なる利用資格をバンドルできます。たとえば、音楽ストリーミング サービスと動画サブスクリプションの両方のサブスクリプションなどです。アドオン付きの定期購入に固有の情報については、アドオン付きの定期購入をご覧ください。

プリペイド プランの統合

プリペイド プランは、有効期限が切れても自動的に更新されません。ユーザーが定期購入の利用資格を中断なしで延長するには、同じ定期購入にプリペイド プランをチャージする必要があります。

チャージするには、元の購入の場合と同様に請求フローを開始します。購入がチャージであることを示す必要はありません。

プリペイド プランのチャージでは常に CHARGE_FULL_PRICE 交換モードが使用されるため、このモードを明示的に設定する必要はありません。ユーザーは直ちに請求対象期間の全額を請求され、チャージで指定した期間について利用資格が延長されます。

チャージされると、最新のチャージ購入を反映するために、Purchase 結果オブジェクトの以下のフィールドが更新されます。

• 注文 ID
• 購入時間
• 署名
• 購入トークン
• 承認済み

Purchase の以下のフィールドには、常に元の購入と同じデータが格納されます。

• パッケージ名
• 購入ステータス
• アイテム
• 自動更新

プリペイド購入の承認

自動更新される定期購入と同様に、デベロッパーはプリペイド プランも購入後に承認する必要があります。初回購入とチャージの両方で承認が必要です。詳細については、購入を処理するをご覧ください。

プリペイド プランの期間が短い可能性があるため、できるだけ早く購入を承認することが重要です。

期間が 1 週間以上のプリペイド プランは、3 日以内に承認する必要があります。

期間が 1 週間未満のプリペイド プランは、プラン期間の半分以内に承認する必要があります。たとえば、3 日間のプリペイド プランの承認期限は 1.5 日間です。

分割払い定期購入の統合

分割払い定期購入は、定期購入料金の全額を前払いするのではなく、一定の期間にわたって複数回に分けて支払う定期購入の一種です。

分割払いの定期購入に関するその他の考慮事項:

• 利用できる国: 分割払い定期購入機能は、ブラジル、フランス、イタリア、スペインでのみご利用いただけます（最新の利用可能状況については、コンソールをご確認ください）。
• 料金の設定: コンソールで分割払いサブスクリプションの料金を設定する場合、料金は月々の支払い額を表します。この値が、設定されたコミット期間と組み合わせられて、購入画面にサブスクリプションの合計金額が生成されます。
• 契約期間: 最初の定期購入契約の合計期間。この期間中は毎月のお支払いが必要です。たとえば、ベースプランの契約期間が 15 か月の場合、ユーザーは 15 か月間、毎月支払いを行います。
• 更新: 分割払い定期購入のコンテキストでは、「更新」はコミットメント期間の終了（最初のコミットメント期間またはその後のコミットメント期間）を意味します。初回登録後、最初の更新は初回契約期間の終了時に行われます。その後の更新は、各コミットメント期間の完了後に行われます。分割払いサブスクリプションの更新タイプは、[毎月自動更新] または [同じ期間で自動更新] です。[毎月自動更新] の場合、その後のコミットメントはなく、プランは月額サブスクリプションのように動作します。月額サブスクリプションの請求はそれぞれ更新となります。
• 請求期間: 分割払い定期購入のコンテキストでは、ベースプランで指定されている個々の支払いが行われる定期的な間隔を指します。
• プランの変更と料金の変更の動作: 料金の変更と解約については、コミットメントが確実です。つまり、ユーザーが解約する場合や、デベロッパーが料金を変更する場合、変更は契約期間の終了時に有効になります。プランの変更の場合、コミットメントは確定的ではありません。つまり、プランの変更はコミットメント期間の終了まで待つ必要はなく、設定された交換モードに基づいて、すぐにまたは次のお支払い日に有効になります。
• 同じ定期購入プランの変更: 同じ定期購入商品の分割払い基本プランから分割払い以外の基本プランへのプラン変更は許可されません。

• リアルタイム デベロッパー通知（RTDN）: ユーザーが解約を開始したときに、コミットメント期間の支払いが残っている場合は、SUBSCRIPTION_CANCELLATION_SCHEDULED RTDN がすぐに送信されます。解約は保留中であり、コミットメント期間の終了時にのみ有効になります。その後、ユーザーが復元しなかった場合、コミットメント期間の終了時に SUBSCRIPTION_CANCELED と SUBSCRIPTION_EXPIRED の RTDN が送信されます。

• 支払い / 収益の実現: ユーザーが毎月の支払いを行うたびに、デベロッパーへの支払いが発生します。他のすべての定期購入と同じ条件が適用されます。ユーザーが分割払いの定期購入に申し込んだ時点で、デベロッパーに前払いされることはありません。

• 支払いの未払いに対する請求: ユーザーが分割払いの定期購入のお支払いを行わなかった場合、Google もデベロッパーも、そのような未払いのお支払いをユーザーから回収しようとしません。ただし、Google は、通常のお支払い再試行の慣行に従って、該当する猶予期間またはアカウントの一時停止期間中に定期的に支払いを再試行することがあります。残りの未払いの分割払いについては、Google はデベロッパーに対して責任を負いません。

• Play Billing Library の提供状況: installmentDetails フィールドは PBL 7 以降でのみ使用できます。PBL 5 以降では、分割払いの定期購入は queryProductDetails() を使用して返されますが、定期購入には、プランのコミット済み支払い回数などの詳細な分割払い情報は含まれません。

ディープリンクを使用してユーザーが定期購入を管理できるようにする

アプリのデザインに合わせて、アプリの設定画面にユーザーが定期購入を管理するためのリンクを組み込みます。

有効期限内の定期購入について、アプリから Google Play 定期購入センターへのディープリンクを追加できます。これは、定期購入リソースの subscriptionState フィールドで判断できます。これに基づいて、いくつかの方法で Google Play ストアの定期購入センターへのディープリンクを設定できます。

定期購入センターへのリンク

次の URL を使用して、図 1 と図 2 に示すように、すべての定期購入を表示するページにユーザーを誘導します。

https://play.google.com/store/account/subscriptions

このディープリンクは、ユーザーが Google Play ストアの定期購入センターから解約した定期購入を再開する際に役立ちます。

特定の定期購入の管理ページへのリンク（推奨）

有効期限内の定期購入の管理ページに直接リンクするには、購入した定期購入に関連付けられているパッケージ名と productId を指定します。プログラマティックに既存の定期購入の productId を確認するには、個々のユーザーに関連付けられている定期購入のリストをアプリのバックエンドに照会するか、BillingClient.queryPurchasesAsync() を呼び出します。各定期購入には、定期購入のステータス情報の一部として、対応する productId が含まれます。定期購入に関連付けられた各 SubscriptionPurchaseLineItem オブジェクトには、ユーザーがその項目で購入した定期購入に関連付けられた productId が含まれます。

次の URL を使用してユーザーを特定の定期購入管理画面に誘導します。「your-sub-product-id」と「your-app-package」はそれぞれ productId とアプリのパッケージ名に置き換えてください。

https://play.google.com/store/account/subscriptions?sku=your-sub-product-id&package=your-app-package

これにより、ユーザーはお支払い方法を管理したり、解約、再度定期購入、一時停止などの機能にアクセスしたりできるようになります。

ユーザーが定期購入をアップグレード、ダウングレード、変更できるようにする

既存の定期購入者に、ニーズに合わせて定期購入プランを変更するためのさまざまなオプションを提供できます。

• 「基本」定期購入と「プレミアム」定期購入など、複数の定期購入の階層を販売する場合は、ユーザーが別の定期購入の基本プランまたは特典を購入することで、階層を切り替えられるようにできます。
• 月間プランから年間プランへの切り替えなど、現在の請求対象期間を変えられるようにできます。
• また、ユーザーが自動更新プランとプリペイド プランを切り替えられるようにもできます。

要件を満たすユーザーに定期購入特典として割引を提供することで、こうした変更を促進できます。たとえば、月間プランから年間プランに切り替えると初年度に 50% 割引を提供する特典を作成し、月額プランを定期購入中でこの特典を購入していないユーザー限定の特典にできます。特典の利用条件について詳しくは、ヘルプセンターをご覧ください。

図 3 は、3 つの異なるプランを表示したサンプルアプリを示しています。

アプリに、図 3 のような画面を表示して、定期購入を変更するオプションをユーザーに提供できます。いずれの場合も、現在の定期購入プランの内容と、変更オプションをユーザーに明確に示す必要があります。

ユーザーが定期購入をアップグレード、ダウングレード、変更する場合は、交換モードを指定します。交換モードでは、現在の支払済み請求対象期間の比例配分額がどのように適用されるか、また利用資格が変更される時期が決定されます。

交換モード

次の表に、利用可能な交換モードと使用例、支払い済みと見なされる支払いの数を示します。

アップグレード特典、またはダウングレード特典のさまざまなアップセルおよび再獲得の適用について詳しくは、特典とプロモーションのガイドをご覧ください。

購入の交換モードを設定する

設定とビジネス ロジックに基づき、定期購入移行のタイプに応じたさまざまな交換モードを使用できます。このセクションでは、定期購入の変更に対して交換モードを設定する方法と、適用される制限事項について説明します。

再度定期購入、または同じ定期購入内でのプランの切り替えを行う

Google Play Console でデフォルトの交換モードを指定できます。この設定では、現在の定期購入ユーザーが同じ定期購入の別の基本プランや特典を購入した場合や、解約後に再度定期購入した場合の請求のタイミングを選択します。利用可能なオプションは、[すぐに請求]（CHARGE_FULL_PRICE と同等）と [次回の請求日に請求]（WITHOUT_PRORATION と同等）です。同じ定期購入内で基本プランを切り替える場合に関連する交換モードはこれらのみです。

たとえば、ユーザーが解約した後、定期購入が終了する前のタイミングで、同じプランの再獲得特典を実装する場合、SubscriptionUpdateParams に値を指定せずに通常の購入として新しい購入を処理できます。システムは、定期購入で構成したデフォルトの交換モードを使用し、以前の購入から新しい購入へのプランの移行を自動的に処理します。

定期購入間でプランを切り替える、またはデフォルトの交換モードをオーバーライドする

ユーザーが定期購入のアイテムを変更する場合（別の定期購入を購入する場合）、またはなんらかの理由でデフォルトの交換モードをオーバーライドする場合は、実行時に購入フロー パラメータの一部として比例配分率を指定します。

実行時購入フロー構成の一部として SubscriptionUpdateParams を正しく指定するには、次の制限事項に注意してください。

• 定期購入をアップグレードまたはダウングレードする場合、あるいはプリペイド プラン、自動更新プラン、分割払いプランからプリペイド プランへと切り替える場合、許容される交換モードは CHARGE_FULL_PRICE のみです。他の交換モードを指定すると、購入は失敗し、ユーザーに対してエラーが表示されます。
• 同じ定期購入内でプランをプリペイド プランまたは自動更新プランから自動更新プランへと切り替える場合、有効な比例配分モードは CHARGE_FULL_PRICE と WITHOUT_PRORATION です。他の比例配分モードを指定すると、購入は失敗し、ユーザーに対してエラーが表示されます。
• 同じ定期購入商品内で、分割払いの基本プランから分割払い以外の基本プランにプランを切り替えることはできません。

交換の例と動作

各比例配分モードの仕組みを理解するために、次の事例について考えてみましょう。

あるユーザーが「Country Gardener」というアプリのオンライン コンテンツを定期購入しており、そのコンテンツの Tier 1 バージョン（テキストのみ）を月次定期購入しています。この定期購入の料金は月額 2 ドルで、毎月 1 日に更新されます。

4 月 15 日に、Tier 2 定期購入の年間バージョンにアップグレードすることにしました。これには動画のアップデートが含まれ、料金は年間 36 ドルです。

デベロッパーは定期購入のアップグレードに、比例配分モードを選択しています。各比例配分モードがユーザーの定期購入にどのように影響するのかを、以下のリストに示します。

WITH_TIME_PRORATION

ユーザーの Tier 1 の定期購入は直ちに終了します。ユーザーは 1 か月分（4 月 1～30 日）をすでに支払っていますが、定期購入期間が半分経過した時点でアップグレードしたため、月次定期購入分の残り半分（1 ドル）は新しい定期購入に適用されます。ただし、この新しい定期購入の年間料金が 36 ドルであることから、1 ドルのクレジット残高で支払えるのは 10 日分（4 月 16～25 日）のみとなります。したがって 4 月 26 日に新しい定期購入分の 36 ドルが請求され、以後毎年 4 月 26 日に 36 ドルが請求されます。

購入が完了した時点でアプリの PurchasesUpdatedListener を呼び出すことで、queryPurchasesAsync() 呼び出しの一部として新しい購入を取得できます。バックエンドはすぐに SUBSCRIPTION_PURCHASED リアルタイム デベロッパー通知を受け取ります。

CHARGE_PRORATED_PRICE

Tier 2 の定期購入の単位時間あたり価格（36 ドル/年 = 3 ドル/月）が、Tier 1 の定期購入の単位時間あたり価格（2 ドル/月）よりも高いため、このモードが使用できます。ユーザーの Tier 1 の定期購入は直ちに終了します。ユーザーは 1 か月分をすでに支払っていますが、半分しか使用していないため、月次定期購入分の残り半分（1 ドル）は新しい定期購入に適用されます。ただし、新しい定期購入の料金が 36 ドル/年であり、残りの 15 日分の料金は 1.5 ドルであるため、新しい定期購入については差分の 0.5 ドルが請求されます。5 月 1 日には新しい定期購入の 36 ドルが請求され、以後毎年 5 月 1 日に 36 ドルが請求されます。

購入が完了した時点でアプリの PurchasesUpdatedListener を呼び出すことで、queryPurchasesAsync() 呼び出しの一部として新しい購入を取得できます。バックエンドはすぐに SUBSCRIPTION_PURCHASED リアルタイム デベロッパー通知を受け取ります。

WITHOUT_PRORATION

ユーザーの Tier 1 の定期購入は直ちに追加料金なしで Tier 2 にアップグレードされます。5 月 1 日には新しい定期購入について 36 ドルが請求され、以後毎年 5 月 1 日に 36 ドルが請求されます。

購入が完了した時点でアプリの PurchasesUpdatedListener を呼び出すことで、queryPurchasesAsync() 呼び出しの一部として新しい購入を取得できます。バックエンドはすぐに SUBSCRIPTION_PURCHASED リアルタイム デベロッパー通知を受け取ります。

DEFERRED

ユーザーの Tier 1 の定期購入は 4 月 30 日に期限が切れるまで継続します。5 月 1 日に Tier 2 の定期購入が有効になり、新しい定期購入について 36 ドルが請求されます。

購入が完了した時点でアプリの PurchasesUpdatedListener を呼び出すことで、queryPurchasesAsync() 呼び出しの一部として新しい購入を取得できます。バックエンドはすぐに SUBSCRIPTION_PURCHASED リアルタイム デベロッパー通知を受け取ります。その時点で他の新しい購入と同じ方法で購入を処理する必要があります。特に新しい購入の承認が必要です。なお、新しい定期購入の startTime は、古い定期購入の期限が切れて交換が有効になった時点で入力されます。その時点で、新しい定期購入プランの SUBSCRIPTION_RENEWED RTDN が送信されます。ReplacementMode.DEFERRED の動作について詳しくは、交換延期を処理するをご覧ください。

CHARGE_FULL_PRICE

ユーザーの Tier 1 の定期購入は直ちに終了します。その日に Tier 2 の定期購入が開始され、36 ドルが請求されます。ユーザーは 1 か月分をすでに支払っていますが、半分しか使用していないため、月次定期購入分の残り半分（1 ドル）は新しい定期購入に適用されます。新しい定期購入の料金は年間 36 ドルであるため、1 年の 1/36（概算で 10 日）が定期購入期間に追加されます。したがって、次回の請求はその日から 1 年と 10 日後で、36 ドルになります。それ以降は毎年 36 ドルが請求されます。

比例配分モードを選択する際は、交換の推奨事項をご確認ください。

アプリ内で定期購入の変更をトリガーする

アプリでは、購入フローの開始と同じ手順でアップグレードまたはダウングレードを提供できます。ただし、アップグレードまたはダウングレードする場合は、次の例に示すように、現在の定期購入、将来の（アップグレードまたはダウングレードした）定期購入、使用する交換モードの詳細を指定する必要があります。

val offerToken = productDetails
        .getSubscriptionOfferDetails(selectedOfferIndex)
        .getOfferToken()

val billingParams = BillingFlowParams.newBuilder().setProductDetailsParamsList(
       listOf(
           BillingFlowParams.ProductDetailsParams.newBuilder()
               .setProductDetails(productDetails)
               .setOfferToken(offerToken)
               .build()
       )
       ).setSubscriptionUpdateParams(
           BillingFlowParams.SubscriptionUpdateParams.newBuilder()
               .setOldPurchaseToken("old_purchase_token")
               .setSubscriptionReplacementMode(
                 BillingFlowParams.ReplacementMode.CHARGE_FULL_PRICE
               )
               .build()
       ).build()

billingClient.launchBillingFlow(
    activity,
    billingParams
   )
// ...

String offerToken = productDetails
    .getSubscriptionOfferDetails(selectedOfferIndex)
    .getOfferToken();

BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
    .setProductDetailsParamsList(
        ImmuableList.of(
            ProductDetailsParams.newBuilder()
                // fetched via queryProductDetailsAsync
                .setProductDetails(productDetails)
                // offerToken can be found in
                // ProductDetails=>SubscriptionOfferDetails
                .setOfferToken(offerToken)
                .build()))
    .setSubscriptionUpdateParams(
        SubscriptionUpdateParams.newBuilder()
            // purchaseToken can be found in Purchase#getPurchaseToken
            .setOldPurchaseToken("old_purchase_token")
            .setSubscriptionReplacementMode(ReplacementMode.CHARGE_FULL_PRICE)
            .build())
    .build();

BillingResult billingResult = billingClient.launchBillingFlow(activity, billingFlowParams);
// ...

交換に関する推奨事項

次の表に、さまざまな比例配分のシナリオと、各シナリオでの推奨事項を示します。

定期購入の変更購入を処理する

プランの変更は、事実上新しい購入です。請求フローが正常に完了した場合は、新しい購入として処理し、承認する必要があります。新しい購入を適切に処理するだけでなく、交換される購入を終了する必要があります。

アプリ内での動作は、新しい購入の場合と同じです。アプリは PurchasesUpdatedListener で新しい購入の結果を受け取り、新しい購入は queryPurchasesAsync で利用できるようになります。

既存の購入が新しい購入に交換されると、Google Play Developer API は、定期購入リソース内で linkedPurchaseToken を返します。サービスに対するアクセスに以前のトークンが使用されないように、linkedPurchaseToken 内で提供されるトークンは必ず無効にしてください。アップグレードとダウングレードの購入の処理については、アップグレード、ダウングレード、再登録をご覧ください。

新しい購入トークンを受け取ったら、新しい購入トークンを検証する場合と同じ検証プロセスを行います。Google Play Billing Library の BillingClient.acknowledgePurchase()、または Google Play Developer API の Purchases.subscriptions:acknowledge を使用して購入を承認します。

交換延期を処理する

交換延期モードでは、ユーザーは新しいプランを開始する前に、以前のプランの残りの利用資格を消化できます。

新しい購入で ReplacementMode.DEFERRED を使用すると、queryPurchasesAsync() は購入フロー後に新しい購入トークンを返しますが、以前のアイテムに関連付けられたままとなります。次の更新日に延期されていた交換が行われると、新しいアイテムが返されます。

以前は、ProrationMode.DEFERRED でこのユーザー エクスペリエンスを達成できましたが、ProrationMode.DEFERRED は Play Billing Library 6 で非推奨になりました。動作の違いについては、次の表をご覧ください。

非推奨の ProrationMode.DEFERRED の代わりに、今後は ReplacementMode.DEFERRED を使用してください。利用資格の変更に関して同じ動作を示す一方で、他の新しい購入の動作とより一貫性のある購入管理方法を提供します。

顧客管理

リアルタイム デベロッパー通知を使用すると、ユーザーの解約をリアルタイムに検出できます。定期購入が期限切れになる前にユーザーが解約した場合は、ユーザーにプッシュ通知またはアプリ内メッセージを送信して、再度定期購入するように促すことができます。

ユーザーが定期購入を解約した後、アプリ内または Play ストアでユーザーの再獲得を試みることができます。次の表に、さまざまな定期購入のシナリオ、および関連する再獲得のための操作とアプリの要件を示します。

定期購入の有効期限前 - アプリ内

定期購入が解約済みであっても有効期限が切れていない場合は、新規の定期購入者と同じアプリ内のアイテム購入フローを適用すると、定期購入者はアプリ内で定期購入を再開できるようになります。UI がユーザーに既存の定期購入がある状態を反映していることを確認します。たとえば、ユーザーの現在の有効期限と再開価格とともに [再有効化] ボタンを表示することが考えられます。

ほとんどの場合は、次のように、ユーザーが定期購入に登録していた時点と同一の価格と SKU をユーザーに提示する必要があります。

• 同一の SKU で新規の定期購入の購入を開始します。
• 新しい定期購入は、以前の定期購入に代わって同じ有効期限で更新されます。古い定期購入は直ちに期限切れとしてマークされます。
• たとえば、あるユーザーが「Example Music App」というアプリを定期購入していたとします。定期購入の有効期限は 8 月 1 日です。7 月 10 日に、同じ月額で 1 か月分再度定期購入するとします。新しい定期購入は残りのクレジットに基づいて比例配分され、すぐに有効になり、8 月 1 日に更新されます。

別の価格（たとえば、新しい無料試用や再獲得割引）を提示する場合は、ユーザーに異なる SKU を提示できます。

• 交換モード WITHOUT_PRORATION を使用して、異なる SKU でアップグレードまたはダウングレードを開始します。
• 新しい定期購入は、以前の定期購入に代わって同じ有効期限で更新されます。元の有効期限日に、新しい SKU の価格（お試し価格を含む）がユーザーに課金されます。難読化されたアカウント ID を使用して以前の定期購入を作成した場合は、アップグレードとダウングレードのために同じ ID を BillingFlowParams に渡す必要があります。
• たとえば、あるユーザーが「Example Music App」というアプリを定期購入していたとします。定期購入の有効期限は 8 月 1 日です。7 月 10 日に、お試し価格で 1 年分再度定期購入するとします。新しい定期購入は直ちにアクティブになり、ユーザーに対して 8 月 1 日にお試し価格が請求されます。
• 無料試用またはお試し価格を再獲得用 SKU に含める場合は、Google Play Console で、アプリごとの無料試用を 1 回に制限する [Allow one free trial per app] チェックボックスをオフにして、ユーザーを対象に含めます。

購入トークンを受け取ったら、新しい定期購入の場合と同様に購入を処理します。さらに、Google Play Developer API は、定期購入リソース内で linkedPurchaseToken を返します。サービスに対するアクセスに以前のトークンが使用されないように、linkedPurchaseToken 内で提供されるトークンは必ず無効にしてください。

定期購入の有効期限前 - Play ストア内

解約済みであっても定期購入が有効である間は、ユーザーは Google Play 定期購入センターで [再度定期購入]（以前の [再開]）をクリックすることで、定期購入を再開できます。それにより、同じ定期購入と購入トークンが維持されます。

定期購入の再開の詳細については、再開をご覧ください。

定期購入の有効期限後 - アプリ内

有効期限が切れた定期購入者がアプリ内で再度定期購入できるようにするには、新規の定期購入者と同じアプリ内のアイテム購入フローを適用します。次の点にご注意ください。

• ユーザーに割引を適用するには、特別価格を設定した定期購入用のアイテム ID を提供する必要があります。これは再獲得用 SKU とも呼ばれます。この特典はアプリで提供することも、メールなどアプリ以外の方法でユーザーに通知することもできます。
• 再獲得用の定期購入を開始するには、Google Play Billing Library を使用して、Android アプリ内で購入フローを開始します。これは新しい定期購入と同じプロセスですが、デベロッパーは、ユーザーが利用できる SKU を決定できます。
• 無料試用またはお試し価格を再獲得用 SKU に含める場合は、Google Play Console で、アプリごとの無料試用を 1 回に制限する [Allow one free trial per app] チェックボックスをオフにして、ユーザーを対象に含めます。
• 同じ SKU に再登録した場合、ユーザーは無料試用期間やお試し価格の対象ではなくなります。UI がこれを反映していることを確認します。

購入トークンを受け取ったら、新しい定期購入の場合と同様に購入を処理します。定期購入リソースで linkedPurchaseToken を受け取ることはありません。

定期購入の有効期限後 - Play ストア内

再登録が有効になっている場合、ユーザーは Google Play 定期購入センターで [再度定期購入] をクリックすることで、有効期限から最長 1 年間同じ SKU に再登録できます。それにより、新しい定期購入と購入トークンが生成されます。

再度定期購入はアプリ外での購入と見なされるため、アプリ外で行われた購入の処理のおすすめの方法を実施してください。

定期購入を宣伝する

プロモーション コードを作成して、既存の定期購入の無料試用の延長特典を特定のユーザーに提供できます。詳細については、プロモーション コードをご覧ください。

無料試用の場合、Google Play は、無料試用期間が始まる前に、ユーザーが有効な支払い方法を設定しているかどうかを確認します。ユーザーによっては、この確認が支払い方法に対する保留または請求として表示されることがあります。この保留または請求は一時的なものであり、後で取り消されるか払い戻されます。

試用期間後は、ユーザーのお支払い方法に対して正規の定期購入価格が請求されます。

ユーザーが無料試用中に定期購入を解約した場合、試用期間が終了するまで定期購入は継続され、無料試用期間が終了しても請求は発生しません。

解約、払い戻し、取り消し

Google Play Developer API を使用して、定期購入の解約、払い戻し、取り消しができます。この機能は Google Play Console でも利用できます。

• 解約: ユーザーは Google Play で定期購入を解約できます。アプリまたはウェブサイトでユーザーが解約できるオプションを用意することもできます。アプリでは解約の説明に沿って、これらの解約を処理する必要があります。
• 払い戻し: 払い戻しを行った後も、ユーザーは引き続き定期購入を利用できます。払い戻しは、たとえば、技術的なエラーによってユーザーがアイテムにアクセスできなかったものの、エラーが解決された場合に行うことができます。最新のお支払い額を超える金額を払い戻す場合、または一部払い戻しを行う場合は、Google Play Console を使用する必要があります。
• 取り消し: 取り消しを行うと、ユーザーは直ちに定期購入を利用できなくなります。取り消しは、たとえば、技術的なエラーによってユーザーがアイテムにアクセスできなくなり、ユーザーがアイテムを使用し続けることを望まない場合に行うことができます。アプリでは取り消しの説明に沿って、これらの解約を処理する必要があります。

次の表に、解約、払い戻し、取り消しの違いを示します。

定期購入者の課金を延期する

Google Play Developer API の Purchases.subscriptions:defer を使用すると、自動更新される定期購入の次回の課金日を延期できます。延期期間中、ユーザーは完全なアクセス権で定期購入コンテンツを利用できますが、課金はされません。定期購入の更新日は、新しい日付で更新されます。

プリペイド プランでは、defer billing API を使用して有効期限を延期できます。

課金を延期することで、次のことが可能になります。

• 特別優待の一環として、映画の購入について 1 週間の無料期間を設けるなど、無料アクセス権を付与する。
• 感謝の印としてユーザーに無料アクセス権を付与する。

課金の延期は、API 呼び出し 1 回あたり最短で 1 日、最長で 1 年間です。課金をさらに延期するには、次回の課金日の前に再度 API を呼び出します。

たとえば、あるユーザーが「Fishing Quarterly」というアプリのオンライン コンテンツを月次定期購入しているとします。普段は毎月 1 日に、125 円を支払っています。3 月に、アプリ パブリッシャーが実施したオンライン調査に回答しました。パブリッシャーは、謝礼として 6 週間分を無料にし、次の支払いを 5 月 15 日（予定されていた次回課金日 4 月 1 日の 6 週間後）まで延期することにしました。このユーザーは 4 月 1 日と 5 月 1 日には課金されませんが、通常どおりコンテンツにアクセスできます。5 月 15 日に、通常どおりの 125 円が定期購入料金として課金されます。次回の更新日は 6 月 15 日です。

延期した場合は、メールまたはアプリ内で請求日が変更されたことをユーザーに通知することもできます。

支払い方法の不承認を処理する

定期購入の更新でお支払いの問題が発生した場合、Google は解約までの一定の期間、定期購入の更新を定期的に試みます。この復元期間は猶予期間と重複します。復元期間が終了すると、アカウントの一時停止期間に移行します。この間、Google はお支払い方法を更新するよう促すメールと通知をユーザーに送信します。

猶予期間が設定されていれば、お支払い方法が不承認となった時点で定期購入は猶予期間に入ります。猶予期間中も、ユーザーが定期購入の利用資格に引き続きアクセスできるようにする必要があります。

猶予期間が終了すると、定期購入はアカウントの一時停止期間に入ります。アカウントの一時停止中は、ユーザーが定期購入の利用資格にアクセスできないようにする必要があります。

Google Play Console で、自動更新の基本プランの猶予期間とアカウントの一時停止期間をそれぞれ指定できます。デフォルトの設定よりも短い期間を指定すると、支払いの不承認から復元される定期購入の数が少なくなる可能性があります。

お支払い方法が不承認となっている間に定期購入が再開される可能性を最大限に高めるよう、お支払いに関する問題があることをユーザーに伝えて修正を求めることができます。

これは、猶予期間とアカウントの一時停止のセクションに記載されているように、デベロッパー自身で行えます。また、In-App Messaging API を実装し、Google がアプリでユーザーにメッセージを表示することもできます。

アプリ内メッセージング

InAppMessageCategoryId.TRANSACTIONAL で In-App Messaging を有効にした場合は、Google Play が猶予期間とアカウントの一時停止期間中に 1 日に 1 回、ユーザーにメッセージを表示し、アプリを終了せずにお支払い方法を修正する機会をユーザーに提供します。

ユーザーがアプリを開くたびにこの API を呼び出し、メッセージを表示するかどうかを指定することをおすすめします。

ユーザーが定期購入を再開すると、SUBSCRIPTION_STATUS_UPDATED のレスポンス コードが購入トークンと一緒に返されます。この購入トークンを使用して Google Play Developer API を呼び出し、アプリで定期購入のステータスを更新します。

In-App Messaging を統合する

アプリ内メッセージをユーザーに表示するには、BillingClient.showInAppMessages() を使用します。

以下に、In-App Messaging のフローをトリガーする例を示します。

val inAppMessageParams = InAppMessageParams.newBuilder()
        .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL)
        .build()

billingClient.showInAppMessages(activity,
        inAppMessageParams,
        object : InAppMessageResponseListener() {
            override fun onInAppMessageResponse(inAppMessageResult: InAppMessageResult) {
                if (inAppMessageResult.responseCode == InAppMessageResponseCode.NO_ACTION_NEEDED) {
                    // The flow has finished and there is no action needed from developers.
                } else if (inAppMessageResult.responseCode
                        == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED) {
                    // The subscription status changed. For example, a subscription
                    // has been recovered from a suspend state. Developers should
                    // expect the purchase token to be returned with this response
                    // code and use the purchase token with the Google Play
                    // Developer API.
                }
            }
        })

InAppMessageParams inAppMessageParams = InAppMessageParams.newBuilder()
        .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL)
        .build();

billingClient.showInAppMessages(activity,
        inAppMessageParams,
        new InAppMessageResponseListener() {
            @Override
            public void onInAppMessageResponse(InAppMessageResult inAppMessageResult) {
                if (inAppMessageResult.responseCode
                        == InAppMessageResponseCode.NO_ACTION_NEEDED) {
                    // The flow has finished and there is no action needed from developers.
                } else if (inAppMessageResult.responseCode
                        == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED) {
                    // The subscription status changed. For example, a subscription
                    // has been recovered from a suspend state. Developers should
                    // expect the purchase token to be returned with this response
                    // code and use the purchase token with the Google Play
                    // Developer API.
                }
            }
        });

定期購入の保留中のトランザクションを処理する

保留中の取引は、初回購入、チャージ、アップグレード、ダウングレードで発生することがあります。サブスクリプションの購入は SUBSCRIPTION_STATE_PENDING ステータスで始まり、SUBSCRIPTION_STATE_ACTIVE に移行します。取引が期限切れになった場合や、ユーザーによってキャンセルされた場合、取引は SUBSCRIPTION_STATE_PENDING_PURCHASE_EXPIRED に移動します。ユーザーの利用資格は、取引が完了した後にのみ更新する必要があります。

保留中のトランザクションがある初回購入の定期購入のステータスの変更は簡単です。ユーザーが保留中の取引を開始すると、アプリは PENDING 状態の Purchase を受信します。トランザクションが完了すると、アプリは Purchase を再度受け取り、ステータスが PURCHASED に更新されます。タイプ SUBSCRIPTION_PURCHASED の SubscriptionNotification メッセージが RTDN クライアントに送信されます。通常の手順に沿って購入を確認します。ユーザーにコンテンツへのアクセス権を付与し、購入を確認します。取引が期限切れになった場合やキャンセルされた場合、タイプ SUBSCRIPTION_PENDING_PURCHASE_CANCELED の SubscriptionNotification メッセージが RTDN クライアントに送信されます。このような場合、ユーザーはコンテンツにアクセスできないようにする必要があります。

保留中の取引によるチャージ、アップグレード、ダウングレードでは、古いサブスクリプションと新しいサブスクリプションの両方の状態が変更されます。ユーザーが保留中のチャージ、アップグレード、またはダウングレード取引を開始すると、アプリは PendingPurchaseUpdate オブジェクトを含む以前の定期購入の Purchase を受け取ります。この時点で、お客様は引き続き古い定期購入を所有しており、新しい定期購入はまだ取得していません。PendingPurchaseUpdate オブジェクトで getProducts() と getPurchaseToken() を呼び出すと、新しい定期購入の商品 ID と購入トークンが返されます。取引が完了すると、アプリは、新しいサブスクリプションに設定されたトップレベルの購入トークンと、ステータスが PURCHASED に設定された Purchase を受信します。タイプ SUBSCRIPTION_PURCHASED の SubscriptionNotification メッセージが RTDN クライアントに送信されます。この時点でのみ、古い購入トークンを新しい購入トークンに置き換え、コンテンツへのユーザーのアクセス権を更新する必要があります。取引が期限切れになった場合やキャンセルされた場合、タイプ SUBSCRIPTION_PENDING_PURCHASE_CANCELED の SubscriptionNotification メッセージが RTDN クライアントに送信されます。このような場合、ユーザーは古い定期購入のコンテンツに引き続きアクセスできます。