Mobile Platform as a Service：建立訊息 - 極簡推送

極簡推送指標對單個推送目標推送一條訊息。採用該推送方式進行訊息推送時，您既可以自訂訊息內容，也可以使用預先建立的訊息模板。

自訂訊息內容適用於對少數幾個目標進行推送的情境，比如測試蘋果推送認證的有效性，Android 推送 SDK 接入的正確性等。訊息模板適用於對多個目標進行多次推送的情境，即可以在自動化或大範圍使用模板功能之前，通過在控制台頁面建立模板推送類型的訊息進行模板功能的校正和測試。

下面主要介紹如何通過控制台建立極簡推送類型的訊息。

前置條件

• 對 iOS 裝置進行訊息推送前，確保已完成訊息推送 iOS SDK 接入，並通過控制台的 通道配置 頁面配置好蘋果裝置的推送認證，具體操作參見 配置 iOS 推送通道。

• 使用 Android 廠商通道進行訊息推送前，確保已完成訊息推送 Android SDK 接入，接入相應的廠商通道，並通過控制台的 通道配置 頁面完成相應的推送通道配置，具體操作參見 配置 Android 推送通道。

操作步驟

1. 登入 mPaaS 控制台，選擇目標應用後，從左側導覽列進入 訊息推送 > 訊息管理 頁面。

2. 單擊 建立訊息推送任務 按鈕，在彈出的訊息推送任務建立視窗中，選擇 極簡推送 標籤。

