tencent cloud

文档反馈

排查工具

最后更新时间:2023-05-08 16:51:18

    简介

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

    常见场景

    1. 开发人员在控制台推送一条消息给测试设备,控制台推送状态显示成功,但在手机通知栏未看到这条消息,通过 Token 查询设备详情发现通知栏权限关闭,在手机上开启通知栏权限后,再次触发注册,此时往这台设备发送消息,手机通知栏成功展示。
    2. 运营人员通过用户账号推送消息,推送状态显示“推送失败”,在排查工具中输入用户账号及绑定的账号类型查询 Token,发现该应用下,此账号没有关联的设备 Token,可联系开发人员排查是否调用了 账号绑定(Android)账号绑定(iOS)接口。
    3. 开发人员完成了移动推送的接入工作后,对某一批设备 Token 推送消息,线上用户反馈没有收到该推送信息,获取该用户 Token 和 pushID 后,在推送排查得知,推送列表中并无该 Token。

    操作步骤

    通过用户账号查询

    1. 登录 移动推送控制台
    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. 可在左侧导航栏选择 App 推送管理 > 推送任务,获取需要查询的 PushID。
      2. 在推送接口的应答参数中获取。
    3. App 推送管理 > 推送任务,更换 管理台创建>API创建 及可查看到API推送数据
    4. 若查询结果与实际情况不符或仍无法解决问题,可查看 推送常见问题 或联系 在线客服,并补充 pushID 和 Token 信息。

    常见问题

    设备查询常见问题

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

    推送常见问题

    1. 通过账号或者标签推送无法收到,但通过 Token 推送可以收到,是什么原因?
      在设备注册详情页中查看该 Token 是否关联了推送的目标账号或者标签,若未关联则无法通过账号或标签推送。
    2. 推送状态显示已完成,设备状态正常,为什么手机没有收到推送?
    • iOS 平台推送环境是否与 Token 注册环境一致,不一致则无法收到推送,推送环境选择说明详情可参考文档 推送环境选择

    • 检查 App 包名是否和**移动推送控制台>**App推送管理>基础配置中填写的包名一致,如果包名不一致检查是否开启 多包名推送功能

    • 安卓 P 及以上系统需要添加使用 Apache HTTP client 库,检查在 AndroidManifest 的 application 节点内是否有添加以下配置:

       <uses-library android:name="org.apache.http.legacy" android:required="false"/>
      
    • 小米手机确认是否被收纳到不重要通知

    • 魅族手机确认是否被收纳到消息盒子

    • vivo 、OPPO 部分机型通知栏默认关闭,确认是否手动开启。

    • vivo 、华为部分机型,通知渠道的横幅、铃声等权限默认关闭,确认是否手动开启。

    • 应尽量避免使用“test”、“测试”等字眼,部分厂商通道会拦截这类型的通知。

    • vivo、OPPO 需要厂商审核通过后才可以测试推送,请注意确认。

    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持