注意：此项目没有可用的旧版文档，因此您看到的是当前文档。
您可以通过重用您的应用已使用的相同 Apple 和 Firebase 凭据，将 iOS 和 Android 应用的推送订阅者从 OneSignal 迁移到 PushEngage。由于设备令牌由 Apple 和 Google 而非 OneSignal 发行，因此保留这些凭据可确保您的令牌在切换后继续有效。本指南将介绍迁移工作原理以及设置步骤。迁移是一个由我们团队共同处理的后端流程。
开始之前
- 在 PushEngage 创建账户。
- 准备好您的 Apple 推送凭据，特别是您的应用推送 ID 和来自 Apple 开发者账户的 p12 证书，与在 OneSignal 中使用的相同凭据。
- 准备好您的 Android Firebase 发送者 ID，与在 OneSignal 中使用的相同 ID。
- 能够访问您的 OneSignal 账户以导出订阅者数据。
应用迁移如何工作
应用推送的设备令牌来自 Apple 推送通知服务 (APNs) 和 Firebase 云消息传递 (FCM)，而非 OneSignal。如果您使用相同的 APNs 和 FCM 凭据配置 PushEngage，您的令牌将保持有效，迁移将在后端进行。通知权限也会一并转移，因此已授予权限的用户无需再次授予。
迁移步骤
步骤 1：从 OneSignal 导出您的订阅者
使用以下任一方法导出您的订阅者数据：
- API 导出，使用您的 OneSignal 应用 ID 和应用 API 密钥。
- CSV 导出，包含
identifier、device_type、language和任何其他相关字段的文件。
步骤 2：在 PushEngage 中配置 Android FCM
- 登录 PushEngage 仪表板。
- 转到 设置 » 安装 » Android SDK。
- 使用您在 OneSignal 中使用的相同 Firebase 发送者 ID 配置 Google Android FCM 设置。
步骤 3：在 PushEngage 中配置 iOS APNs
- 转到 设置 » 安装 » iOS SDK。
- 使用您在 OneSignal 设置中使用的相同应用推送 ID 配置 Apple iOS APNs 设置。
- 上传您 Apple 开发者账户中的 p12 证书，与您在 OneSignal 中使用的相同证书。
关于应用版本切换的重要说明
应用推送迁移取决于订阅者运行的应用版本，因此请仔细规划您的发布切换。
- 使用 OneSignal SDK 的旧版应用。迁移后，仍在使用旧版应用的订阅者将无法接收从 PushEngage 发送的通知，因为 OneSignal SDK 无法解码 PushEngage 的有效负载。
- 使用 PushEngage SDK 的新版应用。迁移后，如果您从 OneSignal 仪表板发送通知，这些通知将不会出现在新版应用中，因为 PushEngage SDK 无法解码 OneSignal 的有效负载。
为新版应用的用户从 PushEngage 发送通知，并期望未更新的用户在升级应用时迁移过来。
常见问题解答
我的应用用户需要再次授予通知权限吗？
否。如果已在您的应用中授予权限，则该权限会一并转移，迁移后无需再次授予。
迁移后，所有订阅者会立即收到通知吗？
在新版应用中使用 PushEngage SDK 的用户将会收到通知。仍在使用旧版应用且使用 OneSignal SDK 的用户在更新应用之前将不会收到 PushEngage 通知。
为什么我需要重用相同的 APNs 和 Firebase 凭据？
因为设备令牌与这些凭据相关联。重用相同的应用推送 ID、p12 证书和 Firebase 发送方 ID 可以使您现有的令牌保持有效，这使得迁移成为可能，而无需要求用户重新注册。
我需要从 OneSignal 导出哪些数据？
可以使用您的 OneSignal 应用 ID 和应用 API 密钥进行 API 导出，或者导出包含至少 identifier、device_type 和 language 以及任何其他相关字段的 CSV 文件。
如果您遇到任何问题，请随时通过单击此处联系我们。我们的支持团队将能够帮助您。
