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

簡介

根據推送內容對訊息進行分類管理，可以自訂 Channel ID。

• 適用所有 Android 渠道

• 建立用戶端自訂渠道

• 推送時下發對應的渠道 ID

  參數名稱	類型	是否必填	樣本	描述
  channelId	String	否	channelId: "channelIdTest"	Android 通知 channelId

• 若需要下發廠商通道重要層級訊息，請參考下文各個廠商訊息分類的使用指南

華為分類

廠商針對訊息分類的說明

根據訊息內容，華為推送將通知分類為 服務與通訊、資訊營銷 兩大類別，並對不同類別訊息的提醒方式、訊息樣式進行差異化管理，具體如下：

分類方式

訊息智能分類

智能分類演算法將根據您發送的內容等多個維度因素，自動將您的訊息按照分類標準進行歸類。

訊息自分類

2021.07.01 起，華為推送服務開始接收開發人員自分類權益的申請。申請成功後，允許開發人員根據華為推送分類規範，自行對訊息進行分類。

華為訊息分類申請

自分類申請詳情參見 華為訊息分類管理方案。

• 若應用沒有自分類權益，則應用的推送訊息將通過智能分類進行自動歸類。

• 若應用有自分類權益，將信任開發人員提供的分類資訊，訊息不經過智能分類。

在 mPaaS MPS 上對接華為訊息分類傳參枚舉（thirdChannelCategory.hms）

在 mPaaS MPS 上對接 HMS 訊息提醒等級傳參枚舉（notifyLevel.hms）

傳參樣本

榮耀分類

廠商針對訊息分類的說明

根據訊息內容，華為推送將通知分類為 服務與通訊、資訊營銷 兩大類別，具體如下：

分類方式

訊息智能分類

智能分類演算法將根據您發送的內容等多個維度因素，自動將您的訊息按照分類標準進行歸類。

訊息自分類

允許開發人員根據訊息分類規範，自行對訊息進行分類。

在 mPaaS MPS 上對接榮耀訊息分類傳參枚舉（thirdChannelCategory.honor）

傳參樣本

小米訊息分類

廠商針對訊息分類的說明

根據《小米推送訊息分類新規》，小米推送將訊息分為 私信訊息 和 公信訊息 兩個類別，若應用選擇不接入私信或公信，則會接入 預設 通道。

小米訊息分類申請

申請方式請參見小米官方文檔 channel 申請及接入方法。

在 mPaaS MPS 上對接小米訊息分類傳參樣本

vivo 訊息分類

廠商針對訊息分類的說明

• 通知開啟的有效使用者：應用整合的 push-sdk 訂閱成功，且裝置近 14 天內有連網的通知許可權開啟使用者。

• 通知開啟有效使用者數＜10000，則營運訊息量級預設為 10000。

• 通知開啟的有效使用者數及可發送營運訊息量級，可在推送營運後台查詢。

• 推送限額數以 到達量 計算，當日到達量超限則計入管控。

在 mPaaS MPS 上對接 vivo 二級訊息分類傳參枚舉（thirdChannelCategory.vivo）

在 mPaaS MPS 上對接 vivo 訊息分類傳參樣本

MPS 對接廠商訊息分類 Java 範例程式碼

廠商訊息分類推送參數推薦都上傳，MPS 會根據裝置類型進行對應廠商分類參數的封裝。

import com.alibaba.fastjson.JSON;
import com.aliyun.mpaas20201028.Client;
import com.aliyun.mpaas20201028.models.PushSimpleRequest;
import com.aliyun.mpaas20201028.models.PushSimpleResponse;
import com.aliyun.teaopenapi.models.Config;
import java.util.HashMap;
import java.util.Map;

public static void main(String[] args) throws Exception {
    // 阿里雲帳號AccessKey擁有所有API的存取權限，建議您使用RAM使用者進行API訪問或日常營運。
    // 強烈建議不要把AccessKey ID和AccessKey Secret儲存到工程代碼裡，否則可能導致AccessKey泄露，威脅您帳號下所有資源的安全。
    // 本樣本以將AccessKey ID和AccessKey Secret儲存在環境變數為例說明。您也可以根據業務需要，儲存到設定檔裡。
    // 建議先完成環境變數配置
    Config config = new Config();
    // 必填，您的 AccessKey ID
    config.setAccessKeyId(System.getenv("MPAAS_AK_ENV"));
    // 必填，您的 AccessKey Secret
    config.setAccessKeySecret(System.getenv("MPAAS_SK_ENV"));
    // mPaaS 的 REGION_ID 和 Endpoint,以杭州非金為例
    config.setRegionId("cn-hangzhou");
    config.setEndpoint("mpaas.cn-hangzhou.aliyuncs.com");
    Client client = new Client(config);

    // Create an API request and set parameters
    PushSimpleRequest request = new PushSimpleRequest();
    request.setAppId("ONEX570DA89211721");
    request.setWorkspaceId("default");
    request.setTenantId("xxx");
    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);

    Map<String,String> target = new HashMap<String, String>();
    String msgKey = String.valueOf(System.currentTimeMillis());
    target.put("push_test",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");
    request.setThirdChannelCategory(map);
    // 封裝小米訊息分類
    request.setMiChannelId("miChannelIdTest");
    // 封裝OPPO訊息分類
    request.setChannelId("channelIdTest");

    // Initiate the request and handle the response or exceptions
    PushSimpleResponse response = client.pushSimple(request);
    System.out.println(JSON.toJSONString(response));
}