透過續訂優惠留住訂閱者

續訂優惠可向嘗試在 Google Play 取消訂閱的使用者顯示折扣,有助於降低自願流失率。

當符合資格的訂閱者開始取消訂閱時,Google Play 會顯示您設定的挽留優惠,例如「保留訂閱,未來 2 個月可享 5 折優惠」。如果訂閱者接受優惠,訂閱就不會取消。折扣價將於下個帳單結算日生效。

本頁面說明續訂優惠的運作方式、設定方式、如何在後端處理產生的事件,以及如何測試。

事前準備

設定續訂優惠前,請務必完成下列事項:

Google Play 會在應用程式外顯示續訂優惠,因此您不必變更應用程式或更新 Google Play Billing Library 整合,即可使用這些優惠。所有整合工作都會在 Google Play 管理中心和後端進行。

續訂優惠的運作方式

續訂優惠只會顯示在 Google Play 訂閱管理頁面:Google Play 商店應用程式和 Google Play 網頁版。這類優惠不會顯示在應用程式中。Google Play Billing Library 不會在 queryProductDetailsAsync() 結果中傳回續訂優惠,因此這類優惠不會包含在 ProductDetails.getSubscriptionOfferDetails() 中,您也無法透過 launchBillingFlow() 銷售。如果應用程式使用深層連結,將訂閱者導向 Google Play 訂閱中心或特定訂閱項目,以便管理或取消訂閱,則訂閱者在開始取消訂閱時,就會看到您的挽留優惠。

以下步驟說明訂閱者嘗試取消訂閱時會發生的情況:

  1. 訂閱者在 Google Play 中開啟訂閱項目,並開始取消訂閱。
  2. Google Play 會根據您為優惠設定的資格條件規則,或您是否將優惠指定給該訂閱者,檢查訂閱者是否符合其中一項客戶留存優惠的資格。

  3. 如果訂閱者符合資格,Google Play 可能會顯示續訂優惠,做為取消訂閱的替代方案。即使符合資格條件,也不保證一定會顯示優惠,因為 Google Play 還會執行其他平台層級檢查,例如區域法規遵循要求。如果 Google Play 顯示優惠,訂閱者可以採取下列任一做法:

    • 接受優惠:訂閱者輕觸一下即可接受。訂閱項目會維持有效狀態並自動續訂。系統不會立即向訂閱者收費,而是從下一個帳單週期開始套用折扣價格。
    • 繼續取消:訂閱者拒絕優惠,並完成標準取消流程。您會收到一般的 SUBSCRIPTION_CANCELED 通知。詳情請參閱「取消」。

如果訂閱者未接受優惠或取消訂閱,就離開取消流程,訂閱項目不會變更。這項規定適用於 Google Play 商店應用程式和 Google Play 網站。如果使用者只是查看續訂優惠,但未接受,則不計入優惠領取上限,也不會開始計算優惠之間的等待期。Google Play 會在顯示優惠時檢查兌換上限,並在訂閱者接受優惠時再次檢查。當訂閱項目以折扣價續訂時,接受的優惠會計入兌換上限。優惠之間的等待期,從相同基本方案的前一個續訂優惠折扣期結束時開始計算。如果訂閱者仍符合資格,下次嘗試取消訂閱時,可能會再次看到優惠。

排定的方案轉換

當訂閱者接受續訂優惠時,Google Play 會將其視為訂閱者現有購買交易的排定方案轉換。這與延後更換不同,後者需要新的購買流程,並建立新的購買憑證。透過續訂優惠,訂閱者可保留相同的 purchaseToken,只有未來的帳單條款會變更。

訂閱者接受優惠後,Google Play 會執行下列操作:

  • 將 SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) RTDN 傳送至後端。
  • 在 SubscriptionPurchaseV2 資源中,將 planTransitionDetails 物件新增至受影響委刊項的 autoRenewingPlan 欄位。

如要進一步瞭解如何處理這些事件,請參閱「在後端處理續訂優惠事件」。

資格規定

