多厂商推送接入说明

多厂商推送接入说明

接入流程

1、 创建个推应用:登录个推开发者平台,创建应用

2、 创建厂商应用:按照客户端多厂商SDK里面的集成文档,在各厂商平台申请参数,并填写配置到个推【开发者中心-个推消息推送-应用列表-登记的应用-配置管理-特殊机型】里面,如下图;

3、 APP端接入:App端按照客户端多厂商SDK里面的集成文档,添加集成SDK;
4、 服务端接入:个推推送平台/服务端API接口设置个推和厂商推送参数。服务端API接口链接RestAPI V2;
5、 推送测试:SDK在线推送,可以收到个推渠道下发的消息;SDK离线推送,正常收到厂商通知和传递参数即可。

推送消息下发逻辑

1. 消息下发流程

2. 流程解读

厂商消息推送默认逻辑:消息推送的时候,设备应用在线,走个推渠道下发,离线走厂商渠道下发。个推和厂商渠道支持设置五种消息类型,个推渠道目前都支持,厂商支持情况不一,下面具体介绍下各厂商的情况:

  • 通知+启动应用:都支持;
  • 通知+网页:都支持;
  • 通知+intent:都支持;
  • 通知+透传:华为、oppo渠道不支持;
  • 纯透传:魅族、oppo、vivo不支持;华为、小米离线情况下,消息存离线库,消息有效期内SDK在线以后下发。

注:目前厂商渠道建议使用通知+intent方式。

多厂商后台推送设置

1. API接口推送设置

restapi推送设置,具体可参见官网文档RestAPI V2

2. 个推平台推送示意

以个推->纯透传,厂商->通知+intent设置为例:

多厂商推送接入注意事项

  • 应用、个推平台、厂商平台的应用包名和参数保持一致;
  • 华为平台创建PUSH权益的时候,sha256指纹证书需要填写上,华为消息推送需要打正式签名的包;
  • 个推平台配置厂商参数保存以后,开启通道开关、开启推送兼容、关闭静默时间。

如在接入和推送过程中遇到其他问题,可以参考多厂商常见问题

若测试过程有异常,请及时与个推技术支持联系。

联系方式:

email: support@getui.com

消息报表数据报表介绍

  • 个推渠道:个推SDK内部有相应的埋点,应用有收到推送的通知和透传消息的时候,会上报数据到后台,数据报表进行展示和统计;

  • APNs渠道:APNs的数据可以通过苹果提供的通知展示和点击回调方法,上报埋点数据,来统计报表数据。这里说明下,展示数据可以统计到iOS10及以上设备的数据,到达数据由于未提供相应的回调方法,所以暂时统计不到;

  • 华为渠道:华为暂时未对外提供报表数据接口,提供了回执,报表数据可以根据回执统计到到达数据;

  • 魅族渠道:魅族有对外提供报表数据接口,可以统计到全量的数据;

  • 小米渠道:小米有对外提供报表数据接口,展示数据未提供;

  • oppo渠道:oppo暂时未对外提供报表数据接口,提供了回执,报表数据可以根据回执统计到到达数据;

  • vivo渠道:vivo渠道有对外提供群推报表数据,任务维度报表可以统计到全量的数据;单推没有提供报表数据,由于也未提供App维度的报表数据接口,所以App维度报表通过单推回执+群推报表的形式统计;

厂商渠道的推送的消息由于上述厂商功能限制,有部分推送报表数据无法直接获取,但可以通过配置回执回调的方式(参考下文)以及自定义点击事件(参考SDK集成自定义点击事件)等方式获取到。

若需配置回执回调,可以参考下述文档,并联系个推技术支持

配置前报表数据预览

消息渠道 下发 到达 展示 点击
个推 ×* ×*
华为 × × ×
小米 ×
魅族
oppo × × ×
vivo

注:*个推渠道中,如果是使用个推通知模板推送消息,报表会显示展示和点击数据,使用透传模板推送消息,报表不显示展示和点击数据。

厂商回执回调介绍

由于部分厂商未对外提供报表数据,所以需要通过回执统计推送数据。

开通华为第三方回执步骤

1、华为推送平台进行申请,开通第三方回执权限,需提供下列数据

  • URL回执接收地址https://thirdrcp-hz.getui.com/hw,复制证书内容,提交保存。

HTTPS证书PEM格式:

-----BEGIN CERTIFICATE-----
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
-----END CERTIFICATE-----

注:证书开头和结尾不要遗漏,前后不要有空格,内容不要有回车符,以免保存失败。

2、联系个推客服,开通第三方回执权限,需提供下列数据:

  • AppId(个推AppId)

  • 明确要开通华为回执权限

开通oppo、vivo第三方回执步骤

应用方向个推技术同学提供回执URL域名和个推的AppId参数,该URL配置cname到个推域名thirdrcphz.cname.getui.com。oppo和vivo的到达数据回执通过域名,最终解析到个推的回执接收服务,不经过应用方的服务器。

注:1. oppo和vivo可以共用一个回执URL。

配置后报表数据预览

消息渠道 下发 到达 展示 点击
个推 * *
华为 ×
小米 ×
魅族
oppo ×
vivo

注:*个推渠道中,如果是使用个推通知模板推送消息,报表会显示展示和点击数据,使用透传模板推送消息,报表可以使用自定义点击事件补全。

开发者中心 SDK 下载

文档中心搜索