3. 在極簡推送標籤頁上，配置推送訊息的基礎資訊。各配置項說明如下：

   參數	是否必填	說明
   訊息類型：是否靜默	是	是否展示訊息： 是：表示靜默訊息，即使用者對訊息無感知，在目標裝置上不以任何形式展示的訊息。 否：指在通知欄展示訊息。 對於 Android 推送平台，需要根據不同的推送通道，執行不同後續操作： 自建通道：本參數作為參考欄位發送至用戶端，您需要解析訊息體，在擷取本欄位內容後，根據需求控制訊息的展示。 廠商通道：本參數作為欄位發送至目標裝置後，由廠商系統解析欄位內容並控制訊息的展示，您無需執行其他動作。 對於 iOS 推送平台，訊息的展示為廠商系統行為，無需執行其他動作。
   訊息內容建立方式	是	支援兩種建立方式： 建立：自訂訊息內容，包括訊息標題、本文以及展示樣式。 使用模板：使用事先建立好的推送模板。
   推送模板	是	選擇訊息模板，可選當前應用的 訊息模板 頁面上列表中的所有模板。 說明 僅當訊息內容建立方式為 使用模板 時需要配置。
   模板預留位置	是	填寫模板中的變數值。系統根據所選模板中的預留位置，提供配置入口。
   推送維度	是	選擇訊息下發模式，可選擇： 使用者維度：基於使用者標識推送訊息。需要調用綁定介面，綁定使用者標識和裝置標識，綁定介面說明參見 用戶端 API。 Android 維度：基於 Android 裝置標識推送訊息。 iOS 維度：基於 iOS 裝置標識推送訊息。
   使用者/裝置標識	是	根據所選的推送維度，填寫相應的使用者標識或裝置標識。 當推送維度為 Android 維度時，填寫 Ad-token。 當推送維度為 iOS 維度時，填寫 Device Token。 當推送維度為使用者維度時，填寫使用者標識，即使用者調用綁定介面時傳入的 userid 值。 若通過日誌等途徑擷取的裝置標識包含空格，您需要刪除其中的空格。
   安卓訊息通道推送優先順序	是	僅針對 Android 推送平台，可選擇： 優先廠商通道：優先使用廠商通道推送訊息。對於已接入的廠商通道，訊息走對應的廠商通道服務；對於未接入的廠商通道，訊息走 MPS 自建通道。 MPS 通道：使用 MPS 自建通道推送訊息。 對於 Android 推送平台，本參數為 MPS 通道和廠商通道推送的選擇入口。對於 iOS 推送平台，您無需配置本參數（iOS 推送為廠商通道推送）。
   展示樣式	是	訊息在用戶端的展示樣式，支援預設（小文本）、大文本、圖文三種樣式。 預設：該樣式展示的內容包含推送標題和文本，適用於內容簡潔明了的訊息。訊息文本長度建議不超過 100 個字元（包括自訂參數和符號）。 大文本：該樣式展示的內容包含推送標題和文本，適用於文字內容較多的訊息（例如資訊類、新聞類訊息），讓使用者無需開啟應用，也能快速擷取資訊。訊息文本長度建議不超過 256 個字元（包括自訂參數和符號）。 圖文：該樣式支援訊息中帶表徵圖和大圖，適用於除普通文本之外更豐富的內容。出於展示效果考慮，建議訊息文本長度不超過兩行。 說明 僅當訊息內容建立方式為 建立 時需要配置。
   推送標題	是	填寫訊息的標題。在 建立推送訊息 文字框右側的預覽地區，可預覽訊息下發後的展示效果。 說明 僅當訊息內容建立方式為 建立 時需要配置。
   推送內容	是	填寫訊息的常值內容。在 建立推送訊息 文字框右側的預覽地區，可預覽訊息下發後的展示效果。 說明 僅當訊息內容建立方式為 建立 時需要配置。
   訊息表徵圖	否	展示在通知欄訊息內容右側的訊息表徵圖，支援 jpg、jpeg、png 格式的圖片。此處填寫公網可訪問的表徵圖物料 URL 地址。若各廠商通道未上傳相應的物料，僅上傳預設物料 URL時，系統會自動拉取預設物料去支援各廠商通道的表徵圖顯示，但因為各廠商通道對物料要求不盡相同，為避免效果不好，建議按各通道要求分別上傳物料。 預設表徵圖：建議尺寸為 140 * 140px，大小 50 KB 以內 OPPO 通道表徵圖：建議尺寸為 140 * 140px，大小 50 KB 以內 小米通道表徵圖：建議尺寸為 120 * 120px，大小 50 KB 以內 華為通道表徵圖：建議尺寸為 40 * 40dp，大小 512 KB 以內 FCM 表徵圖：無明確配置要求，系統自動拉取預設表徵圖適配。 說明 僅當訊息內容建立方式為 建立 且展示樣式為 圖文 時需要配置。
   訊息大圖	否	展示在通知欄訊息內容下方的圖片。此處填寫公網可訪問的大圖物料 URL 地址。若各廠商通道未上傳相應的物料，僅上傳預設物料 URL 時，系統會自動拉取預設物料去支援各廠商通道的大圖顯示，但因為各廠商通道對物料要求不盡相同，為避免效果不好，建議按各通道要求分別上傳物料。 預設大圖：建議尺寸為 876 * 324px，大小 1 MB 以內，支援 jpg、jpeg、png 格式 OPPO 通道大圖：建議尺寸為 876 * 324px，大小 1 MB 以內，支援 jpg、jpeg、png 格式 小米通道大圖：建議尺寸為 876 * 324px，大小 1 MB 以內，支援 jpg、jpeg、png 格式 iOS 大圖：由使用者自訂圖片，無尺寸限制 FCM 大圖：無明確配置要求，系統自動拉取預設表徵圖適配。 說明 僅當訊息內容建立方式為 建立 且展示樣式為 圖文 時需要配置。
   推送時間	是	選擇何時推送訊息： 立即：推送時間為目前時間，即訊息推送任務建立完成後立即推送。 定時：在指定時間推送訊息。例如，指定在 6.19 日早上 8:00 推送訊息。 迴圈：在指定時間範圍內重複迴圈推送訊息，例如指定在 6.1 ~ 9.30 期間，每周五早上 8:00 推送訊息。

   對話方塊右側地區為 推送預覽 地區。點擊 通知、蘋果訊息體、安卓訊息體，可分別預覽訊息的展示效果以及下發至不同平台的訊息體。

