VIVO消息推送 接入push服务注意事项
开发者接入push服务存在的共性问题排查指南:
一、请接入方先通过本地工具【postmen】先调用我们提供的接口,保证本地调用我们的接口是没有问题【减少在开发过程沟通成本】
二、如果是本地工具接口测试:请先检查一下事项
1、请先测试推送鉴权接口,获取到 authToken 才可以进行消息推送 【可以确保接入方本地调用push服务是通的】
2、检查一下当前应用是否是受限应用(受限应用将在2-3个工作日内转为正式)
①如果是受限应用,则只能测试单播接口,测试其他推送接口会有对应提示
②如果是受限应用,那么需要在vivo推送营运平台后台添加要测试的设备【设备id(regId)】最多可以添加20个设备
③如果是受限应用,在调用单播接口的时候,需要在请求参数中确认pushMode==1字段(0:正式推送;1:测试推送,不填默认为0)
测试推送没有频控限制(受限应用发不了正式推送)
3、检查一下当前推送的消息是运营消息还是系统消息【前提:推送为正式推送】
(接入方在web生成app推送的时候 参数 classification==0 , 0:运营类消息,1:系统类消息。不填默认为0)
如果客户端多次收到消息后,又出现收不到的情况
检查消息是否被管控,单用户单应用每天收到的消息条数上限5条,系统消息不受应用频控管控,受系统消息推送总量限制
建议:如果只是检验功能,建议使用测试推送【测试消息不受频控、推送量级管控】
三、关于消息数据统计问题【vivo推送运营后台有相关消息统计明细分布情况】
请各个接入方先到 vivo推送管理后台查看当前应用消息大体的数据统计分布情况
统计分两种:
①应用级别的消息统计明细分布情况
②单推统计明细分布情况
【可以通过这两个指标,进一步分析消息没有达到的原因】
同时:建议接入方在关键地方也收集数据。比如消息达到客户端,建议应用方也做一个记录。
对我们接口返回的regId(1.userId不存在;2.卸载或者关闭了通知;3.七天不在线;4.非测试用户),这些状态也存储一下,可以预防无效的推送
四、如遇接口返回状态码 10206 sign 不正确提示 【前提:一样的签名方法, 偶现签名不正确】
如果出现这种情况:
就是业务方在进行签名的时候 appId/appKey/appSecret 存在本来给“应用A”生成的签名,结果把sign拿给“应用B”进行签名了
【签名:使用MD5算法,字符串trim后拼接(appId+appKey+timestamp+appSecret),然后通过MD5加密得到的值(字母小写)】
请接入方在有多个应用的时候,要注意签名方法的使用,防止签名误传
五、如遇接口返回状态码 10000 权限认证失败,则表示应用方获取的authToken 失效了 ,请重新获取
六、regId升级
原有token(regId)生成规则是固定23位数字。已不能满足后续增长需求,推送平台从2022年5月开始升级token(regId)生成规则,取消现有固定23位长度及数字限制,新规则长度可变,包含字符“0-9”、“a-z”、“A-Z”及特殊字符。2022年7月30号全量升级。老的regId不变,新订阅会按照新regId规则生成。
七、如何发送测试消息图解
接入Vpush后的应用均可以发送测试消息。发送测试消息的步骤如下:
1、 先在推送运营后台添加测试设备。
1) 在推送平台找桌面app打包生成到你的应用名称
2) 在刚才的基础之前要点击测试设备
3) 到了这个页面 要点击添加测试设备
4) 添加具体信息点击确定
2、然后接入服务端API,通过调用/message/send,pushMode设置为1,给第一步绑定成功的测试设备发送消息。详情请见《服务端API接口文档》
说明:
1、 添加测试设备为接入客户端SDK,订阅获取到的regId,通过调用客户端api接口的getRegId方法获取,详情请见《客户端API接口文档》
2、最多支持添加20个测试设备
3、测试消息不受量级和频次限制。
编辑:yimen,如若转载,请注明出处:https://www.yimenapp.com/kb-yimen/12133/
部分内容来自网络投稿,如有侵权联系立删