即日起,mPaaS 消息推送將使用新版控制臺。在新控制臺界面上,創建消息推送窗口提供的推送方式由之前的極簡推送、模板推送、批量推送、群發推送四種整合優化為極簡推送、批量推送兩種。重構后,現極簡推送方式覆蓋了原極簡推送和模板推送功能;現批量推送方式覆蓋了原批量推送和群發推送功能。
極簡推送指針對單個推送目標推送一條消息。采用該推送方式進行消息推送時,您既可以自定義消息內容,也可以使用預先創建的消息模板。
自定義消息內容適用于對少數幾個目標進行推送的場景,比如測試蘋果推送證書的有效性,Android 推送 SDK 接入的正確性等。消息模板適用于對多個目標進行多次推送的場景,即可以在自動化或大范圍使用模板功能之前,通過在控制臺頁面創建模板推送類型的消息進行模板功能的校驗和測試。
消息一旦創建成功即進行推送,您將無法刪除或修改。
由于需要人工在頁面上進行操作,建議在系統驗證、運營支持以及緊急臨時需求等小頻次推送場景下,通過控制臺頁面推送消息。
下面主要介紹如何通過控制臺創建極簡推送類型的消息。
前置條件
對 iOS 設備進行消息推送前,確保已完成消息推送 iOS SDK 接入,并通過控制臺的 通道配置 頁面配置好蘋果設備的推送證書,具體操作參見 配置 iOS 推送通道。
對鴻蒙設備進行消息推送前,確保已完成消息推送 鴻蒙 SDK 接入,并通過控制臺的 通道配置 頁面配置好鴻蒙設備的推送證書,具體操作參見 配置 HarmonyOS 推送通道。
使用 Android 廠商通道進行消息推送前,確保已完成消息推送 Android SDK 接入,接入相應的廠商通道,并通過控制臺的 通道配置 頁面完成相應的推送通道配置,具體操作參見 配置 Android 推送通道。
操作步驟
登錄 mPaaS 控制臺,選擇目標應用后,從左側導航欄進入 消息推送 > 消息管理 頁面。
單擊 創建消息推送任務 按鈕,在彈出的消息推送任務創建窗口中,選擇 極簡推送 標簽。
在極簡推送標簽頁上,配置推送消息的基礎信息。各配置項說明如下:
參數
是否必填
說明
消息類型:是否靜默
是
是否展示消息:
是:表示靜默消息,即用戶對消息無感知,在目標設備上不以任何形式展示的消息。
否:指在通知欄展示消息。
對于 Android 推送平臺,需要根據不同的推送通道,執行不同后續操作:
自建通道:本參數作為參考字段發送至客戶端,您需要解析消息體,在獲取本字段內容后,根據需求控制消息的展示。
廠商通道:本參數作為字段發送至目標設備后,由廠商系統解析字段內容并控制消息的展示,您無需執行其他操作。
對于 iOS 和鴻蒙推送平臺,消息的展示為廠商系統行為,無需執行其他操作。
消息內容創建方式
是
支持兩種創建方式:
新建:自定義消息內容,包括消息標題、正文以及展示樣式。
使用模板:使用事先創建好的推送模板。
推送模板
是
選擇消息模板,可選當前應用的 消息模板 頁面上列表中的所有模板。
說明僅當消息內容創建方式為 使用模板 時需要配置。
模板占位符
是
填寫模板中的變量值。系統根據所選模板中的占位符,提供配置入口。
推送維度
是
選擇消息下發模式,可選擇:
用戶維度:基于用戶標識推送消息。需要調用綁定接口,綁定用戶標識和設備標識,綁定接口說明參見 客戶端 API。
Android 維度:基于 Android 設備標識推送消息。
iOS 維度:基于 iOS 設備標識推送消息。
鴻蒙維度:基于鴻蒙設備標識推送消息。
用戶/設備標識
是
根據所選的推送維度,填寫相應的用戶標識或設備標識。
當推送維度為 Android 維度時,填寫 Ad-token。
當推送維度為 iOS 維度時,填寫 Device Token。
當推送維度為鴻蒙維度時,填寫 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 大圖:無明確配置要求,系統自動拉取默認圖標適配。
鴻蒙通道大圖:建議尺寸小于 25000px,支持 png、jpg、jpeg、heif、gif、bmp 格式。
說明僅當消息內容創建方式為 新建 且展示樣式為 圖文 時需要配置。
推送時間
是
選擇何時推送消息:
立即:推送時間為當前時間,即消息推送任務創建完成后立即推送。
定時:在指定時間推送消息。例如,指定在 6.19 日早上 8:00 推送消息。
循環:在指定時間范圍內重復循環推送消息,例如指定在 6.1 ~ 9.30 期間,每周五早上 8:00 推送消息。
對話框右側區域為 推送預覽 區域。單擊 通知、蘋果消息體、安卓消息體 和 鴻蒙消息體,可分別預覽消息的展示效果以及下發至不同平臺的消息體。
(選填)根據實際需要,配置高級信息。在高級信息配置區域,完成以下配置:
單擊后跳轉:選擇在手機上單擊消息內容后的操作。本參數僅作為參考字段發送至客戶端,您需要參考字段內容,根據需求實現后續操作。
客戶端自定義:單擊消息后,頁面跳轉至原生頁面。
網頁:單擊消息后,頁面跳轉至網頁。
跳轉地址:在手機上單擊消息后訪問的頁面。根據 單擊后跳轉 選項,填寫具體的頁面地址:
如果是 客戶端自定義,填寫需要訪問的原生頁面地址(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)都屬于用戶擴展參數。用戶自定義擴展參數會隨消息體中的擴展參數到達客戶端,供用戶自定義處理。
短信補充服務:針對因網絡問題、App 后臺禁止運行、消息延遲等原因導致用戶無法收到 App 推送的消息的情況,通過短信通道進行消息補發。啟用短信補充服務后,需要設置短信簽名、模板以及補發策略。
說明目前,僅杭州非金融區提供短信補充服務。
首次使用短信補充服務時,請先前往 短信補充服務 頁面,按照操作提示開通短信服務。具體操作,參見 使用短信補充服務 說明文檔。
短信簽名:短信中的個性化簽名,需要通過短信服務控制臺配置。
短信模板:即具體發送的短信內容,需要通過短信服務控制臺配置。
短信補充策略:提供并發和補發兩種策略。
并發:指同時使用 App 消息推送和短信推送通道推送消息,實現特定消息在多通道的并行下發,適用于重要消息的大規模群發。
補發:指對 App 消息推送未觸達的用戶通過短信的方式進行消息補發,以提升消息觸達率。
短信模板變量:如果選擇的短信模板包含有變量,則需要指定變量的實際值。短信服務會自動用實際值替換模板中的變量,并發生短信。
單擊 提交 按鈕完成創建。創建的消息將展示在極簡消息記錄列表中。
除了通過控制臺推送消息外,還支持通過調用 API 推送消息。具體操作,參見 服務端 API 說明。