Mobile Platform as a Service：廠商訊息分類

簡介

根據推送內容對訊息進行分類管理，可以自訂 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();
}