多厂商推送接入说明

接入流程

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集成自定义点击事件）等方式获取到。

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

配置前报表数据预览

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

厂商回执回调介绍

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

开通华为第三方回执步骤

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

• 进入华为管理中心->应用服务->Push，选择应用;

• 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。

配置后报表数据预览

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