只要符合下列所有條件,訂閱項目在下次續訂前,隨時可以收到續訂優惠:

  • 訂閱方案有效且會自動續訂。處於寬限期、帳戶保留或暫停狀態的訂閱項目無法接收續訂優惠。
  • 訂閱方案為單一訂閱。含有加購內容的訂閱項目不支援續訂優惠。
  • 訂閱項目未使用安裝數基本方案。安裝數方案不適用續訂優惠。
  • 下次付款時,系統會收取基本方案的定期原價。如果訂閱者處於免費試用期或新用戶優惠階段,則只有在該階段的最後一個帳單週期,且即將以原價續訂時,才能享有優惠。
  • 訂閱者未處於先前接受的續訂優惠折扣帳單週期。如果訂閱者處於續訂優惠的折扣階段,則必須等到訂閱項目以一般基本方案價格續訂後,才能領取其他續訂優惠。
  • 訂閱項目沒有待處理的排定方案轉換作業。訂閱項目最多只能有一個待處理的排定方案轉換,也就是處於 IN_PROGRESS 狀態的 planTransitionDetails 物件。舉例來說,如果訂閱者已接受尚未生效的續訂優惠,就無法再收到其他優惠。
  • 訂閱項目沒有未確認的價格異動。
  • 續訂優惠的折扣價格小於或等於訂閱者下次續訂基本方案的價格。
  • 訂閱者符合您為優惠設定的資格規則。如要提供每位使用者專屬的續訂優惠,請使用 activateOfferTargeting 方法啟用訂閱項目的指定目標功能。

設定續訂優惠

您可以在 Google Play 管理中心或使用 Google Play Developer API 建立續訂優惠。每項續訂優惠都會使用下列其中一種指定目標模式:

  • 以規則為基礎的指定目標:Google Play 會根據您設定的資格規則 (例如最短付費訂閱時間),決定哪些訂閱者符合資格。
  • 指定使用者:後端會指定特定訂閱項目,決定哪些訂閱者可以查看優惠。

在同一個國家/地區,一個基本方案可以有多項有效的續訂優惠。如果訂閱者符合多項優惠的資格,Google Play 最多會在取消流程中顯示一項續訂優惠。Google Play 會按照下列順序選擇優惠:

  1. 指定模式:指定使用者的優惠 (retentionPerUserRule) 一律優先於規則型優惠 (retentionRule),即使規則型優惠的折扣百分比較高也一樣。
  2. 折扣百分比:在採用相同指定模式的符合資格優惠中,Google Play 會顯示折扣百分比最高的優惠。
  3. 折扣價格:如果優惠的折扣百分比相同,Google Play 會顯示折扣價格最低的優惠。
  4. 優惠 ID:如果優惠仍不分軒輊,Google Play 會顯示 offerId 依字母順序排在最後的優惠。

在 Play 管理中心建立續訂優惠

如要在 Google Play 管理中心建立續訂優惠,請按照下列步驟操作:

  1. 依序點選「透過 Google Play 營利」>「產品」>「訂閱項目」。
  2. 選取訂閱項目,然後選取要新增優惠的基本方案。
  3. 為「嘗試取消的現有訂閱者」新增優惠。
  4. 選擇「同類群組層級留存優惠」或「使用者層級留存優惠」。

使用 Play Developer API 建立續訂優惠

您也可以透過程式輔助方式建立及更新續訂優惠。如要建立優惠,請呼叫 monetization.subscriptions.basePlans.offers.create 方法。如要更新現有優惠,請呼叫 monetization.subscriptions.basePlans.offers.patch 或 monetization.subscriptions.basePlans.offers.batchUpdate 方法。這三種方法都支援 retentionRule、retentionPerUserRule、startTime 和 endTime 欄位。在 SubscriptionOffer 物件中,設定下列欄位:

  • offerId:專屬續訂優惠 ID。
  • targeting:將 retentionRule 設為 RetentionTargetingRule 物件,定義誰符合優惠資格。如要瞭解可用欄位,請參閱「設定保留資格規則」。如要改為從後端選擇符合資格的訂閱者,請設定 retentionPerUserRule。詳情請參閱「針對特定訂閱者提供續訂優惠」。
  • phases[]:續訂優惠僅支援單一定價階段。在該階段中,設定下列欄位:
    • recurrenceCount:折扣持續的帳單週期數,從 1 到 52。如果 recurrenceCount 大於 1,則階段 duration 必須等於基本方案的帳單週期。
    • regionalConfigs[]:將 relativeDiscount 設為折扣,以大於 0 且小於 1 的分數表示。例如,如要提供 5 折優惠,請使用 0.5。續訂優惠僅支援 relativeDiscount。不支援固定價格 (price)、絕對折扣 (absoluteDiscount) 和免費 (free) 階段。
  • startTime:選用。符合資格的訂閱者可取得續訂優惠的時間,採用 RFC 3339 時間戳記格式。設定這個欄位並不會啟用優惠。如未設定這個欄位,系統會根據優惠狀態決定是否提供。
  • endTime:選用。續訂優惠停止提供的時間,以 RFC 3339 時間戳記表示,無論優惠狀態為何。如未設定這個欄位,優惠就不會有結束日期。如果設定這個欄位,則必須設為未來的時間,且晚於 startTime。

即使您設定 startTime,monetization.subscriptions.basePlans.offers.create 方法也一律會建立 DRAFT 狀態的優惠。如要啟用優惠,請呼叫 monetization.subscriptions.basePlans.offers.activate 方法。

