logo产品文档
搜索
登录

如何设置Android推送策略

随着厂商服务器对 厂商限额及 QPS 限制 的逐步收紧,推送的抵达率和下发速度也受到相应的影响。为了更好地提升抵达率和下发速度,EngageLab推送提供通知下发策略功能,您可以在推送时自定义不同通道的通知下发策略,详情参考下文。

通道说明

通知下发策略仅对 Android 平台集成了厂商通道的设备有效,集成厂商通道参考 厂商通道 SDK 集成指南

通道 描述 支持手机类型
EngageLab通道 EngageLab通道是自建通道,需要依赖长连接才能收到推送,设备离线时消息不会下发。 所有可以成功注册EngageLab通道的机型。
厂商通道
  • 厂商通道是系统通道,设备离线也可以收到推送。
  • 支持小米、华为、OPPO、vivo、魅族、FCM 通道。
  • 小米、华为、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 平台】-【高级设置】-【通知下发策略】,选择需要配置的通知下发策略。

    厂商通道状态显示了当前应用开通和配置厂商通道的情况,通知下发策略仅对集成了厂商通道的设备有效。

    alt text

    📊 推荐 Android 推送通道策略配置表(按设备区域 + 系统支持能力)

    以下表格基于设备类型、地理区域和通道支持能力,提供推荐的推送策略,帮助开发者判断何时优先使用 EngageLab通道、厂商通道或 FCM通道。

    设备类型 所在地区 FCM 可达性 EngageLab 可达性及路径 备注与建议
    中国大陆版手机 中国大陆
  • 所有品牌:均不可达。
  • 可达。
  • 强烈推荐集成 EngageLabAppPush服务(已集成主流厂商通道)。
  • 中国香港
  • 所有品牌:均不可达。
  • 可达;
  • 华为、荣耀、OPPO:通过厂商或者EngageLab通道可达;
  • 其他中国品牌(小米、魅族、vivo等):通过 EngageLab 通道可达。
  • 强烈推荐集成 EngageLabAppPush服务
  • 华为、荣耀、OPPO 设备优先使用其厂商通道。
  • 港版手机 中国香港
  • 非中国品牌(如三星):可达;
  • 华为港版:不可达;
  • 荣耀/OPPO港版及其他中国港版:需设备支持 FCM 才可达。
  • 可达;
  • 华为港版:通过厂商或者EngageLab通道可达;
  • 荣耀/OPPO港版:通过厂商通道或 EngageLab 通道可达;
  • 其他中国港版/非中国品牌:通过 EngageLab 通道可达。
  • 强烈推荐集成 EngageLabAppPush服务(已集成主流厂商通道)。
  • 华为港版必须使用厂商或者EngageLab通道;
  • 荣耀/OPPO港版可根据设备 FCM 支持情况选择通道;
  • 其他品牌统一使用 EngageLab 通道。
  • 中国大陆
  • 所有品牌:均不可达。
  • 可达;
  • 华为/荣耀/OPPO港版:通过厂商通道或 EngageLab 通道可达;
  • 小米/魅族/vivo港版及其他中国港版/非中国品牌:通过 EngageLab 通道可达。
  • 强烈推荐集成 EngageLabAppPush服务
  • 所有港版设备在中国大陆地区均依赖 EngageLab 或厂商通道实现推送。
  • ✅ 优化建议

    • ✅ 所有设备若无法集成 FCM 或厂商通道,统一推荐走 EngageLab 通道;
    • ✅ 对于厂商通道集成成功的机型,建议优先配置为 pns_mtpush 策略(优先走厂商);
    • 海外 Android 设备(尤其是 Google 原生系统)建议优先走 FCM;
    • 中国大陆用户建议强制集成并优先使用厂商通道 + EngageLab 混合策略。
    icon
    联系销售