利用留存优惠留住订阅者

留存优惠可帮助您减少主动取消订阅的用户流失,具体做法是在订阅者尝试在 Google Play 中取消订阅时向其显示折扣。

当符合条件的订阅者开始取消订阅时,Google Play 会向其显示您配置的留存优惠,例如“保留订阅,未来 2 个月可享 5 折优惠”。如果订阅者接受优惠,其订阅不会取消。折扣价从下一个结算日开始生效。

本页面介绍了留存优惠的运作方式、配置方法、如何在后端处理由此产生的事件,以及如何测试留存优惠。

准备工作

在设置留存优惠之前,请确保您已完成以下操作:

由于 Google Play 会在应用之外显示留存优惠,因此您无需更改应用或更新 Google Play 结算库集成即可使用这些优惠。所有集成工作都在 Google Play 管理中心和您的后端中进行。

留存优惠的运作方式

留存优惠仅会显示在 Google Play 订阅管理中:Google Play 商店应用和 Google Play 网页版。它们不会显示在您的应用内。Google Play 结算库不会在 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 资源中受影响订单项的 autoRenewingPlan 字段添加 planTransitionDetails 对象。

如需详细了解如何处理这些事件,请参阅在后端处理留存优惠事件。

资格要求

只要满足以下所有条件,订阅便可在下次续订前的任何时间收到留存优惠:

  • 订阅处于有效状态,且会自动续订。处于宽限期、账号冻结或暂停状态的订阅无法收到留存优惠。
  • 该订阅为单项订阅。包含加购项的订阅不支持留存优惠。
  • 此订阅不使用安装量基础方案。安装量方案不符合享受留存优惠的条件。
  • 下次付款时,系统会按常规周期性基础方案价格收费。如果订阅者处于免费试用或初次体验价阶段,则只有在该阶段的最后一个结算周期内(即即将按正常价格续订时),才能享受优惠。
  • 订阅者未处于之前接受的挽留优惠的折扣结算周期内。处于留住用户优惠折扣阶段的订阅者无法再享受其他留住用户优惠,直到订阅以常规基础方案价格续订。
  • 该订阅没有待处理的预定方案切换。一个订阅最多只能有一个待处理的预定方案切换,即处于 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. 依次前往借助 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 的折扣比例。例如,使用 0.5 表示五折优惠。留存优惠仅支持 relativeDiscount。不支持固定价格 (price)、绝对折扣 (absoluteDiscount) 和免费 (free) 阶段。
  • startTime:可选。符合条件的订阅者可以开始享受留存优惠的时间,采用 RFC 3339 时间戳格式。设置此字段不会激活优惠。如果您未设置此字段,则优惠将根据其状态生效。
  • endTime:可选。挽留优惠停止提供的时间(采用 RFC 3339 时间戳格式),无论优惠处于何种状态。如果您未设置此字段,则优惠没有结束日期。如果您设置了此字段,则该字段必须是将来的时间,且晚于 startTime。

monetization.subscriptions.basePlans.offers.create 方法始终会创建处于 DRAFT 状态的优惠,即使您设置了 startTime 也是如此。如需使优惠生效,请调用 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. 将优惠定位到订阅。使用应用的软件包名称、订阅的 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 方法。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。收到每条通知后,请调用 purchases.subscriptionsv2.get 方法,并传入通知中的 purchaseToken,以获取最新的订阅状态。

接受挽留优惠不会创建新的购买交易。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 商店应用缓存。