通知下发策略
最近更新:2022-05-07

通知下发策略

随着厂商服务器对 厂商限额及 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 平台】-【高级设置】-【通知下发策略】,选择需要配置的通知下发策略。

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

    文档内容是否对您有帮助?

    Copyright 2011-2022, jiguang.cn, All Rights Reserved. 粤ICP备12056275号-13 深圳市和讯华谷信息技术有限公司

    在文档中心打开