迁移到流程
在 Adapty 中,流程将用户引导和付费墙合并为一个整体,统一挂载到同一个版位下。流程取代了原先需要分别构建和投放的独立用户引导和付费墙。 本指南介绍迁移到流程后会发生哪些变化,以及如何在不影响旧版应用用户的情况下平稳推进迁移。
目前流程仅支持 iOS SDK v4 及以上版本。其他平台和框架的支持即将推出。
流程 vs. 用户引导和付费墙
使用独立的用户引导和付费墙,你需要维护两个编辑工具和两个版位,还要在自己的代码中处理从用户引导到付费墙的跳转逻辑。
而流程将两者合而为一——引导页、测验和购买页面都在同一个编辑工具中构建,并从同一个版位提供服务。
下表对比了各选项的功能:
| 流程 | 付费墙编辑工具付费墙 | 用户引导 | |
|---|---|---|---|
| 多屏幕支持 | 是 | 否——单屏幕 | 是 |
| 渲染方式 | 原生 | 原生 | WebView |
| 产品与版位 | 一个版位;直接在流程中添加产品 | 一个版位;直接在付费墙中添加产品 | 一个版位,但本身不含产品——如需销售,需单独创建付费墙并通过独立版位提供 |
是否需要迁移?
您现有的用户引导和付费墙仍可正常运行,Adapty 也会继续为其提供支持。但新功能将优先面向流程发布,而不再针对独立的用户引导和付费墙编辑工具。
如果您着眼于长期开发,流程是更好的基础 — 请在合适的发版节点迁移至流程。
如何迁移
迁移分四个步骤。大部分工作是一次性的 SDK 升级——构建和预览流程无需编写代码。
- 构建您的流程:在无代码编辑器中创建流程,无需开发人员参与。
- 在设备上预览:通过 Adapty 移动应用在真实设备上查看流程效果,无需构建应用。
- 为您的流程创建新版位:创建一个具有唯一 ID 的新流程版位,并决定它与现有版位的共存方式。
- 更新 SDK:升级至 iOS SDK v4,从版位获取流程,并验证沙盒购买。这是开发人员的主要工作。
搭建你的流程
在 Flows 页面,点击 Create flow 开始搭建,将用户引导和付费墙整合为一体。了解更多关于编辑工具的内容:
从现成流程模板构建流程或使用 AI 生成流程的功能尚不可用——这两项功能即将推出。目前,每个新流程都会从几个常用屏幕开始,你可以根据需要对其进行编辑和调整。
在设备上预览
无需修改应用,即可在真实设备上预览流程。从 App Store 下载 Adapty 应用,然后在流程编辑器中点击 Test on device,选择语言区域并用设备扫描二维码,即可看到真实的页面、分支逻辑、文案和设计效果。
在预览模式下,Adapty 无法访问应用商店中的产品,因此预览中显示的价格并非真实价格。真实购买需在集成了 v4 版本 SDK 的构建包中使用沙盒账号进行验证——详见更新 SDK。
为您的流程创建新版位
一个版位只能承载一种内容类型——流程、付费墙或用户引导,三者互不兼容。您无法将现有的用户引导版位或付费墙版位转换为流程版位(参见版位类型)。流程需要单独创建新版位。
为新的流程版位指定一个全新且唯一的版位 ID。 该 ID 不能与任何现有付费墙版位或用户引导版位的 ID 重复或复用。
过渡期间请保留旧版位 使用旧版应用的用户,其 onboarding 和付费墙版位 ID 已编译进应用中。他们仍会调用 onboarding 和付费墙方法,并看到你现有的 onboarding 和付费墙,直到他们更新应用。请等到 SDK v4 的采用率足够高后,再停用旧版位。
您无需一次性将所有版位都迁移到流程。在 iOS SDK v4 中,getFlow 方法可以同时从流程版位和付费墙版位获取内容,因此您的应用在所有地方都调用同一个方法。将付费墙编辑工具构建的付费墙保留在您希望使用的版位,其余版位使用流程即可。
在过渡期间,每种版位类型会分别追踪各自的数据图表。当新旧两个版本的应用同时运行时,数据会分散到两组版位中:旧版用户引导和付费墙版位涵盖旧版本,新版 flow 版位则对应 SDK v4 及以上版本。建议将这两组数据作为独立的同期群进行比较,随着用户陆续更新,flow 版位的占比将逐步提升。
你可以对流程进行 A/B 测试:在流程版位上针对不同流程实验变体运行常规 A/B 测试。跨版位 A/B 测试目前仅支持付费墙,暂不支持跨流程版位运行。若要将新流程与旧付费墙进行对比,属于同期群对比,而非单一测试——两者分属不同的版位类型。
更新 SDK
流程版位准备好之后,将应用指向它。Flow 仅在 Adapty SDK v4 及更高版本上渲染。升级 SDK 并使用 getFlow(placementId:) 从新版位获取 flow。具体升级步骤请参阅 iOS SDK v4 迁移指南。
Flow 接入完成后,像验证其他购买流程一样验证它:在设备或模拟器上运行,并进行一次沙盒购买,确认产品、购买操作和访问等级均正常工作。
用户只有在安装了基于 SDK v4+ 构建的应用后才能看到流程。使用旧版应用的用户仍会看到原有的用户引导和付费墙,这也是为什么在过渡期间旧版版位需要保持运行的原因。对于尚不支持流程的平台,情况同样如此。