建立推播

本文旨在指導用戶如何在 Engagelab 控製台上建立通知訊息。

建立通知訊息

進入【推播】-【建立推播】-【通知訊息】頁面建立推播任務，參數配置說明如下：

基礎設定

• 目標平台：根據集成 SDK 的平台，選擇需要推播的平台。
  • 選擇平台前需在【推播設定】中設定對應的平台。
  • 子賬號僅支持選擇主賬號授權的平台。
• 通知標題：推播訊息的標題，請盡量避免“test、測試、純數字” 等無意義內容，否則可能會被廠商攔截而無法接收到通知訊息。
• 通知內容：推播訊息的內容，請盡量避免“test、測試、純數字” 等無意義內容，否則可能會被廠商攔截而無法接收到通知訊息。
• 傳送時間：選擇需要傳送的時間
  • 立即：立即下發訊息。
  • 定時：傳送時間隻能設定當前時間 3 分鍾以後的時間，並且定時任務不能超過一年。
• 定速推播：在設定時間內完成推播，降低服務器壓力。
• 點按通知開啟：點按通知後的動作。
  • 直接打開應用程式。
  • intent（推薦），格式為：intent:#Intent;action=action path;component=packagename/ Activity path;end

進階設定 (可選)

• 離線訊息保留時長：可以通過該值指定離線訊息的時長。如果該用戶當前不在線，則會保存為離線訊息，待該用戶下次上線時繼續推播給他。即在該時長範圍內用戶上線會繼續收到推播，否則過期。
  • 預設時長為 1 天。
  • 設定為 0，則表示不保留離線訊息，即隻有當前在線的用戶才可以收到，所有不在線的都不會收到。
• 附加欄位：客戶端獲取附加字段內容，用於客戶端自訂事件處理。支持增加、刪除附加參數。

Android 配置

• 廠商通道狀態：完成了對應的廠商通道集成和配置後，對應通道的廠商通道狀態會高亮。
• 通知傳送策略：可以指定廠商通道和 Engagelab 通道的優先下發策略，選擇廠商策略時，需確保廠商通道已配置成功。
• 通知欄樣式：不同於 MTPush SDK 內置的通知欄樣式，這裏的通知欄樣式是用係統 api 來構建的三種常用樣式，詳情點選“？”查看說明。在 MTPush Android SDK 3.0.1 及以後版本支持。
  • 自訂樣式：在客戶端可設定多套樣式指定不同的編號，服務器端推播時指定編號就可以展現時使用之前設定的樣式。這個值預設值為 0，即使用預設的樣式。
• 通知欄圖示：通知欄右側圖示。
  • 預設 logo：通知欄展示應用程式預設的圖示。
  • 指定圖示路徑：通知欄展示指定路徑的圖示。圖片可以為 http 或 https 開頭的網路資源，或 drawable 資源檔案夾路徑。

• 通知提醒範本：可以設定通知的提醒優先級，避免頻繁打擾客戶。預設選擇“常規提醒範本”，範本包含範本名稱、通路名稱、通路 ID、通知優先級、通知類別、通知提醒類型、提示音設定。
  • 常規提醒範本：通知優先級為 “PRIORITY_DEFAULT”，通知提醒類型為“提示音 | 震動 | 指示燈”。
  • 無感知提醒範本：通知優先級為 “PRIORITY_LOW”，通知提醒類型為“指示燈”。
  • 強提醒範本：通知優先級為 “PRIORITY_HIGH”，通知提醒類型為“提示音 | 震動 | 指示燈”。
  • 點選“新建訊息提醒範本”可以自訂提醒範本。
    • 渠道 ID：針對 Android 8.0 及之後係統通知通路特性功能，推播需要指定通知通路 ID。
    • 通知優先級：該優先級僅對 Engagelab 通道生效，預設的 priority 屬性設定為 PRIORITY_DEFAULT，官方描述見 開發者文檔。在 MTPush Android SDK 3.0.1 及以後版本生效。
    • 通知類別：係統可能會用通知的 category 屬性來做在通知欄的排序或者過濾。在 MTPush Android SDK 3.0.1 及以後版本生效，官方描述見 開發者文檔。
    • 通知提醒類型：開發者可勾選對應的項來指定通知送達時在手機上的提醒類型，但不能越過係統的限製，比如手機的聲音要是開著的，振動是允許的，有 LED 指示燈並且是可開啓的狀態。在 MTPush Android SDK 3.0.3 及以後版本生效。
