維持特典は、Google Play で定期購入を解約しようとしている定期購入者に割引を表示することで、自発的な解約を減らすのに役立ちます。
対象となる定期購入者が解約を開始すると、Google Play には、設定した維持特典(「定期購入を継続すると、次の 2 か月間は 50% 割引」など)が表示されます。定期購入者が特典を承諾した場合、定期購入は解約されません。割引価格は次回の請求日から適用されます。
このページでは、リテンション特典の仕組み、設定方法、バックエンドでの結果イベントの処理方法、テスト方法について説明します。
始める前に
リテンション特典を設定する前に、次のことを確認してください。
- 1 つ以上の自動更新の基本プランを含む定期購入を作成している。ユーザー維持を目的とした特典は、自動更新の基本プランにのみ追加できます。
- リアルタイム デベロッパー通知(RTDN)を構成し、
purchases.subscriptionsv2.getメソッドを呼び出すようにバックエンドを設定している。バックエンドは、これらを使用して、定期購入者が保持特典を受け入れたことを検出します。
Google Play では、アプリ外で維持特典が表示されるため、アプリを変更したり、Google Play Billing Library の統合を更新したりする必要はありません。統合処理はすべて Google Play Console とバックエンドで行われます。
リテンション特典の仕組み
リテンション特典は、Google Play の定期購入管理(Google Play ストア アプリとウェブ版 Google Play)にのみ表示されます。アプリ内には表示されません。Google Play Billing Library は queryProductDetailsAsync() の結果で保持特典を返さないため、ProductDetails.getSubscriptionOfferDetails() には含まれず、launchBillingFlow() を通じて販売することはできません。アプリでディープリンクを使用して、定期購入者を Google Play の定期購入センターまたは特定の定期購入に誘導し、定期購入の管理や解約を行えるようにしている場合、定期購入者がそこで解約を開始すると、維持特典が表示されます。
次の手順は、定期購入者が解約しようとした場合の処理を示しています。
- 定期購入者が Google Play で定期購入を開き、解約を開始します。
Google Play は、定期購入者が維持特典の対象となるかどうかを、特典に設定した利用条件、または特典の対象をその定期購入者に設定したかどうかに基づいて確認します。
定期購入者が対象となる場合、Google Play は解約の代わりに維持特典を表示することがあります。利用条件を満たしていても、特典が表示されるとは限りません。Google Play では、地域のコンプライアンス要件など、プラットフォーム レベルの追加チェックも行われるためです。Google Play にオファーが表示された場合、購読登録済みのユーザーは次のいずれかを行うことができます。
- 特典を承諾する: 1 回タップするだけで特典を承諾できます。定期購入は有効なままで、自動更新されます。定期購入者にはすぐに請求されません。割引価格は次の請求対象期間から適用されます。
- 解約を続行する: 定期購入者は特典を拒否し、標準の解約フローを完了します。通常の
SUBSCRIPTION_CANCELED通知が届きます。詳細については、キャンセルをご覧ください。
定期購入者が特典を承諾したり解約したりせずに解約フローを終了した場合、定期購入は変更されません。これは、Google Play ストア アプリとウェブ上の Google Play の両方に適用されます。保持オファーを承諾せずに表示しても、オファーの申請上限にはカウントされず、オファー間の待機期間も開始されません。Google Play は、特典を表示するときと、定期購入者が特典を承諾したときに、利用回数の上限を確認します。承認された特典は、定期購入が割引価格で更新されるときに、利用上限にカウントされます。特典間の待機期間は、同じ基本プランの以前の維持特典の割引期間が終了したときに開始されます。定期購入者が引き続き利用条件を満たしている場合は、次回解約しようとしたときに特典が再度表示されることがあります。
スケジュール設定されたプラン移行
定期購入者が維持特典を承諾すると、Google Play は、定期購入者の既存の購入に対する予定されたプランの移行としてモデル化します。これは、新しい購入フローが必要で、新しい購入トークンが作成される遅延交換とは異なります。リテンション特典では、定期購入者は同じ purchaseToken を維持し、今後の請求条件のみが変更されます。
定期購入者がオファーを承諾すると、Google Play は次の処理を行います。
SUBSCRIPTION_PLAN_TRANSITION_UPDATED(21)RTDN をバックエンドに送信します。SubscriptionPurchaseV2リソースの影響を受ける広告申込情報のautoRenewingPlanフィールドにplanTransitionDetailsオブジェクトを追加します。
これらのイベントの処理方法については、バックエンドでリテンション特典イベントを処理するをご覧ください。
利用資格要件
定期購入は、次の条件をすべて満たしている限り、次回の更新前の任意のタイミングで保持特典を受け取ることができます。
- 定期購入は有効で、自動更新されます。猶予期間中、アカウントの一時停止中、または一時停止中の定期購入は、維持特典を受け取ることができません。
- 定期購入は 1 つの定期購入です。アドオンが含まれる定期購入では、リテンション特典はサポートされていません。
- 定期購入でインストール ベースの基本プランが使用されていない。インストール ベースのプランは、ユーザー維持を目的とした特典の対象外です。
- 次回のお支払いには、通常の定期的な基本プランの価格が適用されます。定期購入者が無料試用またはお試し価格のフェーズにいる場合、特典は、そのフェーズの最後の請求対象期間(次回の更新が通常料金になる期間)にのみ利用できます。
- 定期購入者が、以前に承諾した保持特典の割引請求対象期間にない。維持特典の割引期間中の定期購入者は、定期購入が通常の基本プランの価格で更新されるまで、別の維持特典を申請できません。
- 定期購入に保留中のプラン移行スケジュールがありません。サブスクリプションに設定できる保留中のスケジュールされたプラン移行は 1 つだけです。これは、
IN_PROGRESS状態のplanTransitionDetailsオブジェクトです。たとえば、まだ有効になっていない保持特典をすでに承諾している定期購入者は、別の保持特典を受け取ることはできません。 - 定期購入に未確認の価格変更はありません。
- リテンション特典の割引価格が、定期購入者の次回の基本プランの更新価格以下である。
- 定期購入者が、オファーに設定した利用資格ルールを満たしている。ユーザーごとのユーザー維持特典の場合、
activateOfferTargetingメソッドを使用して定期購入のターゲット設定を有効にしている。
リテンション オファーを設定する
保持特典は、Google Play Console または Google Play Developer API を使用して作成できます。各リテンション特典では、次のいずれかのターゲティング モードを使用します。
- ルールベースのターゲティング: デベロッパーが設定した資格ルール(有料定期購入の最低期間など)に基づいて、Google Play が対象となる定期購入者を決定します。
- ユーザーごとのターゲティング: バックエンドで、特定の定期購入をターゲットに設定することで、特典を表示する定期購入者を決定します。
基本プランには、同じ国または地域で複数の有効な維持特典を設定できます。定期購入者が複数の特典の対象となる場合、Google Play は解約フローで最大 1 つの維持特典を表示します。Google Play は、次の順序で特典を選択します。
- ターゲティング モード: ユーザーごとのターゲティング特典(
retentionPerUserRule)は、ルールベースの特典(retentionRule)よりも常に優先されます。これは、ルールベースの特典の割引率が高い場合でも同様です。 - 割引率: 同じターゲティング モードを使用する対象特典のうち、割引率が最も高い特典が Google Play に表示されます。
- 割引価格: 特典の割引率が同じ場合、Google Play には割引価格が最も低い特典が表示されます。
- オファー ID: オファーがまだ同順位の場合、Google Play は
offerIdがアルファベット順で最後になるオファーを表示します。
Google Play Console で維持特典を作成する
Google Play Console で保持特典を作成する手順は次のとおりです。
- [Google Play で収益化] > [アイテム] > [定期購入] に移動します。
- 定期購入を選択し、特典を追加する基本プランを選択します。
- [解約しようとしている既存の定期購入者] の特典を追加します。
- [コホートレベルの維持用特典] または [ユーザーレベルの維持用特典] を選択します。
Play Developer API を使用して保持特典を作成する
プログラムでリテンション特典を作成、更新することもできます。オファーを作成するには、monetization.subscriptions.basePlans.offers.create メソッドを呼び出します。既存の特典を更新するには、monetization.subscriptions.basePlans.offers.patch メソッドまたは monetization.subscriptions.basePlans.offers.batchUpdate メソッドを呼び出します。3 つのメソッドはすべて、retentionRule、retentionPerUserRule、startTime、endTime フィールドをサポートしています。SubscriptionOffer オブジェクトで、次のフィールドを設定します。
offerId: 固有の保持特典 ID。targeting:retentionRuleを、特典の対象となるユーザーを定義するRetentionTargetingRuleオブジェクトに設定します。使用可能なフィールドについては、保持対象ルールを設定するをご覧ください。代わりにバックエンドから対象となるサブスクライバーを選択するには、retentionPerUserRuleを設定します。詳しくは、特定の定期購入者を対象としたリテンション特典をご覧ください。phases[]: 保持特典は、1 つの価格フェーズのみをサポートします。このフェーズで、次のフィールドを設定します。recurrenceCount: 割引が適用される請求対象期間の数(1 ~ 52)。recurrenceCountが 1 より大きい場合、フェーズdurationは基本プランの請求対象期間と同じにする必要があります。regionalConfigs[]:relativeDiscountを 0 より大きく 1 より小さい小数として割引に設定します。たとえば、50% オフの場合は0.5を使用します。保持特典はrelativeDiscountのみをサポートしています。固定価格(price)、割引額(absoluteDiscount)、無料(free)のフェーズはサポートされていません。
startTime: 省略可。対象となる定期購入者がリテンション特典を利用できるようになる日時(RFC 3339 タイムスタンプ)。このフィールドを設定しても、特典は有効になりません。このフィールドを設定しない場合、特典は状態に基づいて利用可能になります。endTime: 省略可。特典のステータスに関係なく、保持特典の提供が停止される日時(RFC 3339 タイムスタンプ)。このフィールドを設定しない場合、特典に終了日はありません。このフィールドを設定する場合は、startTimeよりも後の将来の日付にする必要があります。
monetization.subscriptions.basePlans.offers.create メソッドは、startTime を設定した場合でも、常に DRAFT 状態でオファーを作成します。オファーを有効にするには、monetization.subscriptions.basePlans.offers.activate メソッドを呼び出します。
保持の適格性ルールを設定する
RetentionTargetingRule オブジェクトには次のフィールドがあります。
scope: 必須。ルールが考慮する定期購入。保持特典の場合、サポートされている値はthisSubscription(特典が定義されている定期購入)のみです。このフィールドは、{"thisSubscription": {}}に設定します。minDuration: 必須。利用資格を満たすために、ユーザーが有料サブスクライバーである必要がある最小期間(ISO 8601 の期間(日数))。P0D~P1826D。たとえば、90 日間の場合はP90Dを使用します。有料定期購入の最小期間を必要としない場合は、このフィールドをP0Dに設定します。allowMultipleClaims: 省略可。定期購入者が特典を複数回利用できるかどうか。falseの場合、この特典を一度利用した定期購入者は、再度利用することはできません。trueの場合、定期購入者は、以前の保持特典の割引期間の終了からminOfferCooldownDurationの時間が経過すると、再び対象となります。デフォルトはfalseです。minOfferCooldownDuration:allowMultipleClaimsがtrueの場合は必須。以前の保持特典の割引期間が終了してから、定期購入者が再び対象となるまでに経過する必要がある最小時間。ISO 8601 期間(日数)でP1D~P1826D。たとえば、180 日の場合はP180Dを使用します。allowMultipleClaimsがfalseであるか、設定されていない場合は、このフィールドを設定しないでください。
次の例は、90 日以上支払いを行った定期購入者が利用できるリテンション特典の SubscriptionOffer オブジェクトの startTime、endTime、targeting フィールドを示しています。この特典は、以前のリテンション割引が終了してから 180 日後に再度利用できます。
{
"offerId": "retention-50off-2m",
"startTime": "2026-12-01T00:00:00Z",
"endTime": "2027-03-01T00:00:00Z",
"targeting": {
"retentionRule": {
"scope": {
"thisSubscription": {}
},
"minDuration": "P90D",
"allowMultipleClaims": true,
"minOfferCooldownDuration": "P180D"
}
}
}
特定の定期購入者を対象とした解約防止特典
RetentionTargetingRule を使用して Google Play に資格を判断させる代わりに、バックエンドで選択した定期購入者のみに保持特典を提供できます。たとえば、解約予測モデルでリスクがあると判定された定期購入者や、アプリで解約手続きを開始した定期購入者を対象に特典を提供できます。
定期購入者には、他の維持特典と同じ Google Play の解約フローでユーザーごとの維持特典が表示されます。デベロッパーは、他の維持特典と同じ方法で承諾を処理します。詳しくは、バックエンドでリテンション オファー イベントを処理するをご覧ください。
特定の定期購入者を対象にリテンション特典を設定する手順は次のとおりです。
ユーザー維持特典を作成する。
monetization.subscriptions.basePlans.offers.create、monetization.subscriptions.basePlans.offers.patch、またはmonetization.subscriptions.basePlans.offers.batchUpdateメソッドを呼び出すときに、targetingをretentionRuleオブジェクトではなくretentionPerUserRuleオブジェクトに設定します。RetentionPerUserTargetingRuleオブジェクトにはフィールドがありません。特典では、retentionRuleまたはretentionPerUserRuleのいずれかを使用できますが、両方を使用することはできません。{ "offerId": "retention-peruser-30off", "targeting": { "retentionPerUserRule": {} } }定期購入者を対象にする前に、特典を有効にしてください。有効化されたことがないオファーに対して
activateOfferTargetingメソッドを呼び出すと、呼び出しは失敗し、HTTP400 Bad Requestステータス コードとINVALID_ARGUMENTエラーステータスが返されます。詳しくは、ターゲティング エラーを処理するをご覧ください。特典が有効な場合でも、Google Play に表示されるのは、次のステップで対象とする定期購入の定期購入者のみです。特典を定期購入にターゲティングする。アプリのパッケージ名、定期購入の
purchaseToken、ユーザー維持特典のofferIdを指定して、purchases.subscriptionsv2.activateOfferTargetingメソッドを呼び出します。POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{purchaseToken}:activateOfferTargeting { "offerId": "retention-peruser-30off" }呼び出しが成功すると、レスポンス本文のない HTTP
204 No Contentステータス コードが返されます。Google Play は定期購入とともにターゲティングを保存するため、定期購入者が解約した時点で API を呼び出す必要はありません。定期購入者が次回 Google Play で解約を開始したときに、定期購入が資格要件を満たしていれば、Google Play に特典が表示されます。ユーザーごとのターゲティングでは、retentionRuleで定義された適格性ルールのみが置き換えられます。その他のすべての資格要件と、Google Play が実施するプラットフォーム レベルのチェック(地域のコンプライアンス要件など)は引き続き適用されます。同じ定期購入に複数のユーザー維持特典をターゲットに設定できます。これを行うには、各特典に対して
activateOfferTargetingメソッドを 1 回呼び出します。Google Play では、解約フローに最大 1 つの保持特典が表示されます。Google Play が特典を選択する方法については、リテンション特典を構成するをご覧ください。activateOfferTargetingメソッドはべき等です。すでに定期購入の対象となっている特典に対して呼び出すと、呼び出しは成功し、Google Play は特典のactivateTimeを最新のリクエストの時刻に更新します。必要に応じてターゲティングを削除する。解約リスクが変化したなどの理由で、定期購入者が特典を受け取らないようにする場合は、同じパッケージ名、
purchaseToken、offerIdを指定してpurchases.subscriptionsv2.deactivateOfferTargetingメソッドを呼び出します。呼び出しが成功すると、レスポンス本文のない HTTP204 No Contentステータス コードが返されます。deactivateOfferTargetingメソッドもべき等です。ターゲティングを有効にしていないなどの理由で、特典が定期購入を対象としていない場合、呼び出しは成功しますが、効果はありません。
ターゲティングは 1 つの purchaseToken に適用され、サブスクリプションが有効で自動更新されている間は期限切れになりません。購読者が特典を確認、承諾、または拒否した後も、このバッジは表示されたままになります。Google Play で削除されるのは、deactivateOfferTargeting メソッドを呼び出したとき、または定期購入の有効期限が切れてから 60 日後です。プランの変更または再登録によって新しい purchaseToken が作成された場合、ターゲティングは引き継がれません。
定期購入を対象とするユーザー維持特典を確認するには、purchases.subscriptionsv2.get メソッドを呼び出します。各広告申込情報の developerTargetedOffers フィールドには、ターゲットに設定されたオファーが一覧表示されます。各エントリには、ターゲティングを有効にしたときの offerId と activateTime が含まれます。
{
"lineItems": [
{
"productId": "premium_monthly_sub",
"developerTargetedOffers": [
{
"offerId": "retention-peruser-30off",
"activateTime": "2026-12-03T15:04:05Z"
}
]
}
]
}
ターゲティング エラーを処理する
activateOfferTargeting メソッドまたは deactivateOfferTargeting メソッドの呼び出しが失敗すると、レスポンスには HTTP ステータス コードと、原因を説明するエラー ステータスが含まれます。次の表に、これらのメソッドが返す HTTP ステータス コードとエラー ステータスを示します。
| HTTP ステータス コード | エラー ステータス | メソッド | 原因 |
|---|---|---|---|
404 Not Found |
NOT_FOUND |
両方 | purchaseToken が存在しません。 |
400 Bad Request |
INVALID_ARGUMENT |
activateOfferTargeting |
offerId が定期購入の現在の基本プランに存在しないか、特典がまだ未公開状態で、有効化されたことがありません。 |
400 Bad Request |
FAILED_PRECONDITION |
activateOfferTargeting |
特典の targeting が retentionPerUserRule に設定されていない。 |
400 Bad Request |
FAILED_PRECONDITION |
activateOfferTargeting |
サブスクリプションの有効期限がすでに切れている。 |
activateOfferTargeting メソッドは、有効期限が切れていない定期購入が特典の対象かどうかを確認しません。たとえば、定期購入が解約されていても有効期限が切れていない場合、呼び出しは成功し、Google Play ストアにターゲティングが保存されます。Google Play は、定期購入者が解約フローに入ったときに、定期購入の対象条件を評価します。
バックエンドでリテンション特典イベントを処理する
定期購入者が維持特典を承諾し、その後、割引価格で更新が行われると、Google Play はバックエンドに RTDN を送信します。各通知を受け取ったら、通知の purchaseToken を指定して purchases.subscriptionsv2.get メソッドを呼び出し、最新の定期購入ステータスを取得します。
保持特典を承諾しても、新しい購入は作成されません。purchaseToken は同じままなので、購入を再度承認する必要はなく、Google Play は linkedPurchaseToken を生成しません。サブスクライバーの既存の利用資格をそのまま維持します。割引された更新注文を、他の定期購入の更新と同じ方法で処理します。
| 通知の種類 | 送信されるタイミング | 手順 |
|---|---|---|
SUBSCRIPTION_PLAN_TRANSITION_UPDATED(21) |
定期購入者が解約フローで保持特典を承諾したとき。 | purchases.subscriptionsv2.get メソッドを呼び出し、planTransitionDetails を確認します。transitionState は IN_PROGRESS です。定期購入は有効なままで、自動更新されるため、引き続きアクセスを許可します。 |
SUBSCRIPTION_RENEWED(2) |
現在の請求対象期間が終了し、割引された保持特典価格で定期購入が更新されたとき。 | purchases.subscriptionsv2.get メソッドを呼び出し、offerDetails.offerId が保持特典 ID であり、planTransitionDetails が存在しないことを確認して、定期購入者のアクセスを新しい expiryTime に延長します。 |
planTransitionDetails オブジェクトには次のフィールドがあります。
productId: 定期購入の移行先となるプランの商品 ID。リテンション特典の場合、これは同じ商品です。basePlanId: 定期購入の移行先となるプランの基本プラン ID。offerId: 登録者が承諾したリテンション オファーの ID。このフィールドを使用して、利用されたリテンション特典を特定します。transitionInfo.transitionState: 移行の状態。保持特典の場合、移行が保留中の間、状態はIN_PROGRESSになります。transitionInfo.expectedTransitionTime: 保持特典の利用規約が有効になる予定の時期。
Google Play に planTransitionDetails が含まれるのは、移行が保留中の間のみです。定期購入が割引価格の保持特典で更新されると、移行が完了し、Google Play は purchases.subscriptionsv2.get レスポンスから planTransitionDetails を削除します。それ以降、広告申込情報自体に有効な保持割引が表示されます。
offerDetails.offerIdは、承認されたリテンション特典の ID です。offerPhaseは、割引請求期間中は{"introductoryPrice": {}}です。割引請求対象期間が終了し、定期購入が通常の基本プランの価格で更新されると、offerPhaseは{"basePrice": {}}に変更されます。
サブスクライバーがオファーを承諾した後のレスポンス
定期購入者が保持特典を承諾すると、現在の請求対象期間は変更されずに継続されます。planTransitionDetails オブジェクトには、IN_PROGRESS の transitionState でスケジュールされた移行が表示されます。
{
"lineItems": [
{
"productId": "premium_monthly_sub",
"expiryTime": "2026-12-15T10:00:00Z",
"offerDetails": {
"basePlanId": "monthly-base"
},
"autoRenewingPlan": {
"autoRenewEnabled": true,
"planTransitionDetails": {
"productId": "premium_monthly_sub",
"basePlanId": "monthly-base",
"offerId": "retention-50off-2m",
"transitionInfo": {
"transitionState": "IN_PROGRESS",
"expectedTransitionTime": "2026-12-15T10:00:00Z"
}
}
}
}
]
}
割引更新後の対応
更新日が過ぎて、定期購入者に割引価格が請求されると、offerDetails.offerId には保持特典が表示され、offerPhase には introductoryPrice が表示されます。レスポンスには planTransitionDetails が含まれなくなります。
{
"lineItems": [
{
"productId": "premium_monthly_sub",
"expiryTime": "2027-01-15T10:00:00Z",
"offerDetails": {
"basePlanId": "monthly-base",
"offerId": "retention-50off-2m"
},
"offerPhase": {
"introductoryPrice": {}
},
"autoRenewingPlan": {
"autoRenewEnabled": true,
"recurringPrice": {
"currencyCode": "USD",
"units": "9",
"nanos": 990000000
}
}
}
]
}
ライフサイクル インタラクション
保持特典を処理する際は、次の動作に注意してください。
- 割引の終了: 割引請求対象期間が終了すると、定期購入は通常の基本プランの価格で自動更新されます。他の更新と同様に
SUBSCRIPTION_RENEWED通知が届き、広告申込情報のofferPhaseが{"basePrice": {}}に変更されます。サブスクライバー側で必要なご対応はありません。 - 割引後の支払い復旧: 割引終了後の通常の基本プラン料金での更新が拒否され、定期購入が猶予期間またはアカウントの一時停止に入った場合、支払い復旧では通常の基本プラン料金が請求されます。Google Play は、完了した保持特典の割引を適用しません。最初の割引更新のお支払いが不承認となった場合、保留中の移行は保持され、お支払いが回復したときに保持特典の価格が適用されます。
- 遅延請求: 保持特典の移行が
IN_PROGRESSのときにpurchases.subscriptionsv2.deferメソッドを呼び出すと、保留中の移行が保持され、遅延更新時に適用されます。新しい更新日を取得するには、広告申込情報のexpiryTimeを確認します。 - 移行前のプラン変更: 保持特典は、定期購入者が特典を承諾した定期購入の
purchaseTokenにのみ適用されます。expectedTransitionTimeの前に、定期購入者が別の基本プランまたは定期購入に切り替えた場合、Google Play は新しい購入トークンを生成し、スケジュール設定された移行をキャンセルして、planTransitionDetailsをクリアします。保留中の保持特典は新しいプランには適用されません。 - 解約と復元: 保持特典を承諾した後に定期購入者が定期購入を解約した場合、スケジュールされた移行は保留中のままになり、
transitionStateはIN_PROGRESSのままになります。定期購入者が有効期限前に定期購入を復元した場合、更新時に保持特典の割引が適用されます。 - 有効期限切れと再登録: 復元されずに定期購入の有効期限が切れた場合、Google Play は保留中の移行をキャンセルします。ユーザーが後で再度定期購入または登録した場合、Google Play は新しい定期購入を作成し、以前に承認された保持特典は適用されません。
- 特典の変更: 保持特典の割引期間または請求対象期間を変更した場合、その変更は今後の利用にのみ適用されます。すでに特典を承認している定期購入者には、元の利用規約が引き続き適用されます。
- 特典の無効化: 保持特典を無効にした場合、または特典が終了日に達した場合、すでに特典を承諾している定期購入者には、同意した利用規約が引き続き適用されます。
IN_PROGRESSへの移行中の定期購入者には、次回の更新時に割引が適用されます。すでに割引期間中の定期購入者には、合意された期間全体にわたって割引が適用されます。 - 価格の変更: 基本プランの価格変更は引き続き適用されます。Google Play が定期購入者を新しい価格に移行するのは、定期購入者が正規の価格を支払っており、保留中のリテンション特典の移行がない場合に限られます。詳しくは、定期購入の価格を変更するをご覧ください。
- 払い戻し:
purchases.subscriptionsv2.revokeメソッドなどの標準の払い戻し API と取り消し API を使用して、定期購入者に払い戻しを行うことができます。これにより、直近の支払いが払い戻され、定期購入者のアクセスが終了します。
維持用特典をテストする
Google Play では、解約フローに有効な保持特典のみが表示され、利用資格ルールがリアルタイムで評価されます。ライセンス テスター アカウントでリテンション特典をテストするには、次のいずれかの方法を使用します。
- 実際の定期購入者に特典を表示することなく、本番環境の基本プランでユーザー維持特典をテストします。
- 製品版ユーザーがアクセスできないテストアプリまたはテスト基本プランで、ルールベースの保持特典をテストします。
どちらの方法を使用する場合も、Google Play Console で [設定] > [ライセンス テスト] に移動し、テスト用の Google アカウントをライセンス テスターとして追加します。
ユーザー維持用特典をテストする
Google Play では、ユーザーごとのユーザー維持特典は、対象となる定期購入にのみ表示されます。そのため、実際の定期購入者に公開することなく、製品版の基本プランでテストできます。ユーザーごとのユーザー維持特典をテストする手順は次のとおりです。
- 基本プランでユーザー維持特典を作成し、有効にします。Google Play Console で [ユーザーレベルの維持特典] を選択します。Google Play Developer API を使用して、
targetingをretentionPerUserRuleオブジェクトに設定します。詳しくは、特定の定期購入者を対象としたリテンション特典をご覧ください。 - 特典を有効にしたばかりの場合は、変更が反映されるまで 10 ~ 15 分ほど待ってから、Google Play ストア アプリのキャッシュを削除します。
- テストデバイスで、ライセンス テスター アカウントを使用してログインし、アプリで基本プランを購入します。
- バックエンドから、アプリのパッケージ名、ライセンス テスターの
purchaseToken、リテンション特典のofferIdを指定してpurchases.subscriptionsv2.activateOfferTargetingメソッドを呼び出します。 - Google Play ストア アプリで、[お支払いと定期購入] > [定期購入] に移動し、定期購入を選択して [定期購入を解約] をタップします。解約フローに、解約防止特典が表示されます。
- 特典を承諾し、バックエンドが
SUBSCRIPTION_PLAN_TRANSITION_UPDATEDRTDN を受信して割引更新を処理することを確認します。
ルールベースの維持用特典をテストする
ルールベースの保持特典を有効にすると、Google Play は基本プランの対象となる定期購入者にその特典を表示できます。製品版ユーザーに特典が表示されないようにするには、非製品版のテストアプリまたは製品版ユーザーがアクセスできない専用のテスト用基本プランでテストします。ルールベースの保持特典をテストする手順は次のとおりです。
- テストアプリまたはテスト基本プランで、ルールベースの保持特典を作成し、
minDurationをP0D(0 日)に設定します。Google Play Console で [コホートレベルの維持特典] を選択します。Google Play Developer API を使用して、targetingをretentionRuleオブジェクトに設定します。詳細については、保持資格ルールを設定するをご覧ください。 - 特典を有効にして、変更が反映されるまで 10 ~ 15 分待ってから、Google Play ストア アプリのキャッシュを削除します。
- テストデバイスで、ライセンス テスター アカウントを使用してログインし、テスト用の基本プランを購入します。
- Google Play ストア アプリで、[お支払いと定期購入] > [定期購入] に移動し、定期購入を選択して [定期購入を解約] をタップします。この特典には有料定期購入の最小期間が設定されていないため、購入直後に解約フローを開始できます。解約フローに保持オファーが表示されます。
- 特典を承諾し、バックエンドが
SUBSCRIPTION_PLAN_TRANSITION_UPDATEDRTDN を受信して割引更新を処理することを確認します。
統合を確認したら、本番環境の基本プランでルールベースの保持特典を作成して有効にします。
リテンション特典のテストに関するトラブルシューティング
保持特典が表示されない場合は、次の点を確認してください。
- 保持特典が有効で、現在時刻が
startTimeとendTimeの間にある(設定されている場合)。 - ユーザーごとの保持特典の場合、ライセンス テスターの
purchaseTokenに対するpurchases.subscriptionsv2.getレスポンスのdeveloperTargetedOffersフィールドに特典が含まれます。 - 定期購入が、アドオン付きの定期購入ではなく、単一の定期購入である。
- 定期購入が猶予期間中、アカウントの一時停止中、一時停止中ではない。
- 定期購入に保留中のプラン変更や価格変更がない。
- 次回の更新は、通常の基本プランの価格で行われます。無料試用と初回特典の場合、リテンション特典は、試用フェーズまたは初回フェーズの最後の請求対象期間中にのみ利用できます。
- 特典を有効化または変更してから 10 ~ 15 分待って、Google Play ストア アプリのキャッシュを削除した。