跳转到主要内容
OneSignal 已从以设备为中心（Player ID）的模型迁移到围绕统一用户概念构建的以用户为中心的模型。本指南介绍了新模型，它与旧方法的不同之处，以及如何安全成功地迁移您的应用。
本指南适用于长期使用 OneSignal 移动 SDK 版本 2、3 或 4，或 Web SDK v15 的客户。如果您是新客户或已迁移到移动 SDK 版本 5 或 Web SDK v16，您可以跳过本指南并转到：
User Model multi-channel illustration

使用用户模型的多渠道消息传递

​
什么是用户模型？

用户模型让您能够针对真实用户在他们订阅的所有消息渠道（移动推送、Web 推送、邮件、短信和应用内）上进行定向，而不是针对单个设备。 每个用户：
  • 拥有一个或多个身份别名（例如 external_id、自定义别名）
  • 可以拥有多个订阅，每个渠道或设备一个
  • 包含标签、语言和活动历史等元数据
此模型简化了受众定向，支持个性化多渠道消息传递，并解锁了历程、用户级分析和实时身份解析等高级功能。
Diagram showing difference between Player and User Models

Player 模型与用户模型对比

​
关键概念

  • 用户
  • 订阅
  • 别名
用户代表真实的人。您可以使用系统生成的或自定义的别名来识别用户。
  • onesignal_id：由 OneSignal 自动生成
  • external_id：通过 SDK login() 或 API 设置（保留别名）
  • 自定义别名：例如 user_id、email、facebook 等
了解更多：用户

​
迁移的好处

  • 统一身份：一个用户跨所有设备和渠道
  • 高级消息传递：强大功能，如历程、应用内登录跟踪和生命周期活动
  • 清晰分段：按标签、订阅状态、渠道参与度等对用户进行分组
  • 简化的 API：更少的端点，更一致的数据模型

​
迁移步骤

用户模型不向后兼容。迁移是从 Player 模型到用户模型的单向操作。迁移前：
  • 在暂存环境中进行彻底测试
  • 仅在所有 SDK 和后端服务更新后才进行迁移
1

使用 external_id 统一用户

使用身份别名将现有的 player 记录链接到统一用户。选项：OneSignal 将自动合并相同外部 ID 下的订阅。
2

更新您的 OneSignal SDK

所有 OneSignal 移动 SDK v5+ 和 Web SDK v16+ 都支持用户模型。使用分阶段部署策略推出 SDK 更新以降低风险：查看下方 SDK 支持表。
3

更新您的后端以使用新的用户 API

将弃用的 Player 模型 API 调用替换为新的用户模型等效调用。使用我们的 API 参考 和下面的表格将旧端点映射到新端点。

​
SDK 支持和迁移指南

  • 移动 SDK
  • Web SDK
  • 后端 SDK
PlatformSDKMigration Guide
Androidv5+Guide
iOSv5+Guide
Unityv5+Guide
Flutterv5+Guide
React Nativev5+Guide
.NET MAUIv5+Guide
有关旧 player 模型方法到新用户模型方法的映射，请参阅移动 SDK 映射。

​
API 参考

​
下一步

  • 📘 查看我们的用户和订阅文档
  • 🛠️ 在上线前更新 SDK 并在暂存环境中测试
  • 💬 需要帮助？联系 support@onesignal.com
您现在已准备好构建由新用户模型支持的个性化多渠道消息传递体验！
⌘I