通知下发策略
最近更新:2022-05-07
通知下发策略
随着厂商服务器对 厂商限额及 QPS 限制 的逐步收紧,推送的抵达率和下发速度也受到相应的影响。为了更好地提升抵达率和下发速度,极光推送提供通知下发策略功能,您可以在推送时自定义不同通道的通知下发策略,详情参考下文。
通道说明
通知下发策略仅对 Android 平台集成了厂商通道的设备有效,集成厂商通道参考 厂商通道 SDK 集成指南。
通道 | 描述 | 支持手机类型 |
---|---|---|
极光通道 | 极光通道是自建通道,需要依赖长连接才能收到推送,设备离线时消息不会下发。 | 所有可以成功注册极光通道的机型。 |
厂商通道 | 小米、华为、OPPO、vivo、魅族、谷歌手机等。 |
使用说明
服务端使用
下发时在 options 字段下配置 third_party_channel 字段,并在对应的厂商 key 下配置策略参数即可按照策略进行推送。
- options.third_party_channel 的 key 只支持 xiaomi、huawei、meizu、oppo、vivo、fcm 类型用户。 key 可以为上述 6 个类型中的其中一个或者多个同时存在,未传递的 key 其对应的厂商下发走默认下发逻辑。
- 默认下发逻辑:
- 免费用户:distribution 默认值为 secondary_push,distribution_fcm 默认值为 secondary_fcm_push。
- VIP 用户:distribution 默认值为 first_ospush,distribution_fcm 默认值为 fcm。
- 厂商类型的 key 对应的 3 个策略参数说明如下:
关键字 | 类型 | 选项 | 含义 | 说明 |
---|---|---|---|---|
distribution | string | 可选 | 通知栏消息下发逻辑 | 取值不能为空字符串。 举例:假设指定一个小米用户的 RegistrationID 推送,请求时针对小米、OPPO 等厂商通道都指定了“ospush”,且 OPPO 厂商通道都配额已经用完,则推送同样会返回 1012 错误,提示厂商配额不足。 |
distribution_fcm | string | 可选 | 通知栏消息 fcm+ 国内厂商组合类型下发逻辑 | 取值不能为空字符串。 |
distribution_customize | string | 可选 | 自定义消息国内厂商类型下发逻辑 | 定义国内厂商类型用户(当前仅对 xiaomi、huawei 生效)下发自定义消息的逻辑,取值不能为空字符串,此功能生效需 Android push SDK ≥ V3.9.0。 |
API 示例
"third_party_channel":{
"xiaomi":{
"distribution":"jpush",
"distribution_fcm":"fcm",
"distribution_customize":"first_ospush",
},
"huawei":{
"distribution":"secondary_push",
"distribution_fcm":"jpush",
"distribution_customize":"first_ospush",
},
"meizu":{
"distribution":"jpush",
"distribution_fcm":"pns"
},
"fcm":{ // 这个参数不支持 distribution_fcm 字段
"distribution":"jpush"
},
"oppo":{
"distribution":"ospush",
"distribution_fcm":"secondary_fcm_push",
},
"vivo":{
"distribution":"jpush",
"distribution_fcm":"secondary_pns_push",
}
}
"third_party_channel":{
"xiaomi":{
"distribution":"jpush",
"distribution_fcm":"fcm",
"distribution_customize":"first_ospush",
},
"huawei":{
"distribution":"secondary_push",
"distribution_fcm":"jpush",
"distribution_customize":"first_ospush",
},
"meizu":{
"distribution":"jpush",
"distribution_fcm":"pns"
},
"fcm":{ // 这个参数不支持 distribution_fcm 字段
"distribution":"jpush"
},
"oppo":{
"distribution":"ospush",
"distribution_fcm":"secondary_fcm_push",
},
"vivo":{
"distribution":"jpush",
"distribution_fcm":"secondary_pns_push",
}
}
此代码块在浮窗中显示
控制台使用
通知消息
进入【极光推送】-【创建推送】-【通知消息】页面,点击【Android 平台】-【高级设置】-【通知下发策略】,选择需要配置的通知下发策略。
厂商通道状态显示了当前应用开通和配置厂商通道的情况,通知下发策略仅对集成了厂商通道的设备有效。
自定义消息
进入【极光推送】-【创建推送】-【自定义消息】页面,点击【Android 平台】-【高级设置】-【通知下发策略】,选择需要配置的通知下发策略。
厂商通道状态显示了当前应用开通和配置厂商通道的情况,通知下发策略仅对集成了厂商通道的设备有效。
文档内容是否对您有帮助?