設定保留資格規則

RetentionTargetingRule 物件包含下列欄位:

  • scope:必填,規則考量的訂閱項目。如果是續訂優惠,唯一支援的值是 thisSubscription,也就是定義優惠的訂閱項目。請將這個欄位設為 {"thisSubscription": {}}。
  • minDuration:必填,使用者必須成為付費訂閱者多久,才符合資格。請以 ISO 8601 格式指定天數,範圍為 P0D 到 P1826D。舉例來說,使用 P90D 90 天。如不要求最短付費訂閱時間,請將這個欄位設為 P0D。
  • allowMultipleClaims:選用。訂閱者是否可以多次領取優惠。如果設為 false,則訂閱者兌換過這項優惠後,就無法再次兌換。如果 true,訂閱者在上次續訂優惠折扣期結束後,經過 minOfferCooldownDuration 的時間,即可再次符合資格。預設為 false。
  • minOfferCooldownDuration:如果 allowMultipleClaims 為 true,則為必要。訂閱者必須在上次續訂優惠的折扣期結束後,經過至少這段時間,才能再次符合資格。請以 ISO 8601 格式指定天數,範圍為 P1D 到 P1826D。例如,使用 P180D 180 天。如果 allowMultipleClaims 為 false 或未設定,請勿設定這個欄位。

以下範例顯示 SubscriptionOffer 物件的 startTime、endTime 和 targeting 欄位,用於提供續訂優惠給已付費至少 90 天的訂閱者,且他們可以在上次續訂折扣結束 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"
    }
  }
}

向特定訂閱者提供續訂優惠

您可以只向後端選擇的訂閱者提供續訂優惠,而不是讓 Google Play 透過 RetentionTargetingRule 決定資格。舉例來說,您可以針對流失預測模型標示為有風險的訂閱者,或是在應用程式中開始取消流程的訂閱者提供優惠。

訂閱者會在 Google Play 取消流程中看到每位使用者專屬的挽留優惠,就像其他挽留優惠一樣,您也以相同方式處理接受情況。詳情請參閱「在後端處理續訂優惠事件」。

如要向特定訂閱者提供續訂優惠,請按照下列步驟操作:

  1. 建立每位使用者的續訂優惠。呼叫 monetization.subscriptions.basePlans.offers.create、monetization.subscriptions.basePlans.offers.patch 或 monetization.subscriptions.basePlans.offers.batchUpdate 方法時,請將 targeting 設為 retentionPerUserRule 物件,而非 retentionRule 物件。RetentionPerUserTargetingRule 物件沒有任何欄位。優惠可使用 retentionRule 或 retentionPerUserRule,但不能同時使用。

    {
      "offerId": "retention-peruser-30off",
      "targeting": {
        "retentionPerUserRule": {}
      }
    }
    

    請先啟用優惠,再指定訂閱者。如果您針對從未啟用的優惠呼叫 activateOfferTargeting 方法,呼叫會失敗,並傳回 HTTP 400 Bad Request 狀態碼和 INVALID_ARGUMENT 錯誤狀態。詳情請參閱「處理指定目標錯誤」。即使優惠有效,Google Play 也只會向您在下一步指定的訂閱者顯示優惠。

  2. 將優惠指定給訂閱項目。呼叫 purchases.subscriptionsv2.activateOfferTargeting 方法,並傳入應用程式的套件名稱、訂閱項目的 purchaseToken,以及每位使用者留存優惠的 offerId:

    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 方法一次。Google Play 仍會在取消流程中,顯示最多一項續訂優惠。如要進一步瞭解 Google Play 如何選擇優惠,請參閱「設定續訂優惠」。

    activateOfferTargeting 方法具有冪等性。如果針對已指定訂閱項目的優惠呼叫這個方法,呼叫會成功,且 Google Play 會將優惠的 activateTime 更新為最新要求的時間。

  3. 視需要移除指定目標。如果不想再讓訂閱者收到優惠 (例如流失風險已改變),請使用相同的套件名稱、purchaseToken 和 offerId 呼叫 purchases.subscriptionsv2.deactivateOfferTargeting 方法。如果呼叫成功,系統會傳回 HTTP 204 No Content 狀態碼,不含回應主體。

    deactivateOfferTargeting 方法也具有冪等性。如果優惠未指定訂閱項目 (例如您從未啟用指定目標),呼叫會成功,但不會產生任何效果。

指定目標適用於單一 purchaseToken,且在訂閱有效並自動續訂期間不會過期。訂閱者查看、接受或拒絕優惠後,優惠仍會保留在原處。只有在您呼叫 deactivateOfferTargeting 方法,或訂閱到期 60 天後,Google Play 才會移除該訂閱。如果變更方案或重新訂閱會建立新的 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 物件會顯示排定的轉換,transitionState 為 IN_PROGRESS:

