退款拯救器

每当用户申请退款时，Apple 都会进行调查。为了判断退款是否合理，它会向开发者索取该用户的活动信息。如果没有这些证据，即使是使用频率很高的订阅也很可能被退款。

Refund Saver 会自动响应 Apple 的消费信息请求，保护您的收入，并提高不合理退款请求被拒绝的概率。它适用于所有 Apple 应用内购买类型——自动续订订阅、一次性订阅、消耗型商品及非消耗型商品（包括永久授权产品）。

Refund Saver dashboard chart showing refund metrics

退款拦截器的工作原理

当用户发起退款请求时，App Store 会发送通知，要求提供交易和使用详情。

如果您忽略或延迟响应，Apple 很可能会批准退款。
Adapty 退款拦截器会自动处理这些通知，向 Apple 提供所需数据。

这一自动化机制能够减少不必要的退款，同时节省时间并保护您的收益。
Adapty 会记录每次结果——退款成功或拒绝退款。这些数据将驱动看板中的退款拦截器分析报告。

通过 Refund Saver，您最多可以挽回退款请求中 40% 的收入。

使用 Refund Saver 的前提条件

要使用此功能，请确保满足以下前提条件：

在 App Store Connect 中更新您的隐私政策： 您的应用隐私政策必须披露消费数据的收集和使用方式，确保用户在下载前了解您应用的隐私实践。请参阅 Apple 的应用隐私详情获取指导。
在您的应用中获取用户对数据共享的同意： Apple 要求您在将用户个人数据共享给 Apple 之前，必须获得用户的有效同意。作为开发者，您负责获取此同意，因为数据共享由您发起。详情请参阅 Apple 的指导方针。
启用 Server Notifications V2： 请确保在您的 Apple Developer 账户中已激活 Server Notifications V2，并已在 Adapty 中正确配置，因为不支持 V1 通知。如果尚未激活，请按照启用 App Store 服务器通知指南中的步骤操作。

开启 Refund Saver

在 Adapty 看板中打开 Refund Saver 部分。

点击 Turn on Refund Saver 以激活该功能。

设置默认退款行为

Apple 允许开发者在响应退款请求时，为每条请求指定一个倾向性处理结果。此设置的目的是在拒绝和接受退款请求之间找到合理的平衡，确保只批准合理的退款。请注意，该设置仅用于影响处理结果，最终决定权仍归 Apple 所有。

Adapty 支持设置此偏好项，但我们会对所有退款请求使用同一个值。

若需更改偏好设置，请点击 Edit refund preference。
在 Edit refund preference 窗口中，选择您的 Default refund request preference 选项：

选项	描述
Always decline	（默认）这是默认选项，通常在减少退款方面效果最佳。
Decline first refund request, grant all next	对于 Refund Saver 遇到的每笔交易，系统最初会请求 Apple 拒绝退款。但如果同一笔交易再次出现，Refund Saver 将始终建议批准退款。这种方式有助于减少用户因退款被不公平拒绝而产生的不满——用户只需再次申请退款，通常就能成功。
Always refund	建议 Apple 批准所有退款申请。
No preference	不向 Apple 提供任何建议。在这种情况下，Apple 将根据其内部政策和用户历史记录自行决定退款结果，不受您设置的影响。此选项是最中立的处理方式。

在看板中为特定用户设置退款行为

即使您已为整个应用配置了默认的 Refund Saver 行为，也可以为特定用户单独设置偏好。在 Adapty 看板中，您可以从用户的用户画像页面进行操作。请使用左下角的 Refund Saver Preferences 部分。

单用户偏好设置会覆盖应用级别的默认设置，包括”拒绝首次退款请求，允许后续所有请求”的行为。

在 SDK 中为特定用户设置退款行为

您可以在应用代码中，根据用户的具体操作，为每次安装单独设置退款偏好。使用以下代码片段来设置偏好：

do {
  try await Adapty.updateRefundPreference(<PREFERENCE_VALUE>) // possible values: .noPreference, .grant, .decline
} catch {
  // handle the error
}

try {
  // possible values: AdaptyRefundPreference.noPreference, AdaptyRefundPreference.grant, AdaptyRefundPreference.decline
  await Adapty().updateRefundPreference(<PREFERENCE_VALUE>);
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle the error
}

try {
    await adapty.updateRefundPreference(<PREFERENCE_VALUE>); // possible values: RefundPreference.NoPreference, RefundPreference.Grant, RefundPreference.Decline
} catch (error) {
    // handle the `AdaptyError`
}

