---
title: "在 iOS SDK 中识别用户"
description: "用于设置 Adapty 进行应用内订阅管理的快速入门指南。"
---
:::important
如果您有自己的身份验证系统，本指南适合您。在这里，您将学习如何在 Adapty 中管理用户画像，以确保其与您现有的身份验证系统保持一致。
:::
您如何管理用户购买行为取决于您应用的身份验证模式：
- 如果您的应用不使用后端身份验证且不存储用户数据，请参阅[匿名用户相关章节](#anonymous-users)。
- 如果您的应用已有（或将有）后端身份验证，请参阅[已识别用户相关章节](#identified-users)。
**核心概念**：
- **用户画像** 是 SDK 运行所需的实体，由 Adapty 自动创建。
- 用户画像可以是匿名的 **（不含 customer user ID）** 或已识别的 **（含 customer user ID）**。
- 您提供 **customer user ID** 以便将 Adapty 中的用户画像与您内部的身份验证系统进行关联。
以下是匿名用户与已识别用户的区别：
| | 匿名用户 | 已识别用户 |
|-------------------------|---------------------------------------------------|-------------------------------------------------------------------------|
| **购买管理** | 通过商店层面恢复购买 | 通过 customer user ID 跨设备维护购买历史 |
| **用户画像管理** | 每次重新安装创建新用户画像 | 跨会话和设备使用同一用户画像 |
| **数据持久性** | 匿名用户的数据与应用安装绑定 | 已识别用户的数据在应用安装间持续保存 |
## 匿名用户 \{#anonymous-users\}
如果您没有后端身份验证，**无需在应用代码中处理身份验证**：
1. 当 SDK 在应用首次启动时激活，Adapty 会**为用户创建一个新的用户画像**。
2. 当用户在应用内购买任何内容时，该购买会**与其 Adapty 用户画像和商店账户相关联**。
3. 当用户**重新安装**应用或在**新设备**上安装时，Adapty 会**在激活时创建新的匿名用户画像**。
4. 如果用户之前在您的应用中有过购买，默认情况下，SDK 激活时会自动从 App Store 同步其购买记录。
:::note
备份恢复与重新安装的行为不同。默认情况下，当用户从备份恢复时，SDK 会保留缓存数据，不会创建新的用户画像。您可以通过 `clearDataOnBackup` 设置来配置此行为。[了解更多](sdk-installation-ios#clear-data-on-backup-restore)。
:::
对于匿名用户，每次安装都会创建新的用户画像，但这不是问题，因为在 Adapty 分析中，您可以[配置什么被视为新安装](general#4-installs-definition-for-analytics)。
对于匿名用户，您需要通过**设备 ID** 来统计安装次数。在这种情况下，每次在设备上安装应用都会被计为一次安装，包括重新安装。
## 已识别用户 \{#identified-users\}
您有两种方式在应用中识别用户：
- [**在登录/注册时：**](#during-loginsignup) 如果用户在应用启动后才登录，请在其完成身份验证时调用 `identify()` 并传入 customer user ID。
- [**在 SDK 激活时：**](#during-the-sdk-activation) 如果应用启动时您已有存储的 customer user ID，请在调用 `activate()` 时传入。
:::important
默认情况下，当 Adapty 收到来自某个 Customer User ID 的购买，而该 ID 当前已与另一个 Customer User ID 关联时，访问等级会被共享，即两个用户画像都具有付费访问权限。您可以将此设置配置为将付费访问从一个用户画像转移到另一个，或完全禁用共享。详情请参阅[此文章](general#6-sharing-paid-access-between-user-accounts)。
:::
### 在登录/注册时 \{#during-loginsignup\}
如果您在应用启动后才识别用户（例如，在用户登录或注册后），请使用 `identify` 方法设置其 customer user ID。
- 如果您**之前未使用过此 customer user ID**，Adapty 会自动将其与当前用户画像关联。
- 如果您**之前已使用此 customer user ID 识别过该用户**，Adapty 将切换到与该 customer user ID 关联的用户画像。
:::important
客户用户 ID 对每个用户必须是唯一的。如果将该参数值硬编码，所有用户都会被视为同一人。
:::
务必在调用其他 SDK 方法之前 `await` `identify`。并发调用会产生 `#3006 profileWasChanged` 错误或落到匿名用户画像上。详见 [iOS SDK 调用顺序](ios-sdk-call-order)。
```swift showLineNumbers
do {
try await Adapty.identify("YOUR_USER_ID") // 每个用户的 ID 必须唯一
} catch {
// handle the error
}
```
```swift showLineNumbers
// 每个用户的 ID 必须唯一
Adapty.identify("YOUR_USER_ID") { error in
if let error {
// handle the error
}
}
```
### 在 SDK 激活时 \{#during-the-sdk-activation\}
如果您在激活 SDK 时已知晓 customer user ID，可以在 `activate` 方法中直接传入，而无需单独调用 `identify`。
如果您知道 customer user ID 但仅在激活后才设置，则意味着 Adapty 在激活时会创建一个新的匿名用户画像，只有在您调用 `identify` 之后才会切换到现有用户画像。
您可以传入现有的 customer user ID（之前使用过的）或新的 customer user ID。如果传入新的，激活时创建的新用户画像将自动与该 customer user ID 关联。
:::note
默认情况下，创建匿名用户画像不会影响分析看板，因为安装次数基于设备 ID 统计。
设备 ID 代表从商店在某台设备上安装应用的单次安装，仅在应用重新安装后才会重新生成。
它不取决于这是首次还是重复安装，也不取决于是否使用了现有的 customer user ID。
创建用户画像（在 SDK 激活时或退出登录时）、登录或在不重新安装的情况下升级应用，均不会产生额外的安装事件。
如果您希望基于唯一用户而非设备来统计安装次数，请前往 **App settings** 并配置 [**Installs definition for analytics**](general#4-installs-definition-for-analytics)。
:::
```swift showLineNumbers
// Place in the app main struct for SwiftUI or in AppDelegate for UIKit
let configurationBuilder =
AdaptyConfiguration
.builder(withAPIKey: "PUBLIC_SDK_KEY")
.with(customerUserId: "YOUR_USER_ID") // Customer user IDs must be unique for each user. If you hardcode the parameter value, all users will be considered as one.
do {
try await Adapty.activate(with: configurationBuilder.build())
} catch {
// handle the error
}
```
```swift showLineNumbers
// Place in the app main struct for SwiftUI or in AppDelegate for UIKit
let configurationBuilder =
AdaptyConfiguration
.builder(withAPIKey: "PUBLIC_SDK_KEY")
.with(customerUserId: "YOUR_USER_ID") // Customer user IDs must be unique for each user. If you hardcode the parameter value, all users will be considered as one.
Adapty.activate(with: configurationBuilder.build()) { error in
// handle the error
}
```
### 退出登录用户 \{#log-users-out\}
如果您有退出登录按钮，请使用 `logout` 方法。
:::important
退出登录会为用户创建一个新的匿名用户画像。
:::
```swift showLineNumbers
do {
try await Adapty.logout()
} catch {
// handle the error
}
```
```swift showLineNumbers
Adapty.logout { error in
if error == nil {
// successful logout
}
}
```
:::info
要让用户重新登录应用，请使用 `identify` 方法。
:::
### 允许未登录时购买 \{#allow-purchases-without-login\}
如果您的用户在登录应用之前和之后都可以进行购买，您需要确保他们在登录后仍能保留访问权限：
1. 当未登录用户进行购买时，Adapty 会将其绑定到匿名用户画像 ID。
2. 当用户登录账户时，Adapty 会切换到其已识别的用户画像。
- 如果是新的 customer user ID（例如，购买发生在注册之前），Adapty 会将 customer user ID 分配给当前用户画像，从而保留所有购买历史。
- 如果是已有的 customer user ID（该 customer user ID 已与某个用户画像关联），您需要在用户画像切换后获取实际的访问等级。您可以在识别后立即调用 [`getProfile`](ios-check-subscription-status)，或者[监听用户画像更新](ios-check-subscription-status)以自动同步数据。
## 后续步骤 \{#next-steps\}
恭喜！您已在应用中实现了应用内支付逻辑！祝您的应用变现一切顺利！
要从 Adapty 获取更多价值，您可以探索以下主题：
- [**测试**](test-purchases-in-sandbox)：确保一切按预期运行
- [**用户引导**](ios-onboardings)：通过用户引导吸引用户并提升留存
- [**集成**](configuration)：只需一行代码即可与营销归因和分析服务集成
- [**设置自定义用户画像属性**](setting-user-attributes)：为用户画像添加自定义属性并创建市场细分，以便启动 A/B 测试或向不同用户展示不同付费墙