---
title: "Flutter SDK 中的调用顺序"
description: "按正确顺序调用 Adapty SDK 方法，避免丢失高级访问权限、归因缺失以及间歇性 #2002 错误。"
---

`Adapty().activate()` 必须在调用任何其他 Adapty SDK 方法之前完成。在其完成之前，SDK 没有任何状态。在 `activate()` 之前或与其并行发出的任何调用都会因 [`#2002 notActivated`](error-handling-on-flutter-react-native-unity#custom-network-codes) 错误而失败。
如果你的应用需要用户认证，并在启动后才能获取到 customer user ID，请在获取到后调用 `Adapty().identify()`。在 `identify` 完成之前，不要调用任何用户操作相关的方法。与其并发执行的调用要么会以 [`#3006 profileWasChanged`](error-handling-on-flutter-react-native-unity#custom-network-codes) 失败，要么会作用于激活时创建的匿名用户画像。一旦出现这种情况，归因数据、`appsflyer_id` 等 MMP ID 以及安装归属不一定会迁移到已识别的用户画像上。如果你的应用不需要用户认证，则跳过 `identify`，直接使用匿名用户画像即可。
MMP 和分析类 SDK（AppsFlyer、Adjust、Branch、PostHog）遵循同样的规则。请先初始化它们，等待其 UID 回调后再调用 `Adapty().activate`。否则，MMP ID 会落在一个短暂的匿名用户画像上，不一定能转移到已识别的用户画像中。有关 AppsFlyer 的具体说明，请参阅 [AppsFlyer](appsflyer)。
## 正确的操作顺序 \{#the-correct-order\}

您的路径取决于两件事：何时获取到用户 ID，以及是否使用了 MMP 或分析 SDK。

- **步骤 2 和 5**：每个应用都必须执行。先激活 SDK，再调用 SDK 方法。
- **步骤 1 和 3**：仅在集成 MMP 或分析 SDK（AppsFlyer、Adjust、Branch、PostHog）时需要。
- **步骤 4**：仅在应用需要用户认证，且在启动后才能获取用户 ID 时需要。
如果在应用启动时已知客户用户 ID，可直接在 `activate()` 中传入（步骤 2a）。这样不会创建匿名用户画像，因此无需执行步骤 4。
| 步骤 | 调用 | 时机 | 说明 |
|------|---------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|
| 1    | 初始化你的 MMP 或分析 SDK（AppsFlyer、Adjust、PostHog、Branch）                                                | 应用启动时，最先执行                                                                    | 等待 MMP 的 UID 回调，例如 `getAppsFlyerUID`。                                                 |
| 2a   | `Adapty().activate(configuration: ...)`，且在配置中设置了 `withCustomerUserId`                                 | 应用启动时，步骤 1 之后，如果你已有 customer user ID                                    | 推荐方式。不会创建任何匿名用户画像。                                                            |
| 2b   | `Adapty().activate(configuration: ...)`，未设置 `withCustomerUserId`                                          | 应用启动时，步骤 1 之后，如果你没有 customer user ID（或从不收集）                       | Adapty 会创建一个匿名用户画像。                                                                 |
| 3    | 为每个 MMP 调用 `Adapty().setIntegrationIdentifier(key: ..., value: ...)`                                      | 步骤 2 之后，任何用户操作调用之前                                                        | 必须执行，以确保 MMP ID 关联到正确的用户画像。                                                  |
| 4    | `await Adapty().identify(customerUserId)`                                                                     | 步骤 3 之后（若无 MMP 则在步骤 2 之后），步骤 5 之前——仅在路径 2b 需要身份验证时执行    | 始终使用 `await`。在 `identify` 期间并发调用会产生 `#3006 profileWasChanged` 错误。             |
| 5    | `getPaywall`、`getPaywallProducts`、`restorePurchases`、`makePurchase`、`updateAttribution`、`updateProfile`  | 如果调用了 `identify`，则在步骤 4 之后；否则在步骤 3 之后（若无 MMP 则在步骤 2 之后）   | 这些调用需要一个稳定的用户画像。                                                                |
:::important
跳过这些步骤会导致回归用户丢失高级访问权限、用户画像中缺少 `appsflyer_id`，以及付费墙针对错误目标受众返回内容。
:::
## Web2app 与 Web 漏斗安装 \{#web2app-and-web-funnel-installs\}

如果用户在 Web 结账页面（Stripe、Paddle）完成购买后再安装原生应用，设备首次调用 `activate()` 时会创建一个新的匿名用户画像，该画像不会与 Web 端的用户画像关联。如果你能在应用启动前（通过认证流程或安装来源追踪）获取到 customer user ID，可以直接将其传入 `activate()`。否则，在你调用 `identify("YOUR_USER_ID")` 并执行 `restorePurchases` 之前，设备端将无法看到 Web 端的购买记录。

关于每次 Web 结账时需要传递的元数据，请参阅：

- [Stripe](stripe)
- [Paddle](paddle)