通知下发策略

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

通道说明

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

通道	描述	支持手机类型
极光通道	极光通道是自建通道，需要依赖长连接才能收到推送，设备离线时消息不会下发。	所有可以成功注册极光通道的机型。
厂商通道	厂商通道是系统通道，设备离线也可以收到推送。支持小米、华为、OPPO、vivo、魅族、FCM 通道。	小米、华为、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	可选	通知栏消息下发逻辑	取值不能为空字符串。 first_ospush（VIP）：成功注册厂商通道的设备走厂商通道，仅注册极光通道的设备走极光通道送。 ospush（VIP）：表示推送强制走厂商通道下发。需要特别注意，只要指定此值的厂商对应配额不够时，推送请求会失败，返回 1012 错误码。举例：假设指定一个小米用户的 RegistrationID 推送，请求时针对小米、OPPO 等厂商通道都指定了“ospush”，且 OPPO 厂商通道都配额已经用完，则推送同样会返回 1012 错误，提示厂商配额不足。 jpush：表示推送强制走极光通道下发。 secondary_push：表示推送优先走极光，极光不在线再走厂商，厂商作为辅助（建议此种方式）。
distribution_fcm	string	可选	通知栏消息 fcm+ 国内厂商组合类型下发逻辑	取值不能为空字符串。 jpush：表示推送强制走极光通道下发。 fcm（VIP）：表示推送强制走 fcm 通道下发。 pns（VIP）：表示推送强制走小米 / 华为 / 魅族 /oppo/vivo 通道下发。 secondary_fcm_push：表示针对 fcm+ 国内厂商组合类型用户，推送优先走极光，极光不在线再走 fcm 通道，fcm 作为辅助。 secondary_pns_push：表示针对 fcm+ 国内厂商组合类型用户，推送优先走极光，极光不在线再走厂商通道，厂商作为辅助。
distribution_customize	string	可选	自定义消息国内厂商类型下发逻辑	定义国内厂商类型用户（当前仅对 xiaomi、huawei 生效）下发自定义消息的逻辑，取值不能为空字符串，此功能生效需 Android push SDK ≥ V3.9.0。 jpush：表示推送强制走极光通道下发。 first_ospush（VIP）：成功注册厂商通道的设备走厂商通道，仅注册极光通道的设备走极光通道。 secondary_push：表示推送优先走极光，极光不在线再走厂商，厂商作为辅助。

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 平台】-【高级设置】-【通知下发策略】，选择需要配置的通知下发策略。

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