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