排查工具

最后更新时间:2021-08-16 11:20:03

    简介

    当您在推送消息时出现异常情况(例如推送消息收不到或推送失败)时,可通过排查工具进行自助排查以及通过账号或者 Token 查询设备详情、设备绑定的账号以及设备绑定的标签。

    常见场景

    1. 开发人员在控制台推送一条消息给测试设备,控制台推送状态显示成功,但在手机通知栏未看到这条消息,通过 Token 查询设备详情发现通知栏权限关闭,在手机上开启通知栏权限后,再次触发注册,此时往这台设备发送消息,手机通知栏成功展示。

    2. 运营人员通过用户账号推送消息,推送状态显示“推送失败”,在排查工具中输入用户账号查询 Token,发现该应用下,此账号没有关联的设备 Token,可联系开发人员排查是否调用了 账号绑定(Android)或账号绑定(iOS)接口。

    3. 开发人员完成了 TPNS 的接入工作后,对某一批设备 Token 推送消息,线上用户反馈没有收到该推送信息,获取该用户 Token 和 pushID 后,在推送排查得知,推送列表中并无该 Token。

    操作步骤

    通过用户账号查询

    1. 登录 移动推送 TPNS 控制台
    2. 在左侧导航栏选择【App推送管理】>【排查工具】。
    3. 单击下拉框选择您需要查询产品及应用,选择【通过账号查询】。
    4. 输入用户账号,单击【查询】。
    5. 选择账号下关联的设备 Token 查看设备注册详情。
      说明:

      • 账号:与 Token 绑定的用户唯一 ID,一般为 OpenID、UID 等。
      • Token 列表展示规则:Token 按与账号绑定时间的倒序展示,本页面最多展示10个 Token,推送目标设置为账号推送时,系统默认推送给最近一次绑定该账号的设备 ,例如需要更改为推送给所有绑定该账号的设备,请在 控制台API 推送时更改设置。

    通过 Token 直接查询

    1. 在排查工具页面,选择【通过 Token 直接查询】。
    2. 输入设备 Token,单击【查询】,页面右侧会显示当前设备注册详情。
      说明:

    推送查询

    1. 在【排查工具】页面,单击【推送查询】。

    2. 输入 pushid(必选)、待查询的设备 Token(必选),单击【查询】,查看排查结果。

      说明:

      pushid 获取方式:

      1. 可在左侧导航栏选择【推送管理】>【推送任务】,获取需要查询的 PushID。
      2. 在推送接口的应答参数中获取。
    3. 若查询结果与实际情况不符或仍无法解决问题,可查看 推送常见问题提交工单 反馈,并在工单中补充 pushID 和 Token 信息。

    常见问题

    设备查询常见问题

    1. 设备 Token 什么情况下会失效?
      • Token 有效期为90天,若设备连续90天未连接移动推送服务器,则会被标记为无效设备。
      • 若设备卸载了 App,当前 Token 会被标记为无效。
    2. 通知栏权限已经开启,为什么设备查询显示关闭状态?
      若手机通知栏设置从关闭到开启权限,需要在客户端重新触发一次注册请求,才可以把开启状态同步到移动推送服务器。

    推送常见问题

    1. 通过账号或者标签推送无法收到,但通过 Token 推送可以收到,是什么原因?
      在设备注册详情页中查看该 Token 是否关联了推送的目标账号或者标签,若未关联则无法通过账号或标签推送。
    2. 推送状态显示已完成,设备状态正常,为什么手机没有收到推送?
      • iOS 平台推送环境是否与 Token 注册环境一致,不一致则无法收到推送,推送环境选择说明详情可参考文档 推送环境选择
      • 检查 App 包名是否和【移动推送 TPNS 控制台】>【App推送管理】>【基础配置】中填写的包名一致,如果包名不一致检查是否开启 多包名推送功能
      • 安卓 P 及以上系统需要添加使用 Apache HTTP client 库,检查在 AndroidManifest 的 application 节点内是否有添加以下配置:
        <uses-library android:name="org.apache.http.legacy" android:required="false"/>
        
      • 小米手机确认是否被收纳到【不重要通知】。
      • 魅族手机确认是否被收纳到【消息盒子】。
      • vivo 、OPPO 部分机型通知栏默认关闭,确认是否手动开启。
      • vivo 、华为部分机型,通知渠道的横幅、铃声等权限默认关闭,确认是否手动开启。
      • 应尽量避免使用“test”、“测试”等字眼,部分厂商通道会拦截这类型的通知。
      • vivo、OPPO 需要厂商审核通过后才可以测试推送,请注意确认。