移动开发平台mPaaS：厂商消息分类

简介

根据推送内容对消息进行分类管理，可以自定义 Channel ID。

• 适用所有 Android 渠道

• 创建客户端自定义渠道

• 推送时下发对应的渠道 ID

  参数名称	类型	是否必填	示例	描述
  channelId	String	否	channelId: "channelIdTest"	Android 通知 channelId

• 若需要下发厂商通道重要级别消息，请参考下文各个厂商消息分类的使用指南

华为分类

厂商针对消息分类的说明

根据消息内容，华为推送将通知分类为 服务与通讯、资讯营销 两大类别，并对不同类别消息的提醒方式、消息样式进行差异化管理，具体如下：

分类方式

消息智能分类

智能分类算法将根据您发送的内容等多个维度因素，自动将您的消息按照分类标准进行归类。

消息自分类

2021.07.01 起，华为推送服务开始接收开发者自分类权益的申请。申请成功后，允许开发者根据华为推送分类规范，自行对消息进行分类。

华为消息分类申请

自分类申请详情参见 华为消息分类管理方案。

• 若应用没有自分类权益，则应用的推送消息将通过智能分类进行自动归类。

• 若应用有自分类权益，将信任开发者提供的分类信息，消息不经过智能分类。

在 mPaaS MPS 上对接华为消息分类传参枚举（thirdChannelCategory.hms）

传参示例

荣耀分类

厂商针对消息分类的说明

根据消息内容，华为推送将通知分类为 服务与通讯、资讯营销 两大类别，具体如下：

分类方式

消息智能分类

智能分类算法将根据您发送的内容等多个维度因素，自动将您的消息按照分类标准进行归类。

消息自分类

允许开发者根据消息分类规范，自行对消息进行分类。

在 mPaaS MPS 上对接荣耀消息分类传参枚举（thirdChannelCategory.honor）

传参示例

小米消息分类

厂商针对消息分类的说明

根据《小米推送消息分类新规》，小米推送将消息分为 私信消息 和 公信消息 两个类别，若应用选择不接入私信或公信，则会接入 默认 通道。

小米消息分类申请

申请方式请参见小米官方文档 channel 申请及接入方法。

在 mPaaS MPS 上对接小米消息分类传参示例

OPPO 消息分类

厂商针对消息分类的说明

OPPO 私信通道申请

• 私信通道权益申请

• 私信申请邮件通过后，需要在 OPPO 推送平台 上登记该通道，并将通道对应属性设置为 私信

在 mPaaS MPS 上对接 OPPO 消息分类传参示例

vivo 消息分类

厂商针对消息分类的说明

• 通知开启的有效用户：应用集成的 push-sdk 订阅成功，且设备近 14 天内有联网的通知权限开启用户。

• 通知开启有效用户数＜10000，则运营消息量级默认为 10000。

• 通知开启的有效用户数及可发送运营消息量级，可在推送运营后台查询。

• 推送限额数以 到达量 计算，当日到达量超限则计入管控。

在 mPaaS MPS 上对接 vivo 二级消息分类传参枚举（thirdChannelCategory.vivo）

在 mPaaS MPS 上对接 vivo 消息分类传参示例

MPS 对接厂商消息分类 Java 示例代码

厂商消息分类推送参数推荐都上传，MPS 会根据设备类型进行对应厂商分类参数的封装。

 DefaultProfile.addEndpoint("cn-hangzhou", "mpaas", "mpaas.cn-hangzhou.aliyuncs.com");
        // 创建 DefaultAcsClient 实例并初始化
        // 阿里云账号AccessKey拥有所有API的访问权限，建议您使用RAM用户进行API访问或日常运维。
        // 强烈建议不要把AccessKey ID和AccessKey Secret保存到工程代码里，否则可能导致AccessKey泄露，威胁您账号下所有资源的安全。
        // 本示例以将AccessKey ID和AccessKey Secret保存在环境变量为例说明。您也可以根据业务需要，保存到配置文件里。
        // 建议先完成环境变量配置
        String accessKeyId = System.getenv("MPAAS_AK_ENV");
        String accessKeySecret = System.getenv("MPAAS_SK_ENV");
        DefaultProfile profile = DefaultProfile.getProfile(
            "cn-hangzhou",          // 地域 ID
            accessKeyId,      
            accessKeySecret); 

IAcsClient client = new DefaultAcsClient(profile);
// Create an API request and set parameters
PushSimpleRequest request = new PushSimpleRequest();
request.setAppId("ONEX570DA89211721");
request.setWorkspaceId("test");
request.setTaskName("测试任务");
request.setTitle("测试");
request.setContent("测试");
request.setDeliveryType(3L);
Map<String,String> extendedParam = new HashMap<String, String>();
extendedParam.put("key1","value1");
request.setExtendedParams(JSON.toJSONString(extendedParam));
request.setExpiredSeconds(300L);

request.setPushStyle(2);
String imageUrls = "{\"defaultUrl\":\"https://pre-mpaas.oss-cn-hangzhou.aliyuncs.com/tmp/test.png\",\"oppoUrl\":\"https://pre-mpaas.oss-cn-hangzhou.aliyuncs.com/tmp/test.png\",\"miuiUrl\":\"https://pre-mpaas.oss-cn-hangzhou.aliyuncs.com/tmp/test.png\",\"fcmUrl\":\"https://pre-mpaas.oss-cn-hangzhou.aliyuncs.com/tmp/test.png\",\"iosUrl\":\"https://pre-mpaas.oss-cn-hangzhou.aliyuncs.com/tmp/test.png\"}";
String iconUrls = "{\"defaultUrl\":\"https://pre-mpaas.oss-cn-hangzhou.aliyuncs.com/tmp/test.png\",\"hmsUrl\":\"https://pre-mpaas.oss-cn-hangzhou.aliyuncs.com/tmp/test.png\",\"oppoUrl\":\"https://pre-mpaas.oss-cn-hangzhou.aliyuncs.com/tmp/test.png\",\"miuiUrl\":\"https://pre-mpaas.oss-cn-hangzhou.aliyuncs.com/tmp/test.png\"}";
request.setImageUrls(imageUrls);
request.setIconUrls(iconUrls);

request.setStrategyType(2);
request.setStrategyContent("{\"fixedTime\":1630303126000,\"startTime\":1625673600000,\"endTime\":1630303126000,\"circleType\":1,\"circleValue\":[1, 7],\"time\":\"13:45:11\"}");

Map<String,String> target = new HashMap<String, String>();
String msgKey = String.valueOf(System.currentTimeMillis());
target.put("user1024",msgKey);
request.setTargetMsgkey(JSON.toJSONString(target));

//厂商消息分类字段

//封装VIVO消息分类一级分类
request.setClassification("1");
//封装华为消息分类、荣耀消息分类和VIVO消息分类二级分类
Map<String, String> map = new HashMap<>();
map.put("hms", "2");
map.put("vivo", "3");
map.put("honor", "1");
pushSimpleReq.setThirdChannelCategory(map);
//封装小米消息分类
pushSimpleReq.setMiChannelId("miChannelIdTest);
//封装OPPO消息分类
pushSimpleReq.setChannelId("channelIdTest");


// Initiate the request and handle the response or exceptions
PushSimpleResponse response;
try {
    response = client.getAcsResponse(request);
    System.out.println(response.getResultCode());
    System.out.println(response.getResultMessage());
} catch (ClientException e) {
    e.printStackTrace();
}