Adapty.UpdateAppStoreRefundPreference(<PREFERENCE_VALUE>, (error) => {
  if (error != null) {
    // handle the error
    return;
  }
});

您也可以使用服务器端 API 来设置单独的退款偏好：

当偏好设置与客户端交互直接相关时（例如用户点击按钮来配置偏好），请使用 SDK。
当需要进行服务器端处理，或与您的应用架构更契合时，请使用 API。

如何收集用户的数据共享同意由你自行决定，但 Apple 要求在向其共享任何个人数据之前必须获得有效的用户同意。Apple 建议采用**选择加入（opt-in）**的方式，即通过应用内弹窗说明数据的使用方式，并要求用户明确操作以表示同意。如果用户忽略或拒绝了弹窗，则视为未同意。更多详情请参阅 Apple 的使��指南。

如果在您的应用中显式征得用户同意不太可行，可以考虑采用选择退出方式。这种方式需要在服务条款中加入数据共享条款，说明用户通过接受条款即表示同意数据共享。请务必清楚说明用户如何撤销其同意。

以下是选择退出方式的示例条款，包含您可能共享的数据类型。这仅供参考，用于帮助您起草自己的文本。您有责任确保最终版本符合所有适用法律及 Apple 的要求。

“如果我们收到应用内购买的退款请求，可能会向 Apple 提供该用户的应用内购买活动信息。这可能包括：距应用安装的时间、应用总使用时长、匿名账户标识符、应用内购买是否已完全消费、是否包含试用期、总消费金额以及总退款金额。”

根据您选择的方案，在 Edit refund preferences 菜单中设置 Default consent policy 选项：

选项	描述
Opt-out	（默认）如果 Adapty 不知道用户的同意状态，则假定用户已授权，退款保护功能将向 Apple 共享退款相关数据。
Opt-in	如果 Adapty 不知道用户的同意状态，则假定用户未授权，退款保护功能不会向 Apple 共享任何数据。这是 Apple 推荐的方式。

如需告知 Adapty 某个用户是否已提供同意，请使用 updateCollectingRefundDataConsent 方法。该值会按用户画像持久化存储在服务端，因此只需在同意状态发生变化时调用此方法。

do {
 try await Adapty.updateCollectingRefundDataConsent(<CONSENT_VALUE>) // true = 明确提供同意，false = 明确撤销同意
} catch {
 // handle the error
}

try {
  // true = user gave consent, false = user revoked consent
  await Adapty().updateCollectingRefundDataConsent(<CONSENT_VALUE>);
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle the error
}

try {
    await adapty.updateCollectingRefundDataConsent(<CONSENT_VALUE>); // true = 明确提供同意，false = 明确撤销同意
} catch (error) {
    // 处理 `AdaptyError`
}

Adapty.UpdateAppStoreCollectingRefundDataConsent(<CONSENT_VALUE>, (error) => {
  if (error != null) {
    // 处理错误
    return;
  }
});

您也可以使用服务端 API 来设置个人数据共享偏好：

当偏好设置与用户操作直接相关时（例如用户点击按钮进行配置），请使用 SDK。
当需要进行服务端处理，或更符合您的应用架构时，请使用 API。

您可以随时查看用户当前的同意状态。在 Adapty 看板中，打开用户画像，在左下角的 Refund Saver Preferences 区域找到 Allow data sharing 设置即可。

您也可以使用服务端 API 获取单个用户的退款和数据共享偏好设置。

限制

仅限 Apple App Store： Refund Saver 仅适用于向 Apple App Store 提交的退款申请。Google Play 不提供针对退款的消费数据分析。Google Play 上的退款决策完全基于 Google 的政策及用户提供的信息。
需要 Server Notifications V2： Refund Saver 与 App Store Server Notifications V1 不兼容。如果您目前在 Adapty 中使用的是 V1，需要切换至 V2，请参阅向 Adapty 发送 App Store 服务器通知指南了解详情。切换至 V2 还能为 Adapty 提供更准确、更全面的数据，从而提升您的分析质量。

退款拯救器

退款拦截器的工作原理

使用 Refund Saver 的前提条件

开启 Refund Saver

设置默认退款行为

在看板中为特定用户设置退款行为

在 SDK 中为特定用户设置退款行为

获取用户同意

在 SDK 中更新用户同意状态

检查用户同意状态

限制