4. （選填）根據實際需要，配置進階資訊。在進階資訊配置地區，完成以下配置：

   • 點擊後跳轉：選擇在手機上點擊訊息內容後的操作。本參數僅作為參考欄位發送至用戶端，您需要參考欄位內容，根據需求實現後續操作。

     • 用戶端自訂：點擊訊息後，頁面跳轉至原生頁面。

     • 網頁：點擊訊息後，頁面跳轉至網頁。

   • 跳轉地址：在手機上點擊訊息後訪問的頁面。根據 點擊後跳轉 選項，填寫具體的頁面地址：

     • 如果是 用戶端自訂，填寫需要訪問的原生頁面地址（Android：ActivityName；iOS：VCName）。

     • 如果是 網頁：填寫需要訪問的網頁地址。

   • 自訂訊息 ID：系統自動產生，用於在業務方系統中唯一標識訊息。支援自訂，最多可輸入 64 個字元。

     說明

     僅當選擇訊息類型為靜默時需要配置自訂 ID。

   • 訊息有效期間：設定訊息的有效期間，單位為秒。由於裝置未線上或者使用者登出導致訊息下發失敗時，在訊息有效期間內，裝置建連或發起使用者綁定請求後，MPS 將重新下發訊息，確保訊息觸達率。如不設定，則預設有效期間為 180 秒。

     說明

     訊息有效期間不能短於 180 秒，也不得超過 72 小時。

   • 擴充參數：開啟 擴充參數 開關，點擊 增加參數 按鈕，在 key/value 配置地區中配置 key/value 後，在頁面任意地區處點擊滑鼠左鍵，完成配置。擴充參數會跟隨訊息體到達用戶端，供使用者自訂處理。擴充參數包含以下三類：

     • 系統擴充參數

       這類擴充參數被系統佔用，參數值不可修改。參數包括 notifyType、action、silent、pushType、templateCode、channel、taskId。

     • 系統具有一定意義的擴充參數

       這類擴充參數被系統佔用，且具有一定的意義，您可以配置此類擴充參數的參數值。系統具有一定意義的擴充參數及其說明參見下表。

       參數	說明
       sound	自訂鈴聲，參數值配置為鈴聲的路徑。該參數僅對小米和蘋果手機有效。
       badge	應用表徵圖角標，參數值配置為具體數值。該參數會跟隨訊息體到達用戶端。 對於 Android 手機，您需要處理角標的實現邏輯。 對於蘋果手機，手機系統將自動實現角標。訊息推送至目標手機後，應用表徵圖的角標即會顯示為所配置的參數值。
       mutable-content	APNs 自訂推送標識，推送的時候攜帶本參數即表示支援 iOS10 的 UNNotificationServiceExtension；若不攜帶本參數，則為普通推送。參數值配置為 1。
       badge_add_num	華為通道推送角標增加數。
       badge_class	華為通道案頭表徵圖對應的應用入口 Activity 類。
       big_text	大文本樣式，參數值固定為 1，填寫其他值無效。本參數僅對小米和華為手機有效。

     • 使用者自訂擴充參數

       除了系統擴充參數和系統具有一定意義的擴充參數，其他的參數（key）都屬於使用者擴充參數。使用者自訂擴充參數會隨訊息體中的擴充參數到達用戶端，供使用者自訂處理。

5. 點擊 提交 按鈕完成建立。建立的訊息將展示在極簡訊息記錄列表中。

   除了通過控制台推送訊息外，還支援通過調用 API 推送訊息。具體操作，參見 服務端 API 說明。

相關操作

• 建立訊息 - 批量推送

• 管理極簡推送訊息

• 管理定時推送任務