1、 创建个推应用:登录个推开发者平台,创建应用
2、 创建厂商应用:按照客户端多厂商SDK里面的集成文档,在各厂商平台申请参数,并填写配置到个推【开发者中心-个推消息推送-应用列表-登记的应用-配置管理-特殊机型】里面,如下图;
3、 APP端接入:App端按照客户端多厂商SDK里面的集成文档,添加集成SDK;
4、 服务端接入:个推推送平台/服务端API接口设置个推和厂商推送参数。服务端API接口链接RestAPI V2;
5、 推送测试:SDK在线推送,可以收到个推渠道下发的消息;SDK离线推送,正常收到厂商通知和传递参数即可。
厂商消息推送默认逻辑:消息推送的时候,设备应用在线,走个推渠道下发,离线走厂商渠道下发。个推和厂商渠道支持设置五种消息类型,个推渠道目前都支持,厂商支持情况不一,下面具体介绍下各厂商的情况:
注:目前厂商渠道建议使用通知+intent方式。
restapi推送设置,具体可参见官网文档RestAPI V2:
以个推->纯透传,厂商->通知+intent设置为例:
如在接入和推送过程中遇到其他问题,可以参考多厂商常见问题。
联系方式:
email: support@getui.com
个推渠道:个推SDK内部有相应的埋点,应用有收到推送的通知和透传消息的时候,会上报数据到后台,数据报表进行展示和统计;
APNs渠道:APNs的数据可以通过苹果提供的通知展示和点击回调方法,上报埋点数据,来统计报表数据。这里说明下,展示数据可以统计到iOS10及以上设备的数据,到达数据由于未提供相应的回调方法,所以暂时统计不到;
华为渠道:华为暂时未对外提供报表数据接口,提供了回执,报表数据可以根据回执统计到到达数据;
魅族渠道:魅族有对外提供报表数据接口,可以统计到全量的数据;
小米渠道:小米有对外提供报表数据接口,展示数据未提供;
oppo渠道:oppo暂时未对外提供报表数据接口,提供了回执,报表数据可以根据回执统计到到达数据;
vivo渠道:vivo渠道有对外提供群推报表数据,任务维度报表可以统计到全量的数据;单推没有提供报表数据,由于也未提供App维度的报表数据接口,所以App维度报表通过单推回执+群推报表的形式统计;
厂商渠道的推送的消息由于上述厂商功能限制,有部分推送报表数据无法直接获取,但可以通过配置回执回调的方式(参考下文)以及自定义点击事件(参考SDK集成自定义点击事件)等方式获取到。
若需配置回执回调,可以参考下述文档,并联系个推技术支持。
消息渠道 | 下发 | 到达 | 展示 | 点击 |
---|---|---|---|---|
个推 | √ | √ | ×* | ×* |
华为 | √ | × | × | × |
小米 | √ | √ | × | √ |
魅族 | √ | √ | √ | √ |
oppo | √ | × | × | × |
vivo | √ | √ | √ | √ |
注:*个推渠道中,如果是使用个推通知模板推送消息,报表会显示展示和点击数据,使用透传模板推送消息,报表不显示展示和点击数据。
由于部分厂商未对外提供报表数据,所以需要通过回执统计推送数据。
1、华为推送平台进行申请,开通第三方回执权限,需提供下列数据
https://thirdrcp-hz.getui.com/hw
,复制证书内容,提交保存。HTTPS证书PEM格式:
-----BEGIN CERTIFICATE-----
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
-----END CERTIFICATE-----
注:证书开头和结尾不要遗漏,前后不要有空格,内容不要有回车符,以免保存失败。
2、联系个推客服,开通第三方回执权限,需提供下列数据:
AppId(个推AppId)
明确要开通华为回执权限
应用方向个推技术同学提供回执URL域名和个推的AppId
参数,该URL配置cname
到个推域名thirdrcphz.cname.getui.com
。oppo和vivo的到达数据回执通过域名,最终解析到个推的回执接收服务,不经过应用方的服务器。
注:1. oppo和vivo可以共用一个回执URL。
消息渠道 | 下发 | 到达 | 展示 | 点击 |
---|---|---|---|---|
个推 | √ | √ | √* | √* |
华为 | √ | √ | × | √ |
小米 | √ | √ | × | √ |
魅族 | √ | √ | √ | √ |
oppo | √ | √ | × | √ |
vivo | √ | √ | √ | √ |
注:*个推渠道中,如果是使用个推通知模板推送消息,报表会显示展示和点击数据,使用透传模板推送消息,报表可以使用自定义点击事件补全。