{
  "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 才會將訂閱者遷移至新價格。詳情請參閱「變更訂閱價格」。
  • 退款:您可以使用標準退款和撤銷 API (例如 purchases.subscriptionsv2.revoke 方法) 為訂閱者退款。系統會退還最近一筆款項,並終止訂閱者的存取權。

測試續訂優惠

Google Play 只會在取消流程中顯示有效的續訂優惠,並會根據實際日曆時間評估資格規則。如要使用授權測試人員帳戶測試續訂優惠,請採用下列其中一種方法:

無論使用哪種方法,請先前往 Google Play 管理中心的「設定」>「授權測試」,將測試 Google 帳戶新增為授權測試人員。

測試個別使用者留存優惠

Google Play 只會針對您指定的訂閱項目,向每位使用者顯示使用者留存優惠,因此您可以在正式版基本方案中測試,不必向實際訂閱者顯示。如要測試每位使用者專屬的使用者留存優惠,請按照下列步驟操作:

  1. 在基本方案下建立每位使用者留存優惠,然後啟用。在 Google Play 管理中心選擇「使用者層級續訂優惠」。使用 Google Play Developer API 時,請將 targeting 設為 retentionPerUserRule 物件。詳情請參閱「向特定訂閱者提供續訂優惠」。
  2. 如果剛啟用優惠,請等待 10 到 15 分鐘,讓變更生效,然後清除 Google Play 商店應用程式快取。
  3. 在測試裝置上,使用授權測試人員帳戶登入,然後在應用程式中購買基本方案。
  4. 從後端呼叫 purchases.subscriptionsv2.activateOfferTargeting 方法,並提供應用程式套件名稱、授權測試人員的 purchaseToken,以及續訂優惠的 offerId。
  5. 在 Google Play 商店應用程式中,依序前往「付款與訂閱」>「訂閱」,選取訂閱項目,然後輕觸「取消訂閱」。續訂優惠會顯示在取消流程中。
  6. 接受優惠,然後確認後端收到 SUBSCRIPTION_PLAN_TRANSITION_UPDATED RTDN,並處理折扣續訂。

測試規則型留存優惠

啟用規則型續訂優惠後,Google Play 就能向基本方案中符合資格的訂閱者顯示優惠。為避免正式版使用者看到優惠,請在非正式版測試應用程式中測試,或在正式版使用者無法存取的專用測試基本方案中測試。如要測試以規則為基礎的續訂優惠,請按照下列步驟操作:

  1. 在測試應用程式或測試基本方案中,建立以規則為依據的保留優惠,並將 minDuration 設為 P0D (0 天)。在 Google Play 管理中心選擇「同類群組層級續訂優惠」。使用 Google Play Developer API 時,請將 targeting 設為 retentionRule 物件。詳情請參閱「設定保留資格規則」。
  2. 啟用優惠,等待 10 到 15 分鐘讓變更生效,然後清除 Google Play 商店應用程式快取。
  3. 在測試裝置上,使用授權測試人員帳戶登入,然後購買測試基本方案。
  4. 在 Google Play 商店應用程式中,依序前往「付款與訂閱」>「訂閱」,選取訂閱項目,然後輕觸「取消訂閱」。由於優惠不要求最短付費訂閱時間,因此您可以在購買後立即啟動取消流程。取消流程中會顯示續訂優惠。
  5. 接受優惠,然後確認後端收到 SUBSCRIPTION_PLAN_TRANSITION_UPDATED RTDN,並處理折扣續訂。

驗證整合後,請在正式版基本方案中建立並啟用規則型保留優惠。

排解續訂優惠測試問題

如果系統未顯示續訂優惠,請檢查下列事項:

  • 續訂優惠已生效,且目前時間介於您設定的 startTime 和 endTime 之間。
  • 如果是每位使用者專屬的客戶留存優惠,授權測試人員 purchaseToken 的 purchases.subscriptionsv2.get 回應中的 developerTargetedOffers 欄位會包含該優惠。
  • 訂閱項目為單一訂閱項目,不含加購內容。
  • 訂閱項目未處於寬限期、帳戶保留或暫停狀態。
  • 訂閱方案沒有待處理的方案變更或價格變更。
  • 下次續訂時,將依標準基本方案價格收費。如果是免費試用和新用戶優惠,則只能在試用或新用戶優惠階段的最後一個帳單週期提供續訂優惠。
  • 啟用或變更優惠後,請等待 10 到 15 分鐘,並清除 Play 商店應用程式快取。