极光消息推送排查工具操作教程-APP开发

极光消息推送排查工具操作教程

2022年12月22日下午3:01 • 极光推送

极光消息推送排查工具操作教程

排查工具包括消息查询和配额查询功能，通过查看消息的生命周期和厂商额度来判断消息是否正常下发，旨在帮助客户快速排查问题。

消息查询

推送收不到时，可以进入【极光控制台】-【消息推送】-【配置管理】-【排查工具】-【消息查询】页面进行生命周期排查，输入 Message ID 和 Registration ID，点击查询即可查看消息的生命周期，查询结果如下图：

消息生命周期：如果发送失败，会在相应的失败环节展示错误码+错误提示信息。
特殊消息生命周期：如果消息类型为通知消息+自定义消息，则消息生命周期会产生两条分叉路径。
消息基本信息：展示消息类型、发送策略和消息体，点击消息体可以查看消息体 json。
设备基本信息：展示通知权限开关状态、厂商注册情况、最近在线时间等设备基本信息。

Message ID 获取方法

控制台获取

进入【极光控制台】-【消息推送】-【推送管理】-【推送记录】页面，即可获取 Message ID。

API 获取

API 调用后在应答参数中获取：

          {
    "sendno": "0",
    "msg_id": "54043471036732219"
}

Registration ID 获取方法

客户端初始化 JPush 成功后，JPush 服务端会分配一个 Registration ID，作为此设备的标识（同一个手机不同 App 的 Registration ID 是不同的），因此排查时需要获取 Registration ID 定位问题，获取方法：Android、iOS。

配额查询

如果已经成功集成了厂商通道但推送没有走厂商通道时（VIP 默认推送策略为厂商通道优先），可以进入【极光控制台】-【消息推送】-【配置管理】-【排查工具】-【配额查询】页面，查看当前的厂商通道配额是否有剩余，若配额已全部消耗，当天的通知都将通过极光通道进行下发。

查询频率说明

厂商品牌	当日配额查询	最新余量（厂商）查询	实时余量（极光）计算逻辑
小米	支持，间隔 10min 查询并记录	支持，间隔 300s 查询并记录	最新余量-提交成功数量，30s 计算 1 次
OPPO	支持，间隔 10min 查询并记录	支持，间隔 300s 查询并记录	最新余量-提交成功数量，30s 计算 1 次
vivo	支持，间隔 10min 查询并记录	支持，间隔 300s 查询并记录	最新余量-提交成功数量，30s 计算 1 次
华为	不支持，当前未查询	不支持，当前未查询	不计算配额直接下发
魅族	不支持，当前未查询	不支持，当前未查询	不计算配额直接下发
华硕	不支持，当前未查询	不支持，当前未查询	不计算配额直接下发
FCM	不支持，当前未查询	不支持，当前未查询	不计算配额直接下发