如何设置Android推送策略
随着厂商服务器对 厂商限额及 QPS 限制 的逐步收紧,推送的抵达率和下发速度也受到相应的影响。为了更好地提升抵达率和下发速度,EngageLab推送提供通知下发策略功能,您可以在推送时自定义不同通道的通知下发策略,详情参考下文。
通道说明
通知下发策略仅对 Android 平台集成了厂商通道的设备有效,集成厂商通道参考 厂商通道 SDK 集成指南。
通道 | 描述 | 支持手机类型 |
---|---|---|
EngageLab通道 | EngageLab通道是自建通道,需要依赖长连接才能收到推送,设备离线时消息不会下发。 | 所有可以成功注册EngageLab通道的机型。 |
厂商通道 | 小米、华为、OPPO、vivo、魅族、谷歌手机等。 |
Android推送策略使用说明
服务端使用
推送下发时在 options 字段下配置 third_party_channel.distribution_new字段,未传则默认取值
pns_mtpush
。
distribution_new 字段说明
关键字 | 类型 | 是否必选 | 含义 | 说明 |
---|---|---|---|---|
distribution_new | String | ✅ 必选 | EngageLab 和厂商通道并存时,设置下发优先级 | 取值不能为空字符串 |
可选值列表
值 | 说明 |
---|---|
mtpush |
强制走 EngageLab 通道下发。 |
pns_mtpush |
优先走厂商通道(小米 / 华为 / 魅族 / OPPO / vivo / 荣耀),无效再走 EngageLab。 |
mtpush_pns |
优先走 EngageLab,不在线时再走厂商通道,厂商作为辅助通道。 |
fcm_mtpush |
优先走 FCM 通道,无效再走 EngageLab。 |
mtpush_fcm |
优先走 EngageLab,不在线时再走 FCM 通道,FCM 作为辅助通道。 |
🔔 注意: 针对
pns_mtpush
/fcm_mtpush
/mtpush_pns
/mtpush_fcm
这四种策略:
- 如果设备可用的系统推送通道只有一种(如仅有 FCM 或仅有厂商通道),系统将忽略所指定的策略,直接走设备已集成的有效系统通道(FCM 或厂商)。
请求示例
{
"third_party_channel": {
"distribution_new": "pns_mtpush",
"xiaomi": {
"channel_id": "*******",
"small_icon_uri": "http://f6.market.xiaomi.com/download/MiPass/x/x.png",
"small_icon_color": "#ABCDEF"
},
"huawei": {
"importance": "NORMAL",
"small_icon_uri": "https://xx.com/xx.jpg",
"only_use_vendor_style": true
},
"oppo": {
"channel_id": "*******",
"large_icon": "3653918_5f92b5739ae676f5745bcbf4"
},
"vivo": {
"pushMode": 0
}
}
}
{
"third_party_channel": {
"distribution_new": "pns_mtpush",
"xiaomi": {
"channel_id": "*******",
"small_icon_uri": "http://f6.market.xiaomi.com/download/MiPass/x/x.png",
"small_icon_color": "#ABCDEF"
},
"huawei": {
"importance": "NORMAL",
"small_icon_uri": "https://xx.com/xx.jpg",
"only_use_vendor_style": true
},
"oppo": {
"channel_id": "*******",
"large_icon": "3653918_5f92b5739ae676f5745bcbf4"
},
"vivo": {
"pushMode": 0
}
}
}
此代码块在浮窗中显示
控制台使用
进入【AppPush】-【创建推送】-【通知消息】页面,点击【Android 平台】-【高级设置】-【通知下发策略】,选择需要配置的通知下发策略。
厂商通道状态显示了当前应用开通和配置厂商通道的情况,通知下发策略仅对集成了厂商通道的设备有效。
📊 推荐 Android 推送通道策略配置表(按设备区域 + 系统支持能力)
以下表格基于设备类型、地理区域和通道支持能力,提供推荐的推送策略,帮助开发者判断何时优先使用 EngageLab通道、厂商通道或 FCM通道。
设备类型 | 所在地区 | FCM 可达性 | EngageLab 可达性及路径 | 备注与建议 |
---|---|---|---|---|
中国大陆版手机 | 中国大陆 | |||
中国香港 | ||||
港版手机 | 中国香港 | |||
中国大陆 |
✅ 优化建议
- ✅ 所有设备若无法集成 FCM 或厂商通道,统一推荐走 EngageLab 通道;
- ✅ 对于厂商通道集成成功的机型,建议优先配置为
pns_mtpush
策略(优先走厂商); - ✅ 海外 Android 设备(尤其是 Google 原生系统)建议优先走 FCM;
- ✅ 中国大陆用户建议强制集成并优先使用厂商通道 + EngageLab 混合策略。