全部產品
Search
文件中心

Mobile Platform as a Service:建立訊息 - 批量推送

更新時間:Jul 13, 2024

重要

即日起,mPaaS 訊息推送將使用新版控制台。在新控制台介面上,建立訊息推送視窗提供的推送方式由之前的極簡推送、模板推送、批量推送、群發推送四種整合最佳化為極簡推送、批量推送兩種。重構後,現極簡推送方式覆蓋了原極簡推送和模板推送功能;現批量推送方式覆蓋了原批量推送和群發推送功能。

批量推送指對大量目標進行訊息推送,通常用來支援一些營運需求。

批量推送分為以下兩種類型:

  • 全網推送:對全網 Android 或 iOS 裝置推送相同的模板訊息,僅支援按裝置維度推送。對 Android 裝置進行群發訊息時,所有在訊息有效期間內建連的 Android 裝置都將收到訊息;對 iOS 裝置進行群發訊息時,所有在訊息有效期間內處於綁定狀態的 iOS 裝置都將收到訊息。

  • 非全網推送:對指定人群推送相同的模板訊息。支援手動上傳人群、自訂推送人群或直接調用移動分析人群做為推送人群。

說明
  • 由於需要人工在頁面上進行操作,故建議在系統驗證、營運支援以及緊急臨時需求等小頻次推送情境下,通過控制台頁面推送訊息。

  • 訊息一旦建立成功即進行推送,您將無法刪除或修改。

下面主要介紹如何通過控制台建立批量推送訊息。

前置條件

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

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

  • 建立批量推送訊息之前,需要先建立好模板,操作參見 建立模板

  • 建立批量推送訊息時,若選擇調用移動分析人群做為目標推送人群,則需要事先建立好移動分析人群,具體操作參見 建立使用者群組。若選擇使用者標籤人群做為目標推送人群,則需要事先建立使用者標籤人群,具體操作參見 建立使用者標籤

操作步驟

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

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

  3. 在批量推送標籤頁上,配置推送訊息的基礎資訊。各配置項說明如下:

    參數

    是否必填

    說明

    訊息類型:是否靜默

    是否展示訊息:

    • 是:表示靜默訊息,即使用者對訊息無感知,在目標裝置上不以任何形式展示的訊息。

    • 否:指在通知欄展示訊息。

    對於 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 推送訊息。

    重要

    當推送目標為移動分析人群或自訂標籤人群時,不支援定時和迴圈推送。

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

  4. (選填)根據實際需要,配置進階資訊。在進階資訊配置地區,完成以下配置:

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

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

      • 網頁:點擊訊息後,頁面跳轉至網頁。

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

      • 如果是 用戶端自訂,填寫需要訪問的原生頁面地址(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)都屬於使用者擴充參數。使用者自訂擴充參數會隨訊息體中的擴充參數到達用戶端,供使用者自訂處理。

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

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

相關操作