多厂商参数

简述

由于第三方厂商和个推对特定推送参数支持不统一，个推为了给客户提供一致的推送服务，对推送参数做了特殊规定，解决接入第三方推送遇到的兼容问题，降低接入成本。

消息下发逻辑

目前第三方厂商的通知到达率显著高于第三方透传的到达率。所以厂商渠道建议使用通知。消息默认下发策略：SDK在线状态，走个推渠道下发消息，SDK离线状态，走厂商渠道下发消息。该文档不再介绍个推渠道的参数设置，着重介绍下第三方厂商渠道的通知消息功能使用。

以下是默认的第三方厂商渠道和个推渠道的下发策略，可以使用策略参数改变下发策略，使用说明详见(RestAPI V2)：公共参数-strategy 厂商下发策略选择

使用方式

push_channel 厂商通道消息内容，设置push_channel/android/ups/notification对象的title，content，intent等参数。其中可以通过options参数传入厂商通知扩展内容。

公共参数【必选】

参考RestV2 push_channel部分

更多options可填参数可以参考下文。

【华为】角标

角标设置需要Android客户端配合使用 接口类说明-16 设置华为角标

Options参数说明:

• 参数示例

{
  "android": {
    "ups": {
      "notification": {
        // ...其他push_channel参数略
      },
      "options": {
        "ALL": {
          "key": "value"
        },
        "HW": {
          "/message/android/notification/badge/class": "应用入口Activity路径名称",
          "/message/android/notification/badge/add_num": 1,
          "/message/android/notification/badge/set_num": 2
        }
      }
    }
  }
}

• key 说明

注意事项
1. 点击启动图标或通知栏系统并不会清理角标数，需应用在端侧通过角标API去清理角标；
2. add_num：EMUI版本8.0.0(及以上)，推送服务App版本8.0.0（及以上）支持；
3. set_num：EMUI版本10.0.0（及以上），推送服务App版本10.1.0（及以上）支持。

【华为】富文本消息

Options参数说明:

• 参数示例

{
  "android": {
    "ups": {
      "notification": {
        // ...其他push_channel参数略
      },
      "options": {
        "HW": {
          "/message/android/notification/image": "公网可以访问的https图标链接",
          "/message/android/notification/style": 1,
          "/message/android/notification/big_title": "big_title",
          "/message/android/notification/big_body": "big_body"
        }
      }
    }
  }
}

• key 说明

注意事项
1. 通知长文本：EMUI版本9.1.0（及以上），推送服务App版本9.1.1（及以上）支持。

【小米】消息分类

Options参数说明:

• 参数示例

{
  "android": {
    "ups": {
      "notification": {
        // ...其他push_channel参数略
      },
      "options": {
        "XM": {
          "channel": "Default"
        }
      }
    }
  }
}

• key 说明

【小米】富文本消息

先调用小米接口，上传图片，获取图片url。

Java方式 参考（小米官方文档） 4.4.1 大图/大文本/Large icon，或者集成个推多厂商推送工具集。

RestAPI 方式 参考（小米官方文档）11.1 大图、大文本/上传大图API。

Options参数说明:

• 参数示例

{
  "android": {
    "ups": {
      "notification": {
        // ...其他push_channel参数略
      },
      "options": {
        "XM": {
          "notification_large_icon_uri": "http://url.large.icon/xxx.png",
          "notification_style_type": 1,
          "notification_bigTxt": "text less than 128 characters",
          "notification_bigPic_uri": "http://url.big.pic/xxx.png"
        }
      }
    }
  }
}

• key 说明

注意事项：
1. 富文本消息仅在MIUI10及以上版本支持，在低版本和非MIUI系统上，消息将按照普通消息的样式展示;
2. 国内版MIUI系统中，仅在MIUI12及以上版本支持large icon，MIUI12以下版本不会展示;
3. 发送大图消息时，如果因为网络原因图片下载失败后将不会展示图片， 而是按照普通消息样式 展示。

【OPPO】公、私信

OPush平台上所有通道分为“公信”(默认)、“私信”两类，默认下发公信消息。公信消息单日可推送数量有限制，私信消息不限(仅限单个用户)。私信消息申请请参见（OPPO官方文档）通道升级公测邀请。

Options参数说明:

• 参数示例

{
  "android": {
    "ups": {
      "notification": {
        // ...其他push_channel参数略
      },
      "options": {
        "OP": {
          "channel": "Default"
        }
      }
    }
  }
}

• key 说明

注意事项
1.该接口需要联系个推技术人员申请开通才可以使用;
2.OPPO私信消息仅支持单推。

【OPPO】富文本消息

先调用OPPO接口，上传图片，获取图标url。

Java方式集成个推多厂商推送工具集。

RestAPI 参考 “图片上传” 。

Options参数说明:

• 参数示例

{
  "android": {
    "ups": {
      "notification": {
        // ...其他push_channel参数略
      },
      "options": {
        "OP": {
          "small_picture_id": "xxxxxxxxxxxxxxx",
          // "style": 2,
          "style": 3,
          "big_picture_id": "big_body"
        }
      }
    }
  }
}

• key 说明

注意事项：
1. 通知小图标、长文本、大图不支持单推，单推请求会返回无权限错误；
2. 长文本样式（ColorOS版本>5.0可用，通知栏第一条消息可展示全部内容，非第一条消息只展示一行内容）；
3. 大图样式（ColorOS版本>5.0可用，通知栏第一条消息展示大图，非第一条消息不显示大图，推送方式仅支持广播，且不支持定速功能）。

【vivo】消息分类

vivo消息分类功能将推送消息类型分为运营消息和系统消息，默认下发运营消息。运营消息单用户单应用单日接收条数上限为5条，系统消息不限。系统消息功能不用申请，可以直接使用，如特殊情况需额外提升系统消息量级，请参见（vivo官方文档）推送消息分类功能说明。

Options参数说明:

• 参数示例

{
  "android": {
    "ups": {
      "notification": {
        // ...其他push_channel参数略
      },
      "options": {
        "VV": {
          "classification": 0
        }
      }
    }
  }
}

• key 说明