从 RevenueCat 迁移到 openpurr,不流失任何订阅用户
继续使用你的 App 已集成的 Purchases SDK。从 RevenueCat 的导出文件导入现有客户:openpurr 会自己从 Apple 和 Google 获取每一笔购买。在用户陆续更新期间,旧版 App 也能继续正常使用。
更新于
简而言之
- openpurr 是自托管、开源的 RevenueCat 替代方案,兼容官方、未经修改的 RevenueCat Purchases SDK。
- 你的 App 只需添加一行代码(SDK 的代理 URL)和一次性的
syncPurchases调用,其余购买代码保持不变。 openpurr import从 RevenueCat 的导出文件导入现有客户。购买记录本身从 Apple 和 Google 获取,而不是复制过来。- App Store 的 App 可以使用 RevenueCat 的 Scheduled Data Export。Google Play 需要向 RevenueCat Support 申请迁移导出文件,只有它包含购买令牌(purchase token)。
- 在大多数用户更新 App 之前,两个后端都会保持同步,因此不会有人失去访问权限。
- 使用 Cloudflare 免费套餐时,导入每天可处理约 2,500 位客户。使用 Workers Paid 时,大规模导入只需几个小时。
RevenueCat 迁移是如何进行的
openpurr 不会从 RevenueCat 复制购买记录。它只需要知道谁拥有哪一笔购买,然后向商店查询,和你的 App 上报购买时的做法完全一样。
导入
RevenueCat 的导出文件记录了哪位 App 用户拥有哪一笔商店购买。openpurr import 会向 Apple 和 Google 查询每一笔购买,并把商店返回的结果记录到该用户名下。它一次性迁移所有人,包括再也不会打开 App 的用户。
App 更新
新版 App 把 Purchases SDK 指向 openpurr,并通过 syncPurchases 把每位客户的购买记录发送一次。这样可以覆盖导出文件遗漏的用户,以及在导出之后才购买的用户。
两个后端并行一段时间
在用户更新之前,旧版 App 会继续与 RevenueCat 通信。RevenueCat 会把 Apple 的通知转发给 openpurr,再加一个 Pub/Sub 订阅为 Google 做同样的事,两个后端因此都保持最新。
你的 App 需要改什么
在 configure 之前设置代理 URL,并把每位客户的购买记录发送一次。同样的两处改动也适用于 Android、Flutter 和 React Native,指南中有各平台的代码。
// 在 configure() 之前:大多数 App 只需加这一行
Purchases.proxyURL = URL(string: "https://purchases.example.com")!
Purchases.configure(withAPIKey: "appl_…")
// 每次安装执行一次:把该客户的购买记录发送到 openpurr
let synced = "openpurr.synced"
if !UserDefaults.standard.bool(forKey: synced) {
Purchases.shared.syncPurchases { _, error in
if error == nil { UserDefaults.standard.set(true, forKey: synced) }
}
}从 RevenueCat 导入客户
openpurr CLI 直接读取 RevenueCat 导出的各列:App User ID、App Store 交易 ID、Google Play 购买令牌,以及 $email 等属性。
npm install -g @openpurr/cli
openpurr login --url https://<your back office>
# 先检查前几行:会查询 Apple 和 Google,但不写入任何数据
openpurr import revenuecat-export.csv --dry-run --limit 50
# 导入所有人。可随时停止,再次运行即可继续。
openpurr import revenuecat-export.csv不会有人失去访问权限
App 已经为某位客户发送过的购买仍归该客户所有,导入永远不会移动它。
不会重复发送 Webhook
导入的购买不是新购买,因此 openpurr 不会为它们发送事件。
图表数据真实
导入的客户按首次购买日期计算,不会在导入当天被算作新客户。
你的 App 照常运行
使用 Cloudflare 免费套餐时,导入会在达到每日限额的 90% 时停止,并在第二天继续。
可停止、可恢复
进度会被保存。同一行导入两次不会产生任何变化,因此可以用更新的导出文件再运行一次。
先试运行
试运行(dry run)会查询商店并报告将会发生什么,但不写入任何数据。
从 RevenueCat 迁移的七个步骤
在你准备好切换之前,两个后端都会持续运行,因此使用旧版 App 的客户不会失去访问权限。
部署 openpurr
把 openpurr Lite 部署到你的 Cloudflare 账号,为它开通 App Store 和 Google Play 的 API 访问权限,并用相同的标识符重新创建产品、权益和 Offering。你甚至可以继续使用 RevenueCat 的公开 SDK 密钥。
让两个后端都收到通知
把 openpurr 设为 RevenueCat 的 Apple Server Notification Forwarding URL,并在你的 Play 通知主题中添加 openpurr 的推送订阅。
获取导出文件
只有 App Store:RevenueCat 的 Scheduled Data Export 就包含所需数据。如果有 Google Play,请向 RevenueCat Support 申请迁移导出文件,因为只有它包含购买令牌。指南中有一份可以直接复制的申请模板。
导入
运行
openpurr import,先进行一次试运行。单行出现的问题会写入报告,不会中断导入。发布 App 更新
添加代理 URL 和一次性的
syncPurchases调用。等导入完成后再发布。检查
openpurr doctor会检查配置。查一查你认识的客户,并把活跃订阅数与 RevenueCat 的图表进行对比。完成切换
等大多数客户更新之后,把 Apple 和 Google 直接指向 openpurr,开启 openpurr 的 Webhook,并关闭 RevenueCat 的 Webhook。
哪些内容会从 RevenueCat 迁移过来,哪些不会
| 订阅和购买,包括续订、退款、宽限期和到期 | 会,从 Apple 和 Google 获取 |
|---|---|
| 谁拥有哪一笔购买 | 会,来自 RevenueCat 的导出文件 |
| App User ID,包括匿名 ID | 会,保持不变 |
| 客户属性($email、$displayName 和你自定义的属性) | 会,来自 Audience export |
| 产品、权益和 Offering | 需要你用相同的标识符重新创建 |
| 切换前的图表历史 | 部分迁移:请保留 RevenueCat 的图表 CSV 作为存档 |
| 付费墙、实验、集成、Customer Center | 不会:openpurr 没有这些功能 |
RevenueCat 迁移常见问题
我需要修改购买代码吗?
不需要。openpurr 兼容官方、未经修改的 RevenueCat Purchases SDK。App 更新只需在 configure 之前添加代理 URL,并调用一次 syncPurchases。getOfferings、purchase、restorePurchases、logIn 等其余代码都保持不变。
迁移需要 RevenueCat 的协助吗?
App Store 的 App 不需要:RevenueCat 的 Scheduled Data Export 包含 openpurr 所需的交易 ID。Google Play 则需要:根据 RevenueCat 的文档,只有 RevenueCat Support 准备的迁移导出文件才包含 Google 要求的购买令牌。
从不更新 App 的客户怎么办?
导入会覆盖他们:他们的购买会从 Apple 和 Google 获取,并关联到相同的 App User ID。在他们仍使用旧版 App 期间,旧版会与 RevenueCat 通信,所以在大多数用户更新之前,两个后端都会保持同步。
导入需要多长时间?
每位客户大约需要写入 30 行数据库记录。使用 Cloudflare 免费套餐时,每天约可处理 2,500 位客户,导入会在达到每日限额时自动暂停,并在第二天继续。使用 Workers Paid(每月 5 美元)时,大规模导入只需几个小时。
我的数据是从 RevenueCat 复制过来的吗?
只复制 App 用户与商店购买之间的对应关系,如果你选择导入,还包括客户属性。购买记录本身直接来自 Apple 和 Google,因此 openpurr 记录的是商店当前的真实状态,包括续订和退款。