• 角標數字：應用程式圖示右上角的角標。
  • 此屬性目前僅針對華為 EMUI 8.0 及以上、小米 MIUI 6 及以上設備生效，在 MTPush Android SDK 3.3.6 及以後版本支持。
  • 此字段如果不填，表示不改變角標數字（小米設備由於係統控製，不論推播走 Engagelab 通道下發還是廠商通道下發，即使不傳遞依舊是預設 +1 的效果。）；否則下一條通知欄訊息配置的 badge_add_num 數據會和之前角標數量進行增加。建議 badge_add_num 配置為 1；舉例：badge_add_num 配置 1，應用程式之前角標數為 2，傳送此角標訊息後，應用程式角標數顯示為 3。

iOS 配置

• silent_push：content-available: 1，不攜帶任何 badge，sound 和訊息內容等參數，可以在不打擾用戶的情況下進行內容更新等操作，參考“Silent Remote Notifications”。
• 通知子標題：該字段僅針對 iOS 10 以上的係統版本。Android 平台和 iOS 其他係統版本不受該字段內容影響。
• content-available（推播喚醒）：iOS 7 開始新增特性，此處開啓說明是 Background Remote Notification，如果不啓用則是普通的 Remote Notification。詳情參考：Background Remote Notification”。
• mutable-content：iOS 10 開始新增的特性功能，此處開啓說明支持 iOS 10 的 UNNotificationServiceExtension 特性，如果不開啓則是普通的 Remote Notification。詳情參考：UNNotificationServiceExtension”。
• apns-collapse-id (通知更新標識) ：通知攜帶 collapse id 參數，將會覆蓋掉通知中心裏攜帶相同 collapse id 的通知。collapse id 的值不可超過 64 bytes , 該字段詳細介紹參考 APNs Guide。

• 通知訊息範本：可以設定通知的提醒優先級，避免頻繁打擾客戶。預設選擇“常規提醒範本”，範本包含範本名稱、通知類型、sound、volume、critical、category、thread-id、interruption-level。
  • 常規提醒範本：通知類型為“通知類型”，sound 為 “預設通知”，interruption-level 為 “active”。
  • 無感知提醒範本：通知類型為“通知類型”，sound 為 “無聲”，interruption-level 為 “passive”。
  • 點選“新建訊息提醒範本”可以自訂提醒範本。
    • 普通通知：通過 sound 字段指定聲音。預設為 default，即係統預設聲音。 如果設定為空值，則為靜音。如果設定為特殊的名稱，則需要你的 App 裏配置了該聲音才可以正常。
    • 示警通知：需要推播告警通知的應用程式需要前往 Apple 開發者官網 申請權限。
    • category：iOS 分類，隻有 iOS 8 及以上係統才支持此參數推播。
    • thread-id：用於對通知分組的特定於應用程式的標識符，同一個 thread-id 的通知歸為一組。
    • interruption-level：用於定義通知優先級和交付時間的中斷級別。
• 角標數字: 可指定 APNs 推播通知的 badge，直接展示在桌面應用程式圖示的右上角，含義是應用程式未讀的訊息數，也可以進行角標 +N/-N，例：接受者 A，B 的角標分別為 1 和 2，那麼推播 +2 後 A 的角標變為 3，B 的角標變為 4。係統預設值為 1。

目標群體

選擇目標：需要推播的目標群體，測試時建議使用註冊日誌中獲取的 registrationID 進行推播。

• 廣播 (所有人)：將向應用程式所有目前已註冊、未來註冊的線上用戶推播此圍欄。
• registrationID：一次推播最多 1000 個。

傳送預覽

配置推播參數後，點選傳送預覽，可以查看配置的推播參數和預估推播人數。

確認傳送參數，點選確認即可成功建立推播任務。

如果冇有滿足條件的推播目標，會返回以下錯誤：

建立自訂訊息

進入【建立推播】-【自訂訊息】頁面建立推播任務，參數配置說明參考 建立通知訊息。