文档中心

功能说明

在实际接入和使用过程中，我们常常遇到设备收不到推送消息的问题，除了已经提供的帮助文档 Android常见问题 和 服务端常见问题之外，平台还提供了查询推送事件功能，在对特定设备进行标注后，该设备的后续相关推送事件会被记录，并可以在平台展示，方便开发者排查使用中遇到的问题。

使用步骤

添加测试设备

1. 选择需要排查的应用，左侧菜单进入选择“查询推送事件页面”，下方“测试设备”一栏，点击“添加设备按钮”按钮。 
2. 选择根据push_id 或 cuid添加设备

push_id 是百度移动推送平台设备端的设备唯一标识 ，获取方式见 获取设备信息客户端文档

进行推送相关操作

手机被标记为测试设备后，需等待一分钟左右等待缓存生效，之后您可以进行发送单播消息、设备上线(打开应用)和设备下线(应用强停)等操作。

查看设备事件

进行推送相关操作后，可以在“查询推送事件-事件查询”，选择合适的时间范围同时选择想要查看推送事件的设备，下方会按时间倒序展示相关事件，方便开发者进行后续排查。

问题排查

根据推送事件，一般可以定位到问题。

常见问题主要包括：

• 发送消息没有“消息预计下发”事件： 所发送的设备id非法，发消息时系统未查询到您选择的设备
• 发送自有通道消息，有“消息预计下发”事件，没有“消息下发”事件：主要原因可能为设备当前不在线

• 发送厂商通道消息，有“消息预计下发”事件，没有“消息下发”事件：主要原因可能为

  1. 设备通知栏权限未打开
  2. 在百度app推送平台填写的厂商通道配置有误，或消息不符合厂商规范，导致平台调用厂商接口失败

• 发送厂商通道消息，有“消息预计下发”和“消息下发”事件，没有“消息到达”事件：主要原因可能为

  1. 厂商通道过滤了您发送的消息，导致没有实际下发到手机，请参考 厂商通道使用教程 排查您的消息

如您的问题不属于上述问题的任何一类，您可以提交工单，提供appkey 和push_id，平台工作人员会协助排查问题

事件类型说明

事件类型主要包括：

• 设备上线：推送SDK 建立推送长连接，主要场景是应用打开
• 设备离线：推送SDK 断开推送长连接，主要场景是应用强停
• 消息预计下发：查找到了您希望发送的设备，将进行推送
• 消息下发：消息进行了推送
• 消息到达：消息到达设备客户端
• 厂商通道消息点击：厂商通道消息被点击
• 自有通道点击：自有通道消息被点击