即日起,mPaaS 訊息推送將使用新版控制台。在新控制台介面上,建立訊息推送視窗提供的推送方式由之前的極簡推送、模板推送、批量推送、群發推送四種整合最佳化為極簡推送、批量推送兩種。重構後,現極簡推送方式覆蓋了原極簡推送和模板推送功能;現批量推送方式覆蓋了原批量推送和群發推送功能。
批量推送指對大量目標進行訊息推送,通常用來支援一些營運需求。
批量推送分為以下兩種類型:
全網推送:對全網 Android 或 iOS 裝置推送相同的模板訊息,僅支援按裝置維度推送。對 Android 裝置進行群發訊息時,所有在訊息有效期間內建連的 Android 裝置都將收到訊息;對 iOS 裝置進行群發訊息時,所有在訊息有效期間內處於綁定狀態的 iOS 裝置都將收到訊息。
非全網推送:對指定人群推送相同的模板訊息。支援手動上傳人群、自訂推送人群或直接調用移動分析人群做為推送人群。
由於需要人工在頁面上進行操作,故建議在系統驗證、營運支援以及緊急臨時需求等小頻次推送情境下,通過控制台頁面推送訊息。
訊息一旦建立成功即進行推送,您將無法刪除或修改。
下面主要介紹如何通過控制台建立批量推送訊息。
前置條件
對 iOS 裝置進行訊息推送前,確保已完成訊息推送 iOS SDK 接入,並通過控制台的 通道配置 頁面配置好蘋果裝置的推送認證,具體操作參見 配置 iOS 推送通道。
使用 Android 廠商通道進行訊息推送前,確保已完成訊息推送 Android SDK 接入,接入相應的廠商通道,並通過控制台的 通道配置 頁面完成相應的推送通道配置,具體操作參見 配置 Android 推送通道。
建立批量推送訊息之前,需要先建立好模板,操作參見 建立模板。
建立批量推送訊息時,若選擇調用移動分析人群做為目標推送人群,則需要事先建立好移動分析人群,具體操作參見 建立使用者群組。若選擇使用者標籤人群做為目標推送人群,則需要事先建立使用者標籤人群,具體操作參見 建立使用者標籤。
操作步驟
登入 mPaaS 控制台,選擇目標應用後,從左側導覽列進入 訊息推送 > 訊息管理 頁面。
單擊 建立訊息推送任務 按鈕,在彈出的訊息推送任務建立視窗中,選擇 批量推送 標籤。
在批量推送標籤頁上,配置推送訊息的基礎資訊。各配置項說明如下:
參數
是否必填
說明
訊息類型:是否靜默
是
是否展示訊息:
是:表示靜默訊息,即使用者對訊息無感知,在目標裝置上不以任何形式展示的訊息。
否:指在通知欄展示訊息。
對於 Android 推送平台,需要根據不同的推送通道,執行不同後續操作:
自建通道:本參數作為參考欄位發送至用戶端,您需要解析訊息體,在擷取本欄位內容後,控制訊息的展示。
廠商通道:本參數作為欄位發送至目標裝置後,由廠商系統解析欄位內容並控制訊息的展示,您無需執行其他動作。
對於 iOS 推送平台,訊息的展示為廠商系統行為,無需執行其他動作。
批量推送方式
是
選擇訊息下發模式,可選擇:
使用者維度推送:基於使用者標識推送訊息。需要調用綁定介面,綁定使用者標識和裝置標識,綁定介面說明參見 用戶端 API。
裝置維度推送:基於裝置標識推送訊息。
推送平台
是
基於裝置維度推送訊息時,需要選擇推送平台,明確推送裝置類型。
Android:提供安卓廠商通道和 MPS 自建通道,對全網(在訊息有效期間內)線上的或者指定的 Android 裝置推送訊息,對每個裝置僅推送一次,不重複推送。
iOS:使用廠商通道,對全網或指定的 iOS 用戶端使用者推送訊息,對每個使用者僅推送一次,不重複推送。
推送目標
是
當為使用者推送維度時,可選擇:
手動上傳人群:手動上傳推送目標檔案,檔案內需包含推送目標 ID 以及針對所選模板對各推送目標的個人化配置。檔案內一條資料代表一條訊息,每條訊息使用業務方訊息 ID 進行標識。檔案格式要求如下:
每條資料格式為
使用者識別碼,業務方訊息 ID,預留位置1= XXX;預留位置2=XXX……
,其中業務方訊息 ID 由使用者自訂。檔案編碼類別型要求為 UTF-8,檔案大小上限為 200 MB,多條資料之間使用分行符號分隔,每條資料不要超過 250 字元。一個推送任務中最多可上傳 1 個檔案。
檔案上傳成功後,手動上傳人群 按鈕下方將顯示已上傳檔案的表徵圖,點擊表徵圖,可對檔案中的內容進行預覽,最多可預覽 10 條資料。
移動分析人群:調用移動分析人群,對所選移動分析人群推送相同訊息。需要先建立移動分析使用者群組,操作方法參見 建立使用者群組。當所選推送模板中包含預留位置時,移動分析人群不可選。
使用者標籤:根據使用者標籤選擇人群。選擇已打上標籤的人群之前,需要先 建立使用者標籤。
當為裝置推送維度時,可選擇:
所有裝置:對所選平台的所有裝置進行推送。
批量帳號:手動上傳推送目標檔案,檔案內需包含推送目標 ID 以及針對所選模板對各推送目標的個人化配置。檔案內一條資料代表一條訊息,每條訊息使用業務方訊息 ID 進行標識。檔案格式要求如下:
每條資料格式為
裝置識別碼,業務方訊息 ID,預留位置1= XXX,預留位置2=XXX……
,其中業務方訊息 ID 由使用者自訂。檔案編碼類別型要求為 UTF-8,檔案大小上限為 200 MB,多條資料之間使用分行符號分隔,每條資料不要超過 250 字元。一個推送任務中最多可上傳 1 個檔案。
資料樣本:mpaas_push_demo,123456,title=111,content=222。
檔案上傳成功後,手動上傳人群 按鈕下方將顯示已上傳檔案的表徵圖,點擊表徵圖,可對檔案中的內容進行預覽,最多可預覽 10 條資料。
移動分析人群:調用移動分析人群,對所選移動分析人群推送相同訊息。您需要先建立移動分析使用者群組,操作方法參見 建立使用者群組。當所選推送模板中包含預留位置時,移動分析人群不可選。
推送模板
是
選擇訊息模板,可選當前應用的 訊息模板 頁面上的所有模板。
模板預留位置
是
填寫模板中的變數值。系統根據所選模板中的預留位置,提供配置入口。
安卓訊息通道推送優先順序
是
僅針對 Android 推送平台,可選擇:
優先廠商通道:優先使用廠商通道推送訊息。對於已接入的廠商通道,訊息走對應的廠商通道服務;對於未接入的廠商通道,訊息走 MPS 自建通道。
MPS 通道:使用 MPS 自建通道推送訊息。
對於 Android 推送平台,本參數為自建通道和廠商通道推送的選擇入口。對於 iOS 推送平台,您無需配置本參數(iOS 推送為廠商通道推送)。
推送時間
是
選擇何時推送訊息:
立即:推送時間為目前時間,即訊息推送任務建立完成後立即推送。
定時:在指定時間推送訊息。例如,指定在 6.19 日早上 8:00 推送訊息。
迴圈:在指定時間範圍內重複迴圈推送訊息,例如指定在 6.1 ~ 9.30 期間,每周五早上 8:00 推送訊息。
重要當推送目標為移動分析人群或自訂標籤人群時,不支援定時和迴圈推送。
對話方塊右側地區為 推送預覽 地區。點擊 通知、蘋果訊息體、安卓訊息體,可分別預覽訊息的展示效果以及下發至不同平台的訊息體。
(選填)根據實際需要,配置進階資訊。在進階資訊配置地區,完成以下配置:
點擊後跳轉:選擇在手機上點擊訊息內容後的操作。本參數僅作為參考欄位發送至用戶端,您需要參考欄位內容,實現後續操作。
用戶端自訂:點擊訊息後,頁面跳轉至原生頁面。
網頁:點擊訊息後,頁面跳轉至網頁。
跳轉地址:在手機上點擊訊息後訪問的頁面。根據 點擊後跳轉 選項,填寫具體的頁面地址:
如果是 用戶端自訂,填寫需要訪問的原生頁面地址(Android:ActivityName;iOS:VCName)。
如果是 網頁:填寫需要訪問的網頁地址。
推送登入狀態:根據使用者的登入狀態進一步圈定目標推送人群。指定登入/登出時段時,永久 表示對所有登入/登出的使用者推送訊息,沒有時間限制。
重要僅當群發/批量推送方式為裝置維度推送時,推送登入狀態可配置。
如選擇 登入使用者,將會對在指定時段內登入 App 的使用者推送訊息。例如,選擇登入時段為 15 天,則表示對最近 15 天內登入的使用者推送訊息。
如選擇 登出使用者,將會對在指定時段內登出 App 使用者推送訊息。例如,選擇登出時段為 15 天,則表示對最近 15 天內登出的使用者推送訊息。
如同時選擇 登入使用者 和 登出使用者,將會對在指定時段內登入和登出的使用者推送訊息。例如,選擇登入時段為永久,登出時段為 7 天,則表示對所有登入 App 的使用者以及最近 7 天內登出 App 的使用者推送訊息。
自訂 ID:系統自動產生,用於在業務方系統中唯一標識訊息。支援自訂,最多可輸入 64 個字元。
訊息有效期間:設定訊息的有效期間,單位為秒。由於裝置未線上或者使用者登出導致訊息下發失敗時,在訊息有效期間內,裝置建連或發起使用者綁定請求後,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)都屬於使用者擴充參數。使用者自訂擴充參數會隨訊息體中的擴充參數到達用戶端,供使用者自訂處理。
點擊 提交 按鈕完成建立。建立的訊息將展示在批量訊息記錄列表中。
除了通過控制台推送訊息外,還支援通過調用 API 推送訊息。具體操作,參見 服務端 API 說明。