迁移到流程

在 Adapty 中，流程将用户引导和付费墙合并为一个整体，并通过单一版位进行分发。流程取代了原先需要单独构建和投放的用户引导与付费墙。

本指南介绍迁移到流程后会发生哪些变化，以及如何在不影响旧版本用户的情况下平稳完成切换。

流程 vs. 用户引导和付费墙

使用独立的用户引导和付费墙，你需要维护两个编辑工具和两个版位，还要在自己的代码中处理从用户引导到付费墙的跳转逻辑。

而流程将两者合而为一——引导页、测验和购买页面都在同一个编辑工具中构建，并从同一个版位提供服务。

下表对比了各选项的功能：

是否需要迁移？

如果你是在做长期产品，流程是更好的基础 —— 在合适的发布节点迁移即可。

如何迁移

迁移分四个步骤。大部分工作是一次性的 SDK 升级——构建和预览流程无需编写代码。

1. 构建流程：一键将现有付费墙转换为流程，或从模板创建流程；无需开发者介入。
2. 在设备上预览：通过 Adapty 移动应用在真实设备上查看流程效果；无需构建应用。
3. 为流程创建新版位：创建具有唯一 ID 的新流程版位，并决定其与现有版位的共存方式。
4. 更新 SDK：升级至 Adapty SDK v4，从对应版位获取流程，并验证沙盒购买。这是开发者的主要任务。

构建您的流程

如果您的付费墙是在旧版付费墙编辑工具中构建的，您可以将其转换为流程，而无需手动重新构建。您也可以使用入门模板或从头开始构建流程。了解更多关于流程和付费墙编辑工具的内容：

• 流程编辑工具文档：带您了解编辑工具及其可创建的内容。
• 常见流程示例：最常见页面的分步指南。
• Ask AI：遇到问题时，可使用任意文档页面上的聊天功能。

在设备上预览

你可以在真实设备上预览流程，无需改动应用代码。下载适用于 iOS 或 Android 的 Adapty 移动应用。然后在流程编辑器中点击 Test on device，选择语言区域，用设备扫描二维码即可。这将展示真实的页面、分支逻辑、文案和设计效果。

为您的流程创建新版位

一个版位只能承载一种内容类型——流程、付费墙或用户引导，三者互不兼容。您无法将现有的用户引导版位或付费墙版位转换为流程版位（参见版位类型）。流程需要单独创建新版位。

为新的流程版位指定一个全新且唯一的版位 ID。 该 ID 不能与任何现有付费墙版位或用户引导版位的 ID 重复或复用。

您不必一次性将所有版位都迁移到 flow。在 SDK v4 中，getFlow 方法可以同时从 flow 版位和付费墙版位获取内容，因此您的应用在所有地方都调用同一个方法。可以将付费墙编辑工具中的付费墙保留在原有版位，在其余版位使用 flow。 在过渡期间，每种版位类型会分别追踪各自的数据图表。当新旧两个版本的应用同时运行时，数据会分散到两组版位中：旧版用户引导和付费墙版位涵盖旧版本，新版 flow 版位则对应 SDK v4 及以上版本。建议将这两组数据作为独立的同期群进行比较，随着用户陆续更新，flow 版位的占比将逐步提升。 你可以对流程进行 A/B 测试：在流程版位上针对不同流程实验变体运行常规 A/B 测试。跨版位 A/B 测试目前仅支持付费墙，暂不支持跨流程版位运行。若要将新流程与旧付费墙进行对比，属于同期群对比，而非单一测试——两者分属不同的版位类型。

更新 SDK

流程版位配置完成后，让应用指向它。流程仅在 Adapty SDK v4 及更高版本上渲染。升级 SDK 并通过 getFlow 从新版位获取流程。请参阅适用于您平台的 v4 迁移指南 — iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform 或 Capacitor — 了解具体的升级步骤。

流程接入后，像测试其他购买流程一样进行验证：在设备或模拟器上运行，并完成一次沙盒购买，确认产品、购买和访问等级均正常工作。请参阅对应平台的测试指南：iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform 或 Capacitor。