多厂商推送接入说明

接入流程

1、 创建个推应用：登录个推开发者平台，创建应用

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

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

推送消息下发逻辑

1. 消息下发流程

2. 流程解读

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

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

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

多厂商后台推送设置

1. API接口推送设置

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

示例如下：

{      
    "request_id":"请填写10到32位的id",      
    "audience": {      
        "cid": [      
            "请输入clientid"      
        ]      
    },      
    "settings":{      
        "ttl":3600000,      
        "strategy":{      
            "default":1,
            "ios":2
        }      
    },      
     "push_message":{
        "notification":{
            "title":"请填写安卓在线标题",
            "body":"请填写安卓在线内容",
            "click_type":"startapp"
        }
    },
    "push_channel":{      
        "android":{      
            "ups":{      
                "notification":{      
                    "title":"安卓离线展示的标题",      
                    "body":"安卓离线展示的内容",      
                    "click_type":"intent",                              
                    "intent:#Intent;component=你的包名/你要打开的 activity全路径;S.parm1=value1;S.parm2=value2;end"      
                }      
            }      
        },      
      "ios":{      
            "type":"notify",      
            "payload":"自定义消息",      
            "aps":{      
                "alert":{      
                    "title":"苹果离线展示的标题",      
                    "body":"苹果离线展示的内容"      
                },      
                "content-available":0,    
                "sound":"default"     
            },      
            "auto_badge":"+1"      
        }      }  
}

2. 个推平台推送示意

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

多厂商推送接入注意事项

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

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

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

联系方式:

email: support@getui.com