多厂商推送接入说明
多厂商推送接入说明
接入流程
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、华为推送平台进行申请，开通第三方回执权限，需提供下列数据
- 进入华为管理中心->应用服务->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。
配置后报表数据预览
| 消息渠道 | 下发 | 到达 | 展示 | 点击 |
|---|---|---|---|---|
| 个推 | √ | √ | √* | √* |
| 华为 | √ | √ | × | √ |
| 小米 | √ | √ | × | √ |
| 魅族 | √ | √ | √ | √ |
| oppo | √ | √ | × | √ |
| vivo | √ | √ | √ | √ |
注：*个推渠道中，如果是使用个推通知模板推送消息，报表会显示展示和点击数据，使用透传模板推送消息，报表可以使用自定义点击事件补全。