- 用户必须安装您的移动应用程序
- 您必须配置正确的平台凭据（Android 的 FCM、iOS 的 APNs、Huawei 的 HMS、Amazon 的 ADM）
- 用户必须授予接收通知的权限
SDK 设置和迁移
将 OneSignal SDK 集成到您的应用中以注册设备并启用推送消息传递。如果您正在从其他提供商迁移，OneSignal 支持从 Firebase、Airship、Braze 等迁移。推送权限提示
移动平台要求用户在接收推送通知之前选择加入。Apple 的人机界面指南建议描述您想要发送的信息类型，并为用户提供明确的选择加入或退出方式。 您可以使用 OneSignal 的应用内消息构建预权限提示，在触发系统提示之前向用户解释价值。
用户和订阅
SDK 激活后，OneSignal 会在用户打开您的应用时自动创建用户和订阅记录。 移动订阅在用户执行以下操作时创建：- 在设备上首次打开应用
- 卸载并重新安装应用，然后再次打开应用
OneSignal.login 为其分配外部 ID 之前保持匿名。
设计推送通知
制作有效的推送通知不仅仅是写文本。观看如何让每条推送通知发挥最大效果，然后探索以下设计元素。
- 标题：吸引注意力的标题（建议：低于 50 个字符）
- 消息：主要通知内容（建议：低于 120 个字符）
- 图标：您的品牌图标或通知特定图像
- 大型图像：引人注目的视觉内容
- 操作按钮：行动召唤按钮
- 接收推送时的时间戳
- 应用名称：您应用的名称
个性化和本地化
观看如何将普通推送通知转变为高性能消息，然后探索以下个性化选项。配置推送行为
控制您的通知在发送后的行为，包括时间、显示设置和用户交互。投递、显示和关闭设置
限速
控制大量受众的通知投递速度。
频率上限
设置限制以防止向同一用户过度发送通知。
生存时间 (TTL)
定义在设备离线时推送服务保留消息的时间。
合并 ID
用更新的消息替换之前的消息以减少通知杂乱。
Android 通知类别
控制重要性级别（横幅、静音）和其他显示方面。
iOS 专注模式和中断级别
控制 iOS 的优先级（被动、时间敏感）。
通知声音
为每个平台配置通知音频。
角标
管理 iOS 上的应用图标角标计数行为。
数据和后台通知
在推送负载中包含自定义数据，您的应用可以在不显示可见通知的情况下处理这些数据。点击行为和深度链接
控制用户点击通知时发生的情况。URL、链接和深度链接
使用深度链接和跟踪 URL 将用户路由到相关内容或页面。
深度链接
特定平台的深度链接实现详情。
操作按钮
让用户从您的通知中立即采取行动。
通知事件观察者
监听点击事件并使用自定义代码触发应用内行为。
分析和故障排除
测量通知性能并解决常见的投递问题。推送消息报告
查看每条消息的投递、打开率和点击率指标。
分析概述
探索跨渠道的参与度和用户行为指标。
通知未显示或延迟
消息未在设备上显示的故障排除清单。
通知图像未显示
修复各平台的图像渲染问题。
重复通知
排查为什么显示重复通知。
下一步
常见问题
用户需要选择加入才能接收推送通知吗？
是的。iOS 和 Android 都要求用户在接收推送通知之前授予权限。在 iOS 上，您必须显示系统提示。在 Android 13+ 上，需要POST_NOTIFICATIONS 权限。在触发系统对话框之前，使用预权限提示向用户解释价值。