如果您的网站有问题但没有移动应用,请参阅我们的网页推送故障排除指南。
故障排除步骤
1. 查看设置说明并更新 OneSignal SDK
我们的移动 SDK 设置说明旨在帮助预防常见问题并测试集成。 我们经常发布更新,包含错误修复、改进和对最新操作系统更改的支持。 如果您遇到问题,请首先确保您使用的是我们最新的 SDK 版本并遵循了设置说明。2. 常见故障排除指南
通知未显示或延迟
发送推送通知,但它们未在设备上显示或延迟。
通知图像未显示
通知图像未在通知的展开视图中显示。
通知点击率
通知的点击率低或无点击。
重复通知
通知被多次显示。
应用内消息故障排除
排除应用内消息的常见问题。
3. 测试您 SDK 的示例项目
检查您的问题是否可以使用我们工程团队为每个 SDK 创建的构建来重现。- iOS example project
- Android example project
- Cordova variants example project
- React Native example project
- Flutter example project
- Unity example project
- .NET Maui example project
4. 检查错误日志
在诊断问题之前,收集日志数据很重要:- 遵循我们关于捕获调试日志的指南。
- 查找可能解释该行为的错误、警告或弃用通知。
5. 联系支持
如果您仍有问题:- 联系
support@onesignal.com
并提供:- 您的 OneSignal 应用 ID。
- 您遇到问题的设备的外部 ID 和/或订阅 ID。
- 通知 ID 或 OneSignal 仪表板中通知的链接(如适用)。
- 如果可能,提供设备调试日志重现问题。
常见错误
APNS 委托从未触发
像”Apns Delegate Never Fired”和”APNS 3000”这样的 APNS 错误是 Apple 提供的超时消息,表示设备无法与推送通知所需的 Apple APNS 服务器建立连接。这在以下情况下最常见:- 在 APNS 开发环境中测试
- 如果您将多个推送通知依赖项或原生 iOS 推送 API 与 OneSignal 一起使用
- 临时错误,会在用户下次开始新会话时自动解决(应用失去焦点 30 秒以上,然后再次打开)。
- 移除任何其他推送通知依赖项或原生 iOS 推送 API,仅使用 OneSignal。一旦错误解决,您可以尝试添加回其他代码并联系
support@onesignal.com
获取最佳实践。 - 检查设备调试日志了解更多详情。
- 如果错误持续存在,请按照这些步骤联系支持。
常见问题
如果我在应用中更改 OneSignal 应用 ID 会发生什么?
在您应用的初始化代码中更改 OneSignal 应用 ID 将在用户更新并打开应用到最新版本时在新应用 ID 下创建全新的用户和推送订阅。 如果您的 iOS bundle ID 和/或 Android package ID 相同,那么设备将继续保持相同的推送订阅状态。用户数据将是全新的,即您需要在新记录上重新添加您的别名、标签、电子邮件地址、电话号码。 如果 iOS bundle ID 或 Android package ID 不同,那么这是一个全新的应用,应该有不同的推送证书/密钥。OneSignal 可以在本地部署的封闭网络中发送推送通知吗?
只要您封闭网络上的计算机可以访问您要支持的推送网关服务器,这就可以工作:- https://support.apple.com/en-us/HT203609
- https://firebase.google.com/docs/cloud-messaging/concept-options#messaging-ports-and-your-firewall