---
title: "迁移到流程"
description: "将独立的用户引导和付费墙合并到一个 Adapty 流程中——了解具体变化，以及如何在不影响旧版本用户的情况下平稳上线。"
---

在 Adapty 中，*流程*将用户引导和付费墙合并为一个整体，统一挂载到同一个版位下。流程取代了原先需要分别构建和投放的独立用户引导和付费墙。
本指南介绍迁移到流程后会发生哪些变化，以及如何在不影响旧版应用用户的情况下平稳推进迁移。

:::important
目前流程仅支持 iOS SDK v4 及以上版本。其他平台和框架的支持即将推出。
:::
## 流程 vs. 用户引导和付费墙 \{#flows-vs-onboardings-and-paywalls\}

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

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

下表对比了各选项的功能：
| | 流程 | 付费墙编辑工具付费墙 | 用户引导 |
|---|---|---|---|
| 多屏幕支持 | 是 | 否——单屏幕 | 是 |
| 渲染方式 | 原生 | 原生 | WebView |
| 产品与版位 | 一个版位；直接在流程中添加产品 | 一个版位；直接在付费墙中添加产品 | 一个版位，但本身不含产品——如需销售，需单独创建付费墙并通过独立版位提供 |
## 是否需要迁移？\{#should-you-migrate\}

您现有的用户引导和付费墙仍可正常运行，Adapty 也会继续为其提供支持。但新功能将优先面向流程发布，而不再针对独立的用户引导和付费墙编辑工具。

**如果您着眼于长期开发，流程是更好的基础** — 请在合适的发版节点迁移至流程。
## 如何迁移 \{#how-to-migrate\}

迁移分四个步骤。大部分工作是一次性的 SDK 升级——构建和预览流程无需编写代码。
1. **[构建您的流程](#build-your-flow)**：在无代码编辑器中创建流程，无需开发人员参与。
2. **[在设备上预览](#preview-on-device)**：通过 Adapty 移动应用在真实设备上查看流程效果，无需构建应用。
3. **[为您的流程创建新版位](#create-a-new-placement-for-your-flow)**：创建一个具有唯一 ID 的新流程版位，并决定它与现有版位的共存方式。
4. **[更新 SDK](#update-the-sdk)**：升级至 iOS SDK v4，从版位获取流程，并验证沙盒购买。这是开发人员的主要工作。
### 搭建你的流程 \{#build-your-flow\}

在 **Flows** 页面，点击 **Create flow** 开始搭建，将用户引导和付费墙整合为一体。了解更多关于编辑工具的内容：

- **[Flows 文档](adapty-flow-builder)**：带你了解编辑工具及其功能。
- **[常用流程配方](flow-builder-recipes)**：最常见页面的分步操作指南。
- **Ask AI**：遇到问题时，使用任意文档页面上的对话框寻求帮助。
:::note
从现成流程模板构建流程或使用 AI 生成流程的功能尚不可用——这两项功能即将推出。目前，每个新流程都会从几个常用屏幕开始，你可以根据需要对其进行编辑和调整。
:::
### 在设备上预览 \{#preview-on-device\}

无需修改应用，即可在真实设备上预览流程。从 App Store 下载 [Adapty 应用](https://apps.apple.com/us/app/adapty/id6739359219)，然后在流程编辑器中点击 **Test on device**，选择语言区域并用设备扫描二维码，即可看到真实的页面、分支逻辑、文案和设计效果。

:::note
在预览模式下，Adapty 无法访问应用商店中的产品，因此预览中显示的价格并非真实价格。真实购买需在集成了 v4 版本 SDK 的构建包中使用沙盒账号进行验证——详见[更新 SDK](#update-the-sdk)。
:::

### 为您的流程创建新版位 \{#create-a-new-placement-for-your-flow\}

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

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

:::warning
过渡期间请保留旧版位
使用旧版应用的用户，其 onboarding 和付费墙版位 ID 已编译进应用中。他们仍会调用 onboarding 和付费墙方法，并看到你现有的 onboarding 和付费墙，直到他们更新应用。请等到 SDK v4 的采用率足够高后，再停用旧版位。
:::

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

流程版位准备好之后，将应用指向它。Flow 仅在 Adapty SDK v4 及更高版本上渲染。升级 SDK 并使用 `getFlow(placementId:)` 从新版位获取 flow。具体升级步骤请参阅 [iOS SDK v4 迁移指南](migration-to-ios-sdk-v4)。

Flow 接入完成后，像验证其他购买流程一样验证它：在设备或模拟器上运行，并进行一次[沙盒购买](ios-test)，确认产品、购买操作和访问等级均正常工作。
:::note
用户只有在安装了基于 SDK v4+ 构建的应用后才能看到流程。使用旧版应用的用户仍会看到原有的用户引导和付费墙，这也是为什么在过渡期间旧版版位需要保持运行的原因。对于尚不支持流程的平台，情况同样如此。
:::