在 iOS SDK 中识别用户

如果您有自己的身份验证系统，本指南适合您。在这里，您将学习如何在 Adapty 中管理用户画像，以确保其与您现有的身份验证系统保持一致。

您如何管理用户购买行为取决于您应用的身份验证模式：

如果您的应用不使用后端身份验证且不存储用户数据，请参阅匿名用户相关章节。
如果您的应用已有（或将有）后端身份验证，请参阅已识别用户相关章节。

核心概念：

用户画像 是 SDK 运行所需的实体，由 Adapty 自动创建。
用户画像可以是匿名的 （不含 customer user ID） 或已识别的 （含 customer user ID）。
您提供 customer user ID 以便将 Adapty 中的用户画像与您内部的身份验证系统进行关联。

以下是匿名用户与已识别用户的区别：

	匿名用户	已识别用户
购买管理	通过商店层面恢复购买	通过 customer user ID 跨设备维护购买历史
用户画像管理	每次重新安装创建新用户画像	跨会话和设备使用同一用户画像
数据持久性	匿名用户的数据与应用安装绑定	已识别用户的数据在应用安装间持续保存

匿名用户

如果您没有后端身份验证，无需在应用代码中处理身份验证：

当 SDK 在应用首次启动时激活，Adapty 会为用户创建一个新的用户画像。
当用户在应用内购买任何内容时，该购买会与其 Adapty 用户画像和商店账户相关联。
当用户重新安装应用或在新设备上安装时，Adapty 会在激活时创建新的匿名用户画像。
如果用户之前在您的应用中有过购买，默认情况下，SDK 激活时会自动从 App Store 同步其购买记录。

备份恢复与重新安装的行为不同。默认情况下，当用户从备份恢复时，SDK 会保留缓存数据，不会创建新的用户画像。您可以通过 clearDataOnBackup 设置来配置此行为。了解更多。

对于匿名用户，每次安装都会创建新的用户画像，但这不是问题，因为在 Adapty 分析中，您可以配置什么被视为新安装。

对于匿名用户，您需要通过设备 ID 来统计安装次数。在这种情况下，每次在设备上安装应用都会被计为一次安装，包括重新安装。

已识别用户

您有两种方式在应用中识别用户：

在登录/注册时： 如果用户在应用启动后才登录，请在其完成身份验证时调用 identify() 并传入 customer user ID。
在 SDK 激活时： 如果应用启动时您已有存储的 customer user ID，请在调用 activate() 时传入。

默认情况下，当 Adapty 收到来自某个 Customer User ID 的购买，而该 ID 当前已与另一个 Customer User ID 关联时，访问等级会被共享，即两个用户画像都具有付费访问权限。您可以将此设置配置为将付费访问从一个用户画像转移到另一个，或完全禁用共享。详情请参阅此文章。

在登录/注册时

如果您在应用启动后才识别用户（例如，在用户登录或注册后），请使用 identify 方法设置其 customer user ID。

如果您之前未使用过此 customer user ID，Adapty 会自动将其与当前用户画像关联。
如果您之前已使用此 customer user ID 识别过该用户，Adapty 将切换到与该 customer user ID 关联的用户画像。

每个用户的 customer user ID 必须唯一。如果您将参数值硬编码，所有用户将被视为同一个用户。

do {
    try await Adapty.identify("YOUR_USER_ID") // Unique for each user
} catch {
    // handle the error
}

// User IDs must be unique for each user
Adapty.identify("YOUR_USER_ID") { error in
    if let error {
        // handle the error
    }
}

在 SDK 激活时

如果您在激活 SDK 时已知晓 customer user ID，可以在 activate 方法中直接传入，而无需单独调用 identify。

如果您知道 customer user ID 但仅在激活后才设置，则意味着 Adapty 在激活时会创建一个新的匿名用户画像，只有在您调用 identify 之后才会切换到现有用户画像。

您可以传入现有的 customer user ID（之前使用过的）或新的 customer user ID。如果传入新的，激活时创建的新用户画像将自动与该 customer user ID 关联。

默认情况下，创建匿名用户画像不会影响分析看板，因为安装次数基于设备 ID 统计。

设备 ID 代表从商店在某台设备上安装应用的单次安装，仅在应用重新安装后才会重新生成。它不取决于这是首次还是重复安装，也不取决于是否使用了现有的 customer user ID。

创建用户画像（在 SDK 激活时或退出登录时）、登录或在不重新安装的情况下升级应用，均不会产生额外的安装事件。

如果您希望基于唯一用户而非设备来统计安装次数，请前往 App settings 并配置 Installs definition for analytics。

// Place in the app main struct for SwiftUI or in AppDelegate for UIKit
import Adapty

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
}

// Place in the app main struct for SwiftUI or in AppDelegate for UIKit
import Adapty

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
}

退出登录用户

如果您有退出登录按钮，请使用 logout 方法。

退出登录会为用户创建一个新的匿名用户画像。

do {
    try await Adapty.logout()
} catch {
    // handle the error
}

Adapty.logout { error in
    if error == nil {
        // successful logout
    }
}

要让用户重新登录应用，请使用 identify 方法。

如果您的用户在登录应用之前和之后都可以进行购买，您需要确保他们在登录后仍能保留访问权限：

当未登录用户进行购买时，Adapty 会将其绑定到匿名用户画像 ID。
当用户登录账户时，Adapty 会切换到其已识别的用户画像。
- 如果是新的 customer user ID（例如，购买发生在注册之前），Adapty 会将 customer user ID 分配给当前用户画像，从而保留所有购买历史。
- 如果是已有的 customer user ID（该 customer user ID 已与某个用户画像关联），您需要在用户画像切换后获取实际的访问等级。您可以在识别后立即调用 getProfile，或者监听用户画像更新以自动同步数据。

后续步骤

恭喜！您已在应用中实现了应用内支付逻辑！祝您的应用变现一切顺利！

要从 Adapty 获取更多价值，您可以探索以下主题：

测试：确保一切按预期运行
用户引导：通过用户引导吸引用户并提升留存
集成：只需一行代码即可与营销归因和分析服务集成
设置自定义用户画像属性：为用户画像添加自定义属性并创建市场细分，以便启动 A/B 测试或向不同用户展示不同付费墙

在 iOS SDK 中识别用户

匿名用户

已识别用户

在登录/注册时

在 SDK 激活时

退出登录用户

允许未登录时购买

后续步骤