如何設定 Android 推播策略

隨著廠商伺服器對廠商限額及 QPS 限制的逐步收緊，推播的抵達率與下發速度也受到相應影響。為了提升推播表現，EngageLab 提供「通知下發策略」功能，您可以在推播時自訂不同通道的下發優先順序，詳情請見下文說明。

通道說明

通知下發策略僅對 Android 平台已整合廠商通道的設備有效。整合廠商通道請參考：廠商通道 SDK 整合指南

通道類型	描述	支援裝置
EngageLab 通道	EngageLab 為自建長連線通道，需設備在線才能接收推播，離線時不會下發訊息。	所有已成功註冊 EngageLab 通道的 Android 裝置
廠商通道	原生系統通道，裝置即使離線也可收到推播。支援小米、華為、OPPO、vivo、魅族、FCM 等。	主流中國品牌手機與支援 FCM 的海外設備

Android 推播策略使用說明

服務端使用

推播下發時，在 options 欄位中設置 third_party_channel.distribution_new。若未設置，預設為 pns_mtpush。

distribution_new 欄位說明

欄位名稱	類型	是否必填	含義	補充說明
distribution_new	String	✅ 必填	在 EngageLab 與廠商通道並存時，指定推播優先順序	不可為空字串

可選值

值	說明
`mtpush`	僅使用 EngageLab 通道推播
`pns_mtpush`	優先使用廠商通道（小米 / 華為 / 魅族 / OPPO / vivo / 榮耀），失敗時 fallback 至 EngageLab
`mtpush_pns`	優先使用 EngageLab，若不在線則 fallback 至廠商通道
`fcm_mtpush`	優先使用 FCM，失敗時 fallback 至 EngageLab
`mtpush_fcm`	優先使用 EngageLab，若不在線則 fallback 至 FCM

⚠️ 注意事項：

當設備僅支援單一系統通道（如僅支援 FCM 或廠商通道）時，將忽略上述配置，直接使用可用的有效通道。

建議使用 fallback 策略（如 mtpush_pns 或 pns_mtpush），提升整體推播成功率。

推播請求範例

{ "third_party_channel": { "distribution_new": "pns_mtpush", "xiaomi": { "channel_id": "*******", "small_icon_uri": "http://f6.market.xiaomi.com/download/MiPass/x/x.png", "small_icon_color": "#ABCDEF" }, "huawei": { "importance": "NORMAL", "small_icon_uri": "https://xx.com/xx.jpg", "only_use_vendor_style": true }, "oppo": { "channel_id": "*******", "large_icon": "3653918_5f92b5739ae676f5745bcbf4" }, "vivo": { "pushMode": 0 } } }

              
              {
    "third_party_channel": {
        "distribution_new": "pns_mtpush",
        "xiaomi": {
            "channel_id": "*******",
            "small_icon_uri": "http://f6.market.xiaomi.com/download/MiPass/x/x.png",
            "small_icon_color": "#ABCDEF"
        },
        "huawei": {
            "importance": "NORMAL",
            "small_icon_uri": "https://xx.com/xx.jpg",
            "only_use_vendor_style": true
        },
        "oppo": {
            "channel_id": "*******",
            "large_icon": "3653918_5f92b5739ae676f5745bcbf4"
        },
        "vivo": {
            "pushMode": 0
        }
    }
}

此代碼塊在浮窗中顯示

控制台使用說明

進入【AppPush】-【建立推播】-【通知訊息】頁面，點選【Android 平台】-【進階設定】-【通知下發策略】，可選擇所需推播下發策略。

當前應用支援的廠商通道狀態將會顯示於界面中，僅對已整合廠商通道的裝置生效。

alt text

📊 推薦 Android 推播通道策略配置表（依裝置區域 + 系統支援能力）

以下表格根據裝置類型、地理區域與通道支援能力，提供推薦的推播策略，協助開發者判斷何時應優先使用 EngageLab、廠商通道或 FCM。

設備類型	所在地區	FCM 可達性	EngageLab 可達性及路徑	備註與建議
中國大陸版手機	中國大陸	所有品牌：均不可達。	可達。	強烈推薦集成 EngageLabAppPush服務（已集成主流廠商通道）。
	中國香港	所有品牌：均不可達。	可達；華為、榮耀、OPPO：通過廠商或者EngageLab通道可達；其他中國品牌（小米、魅族、vivo等）：通過 EngageLab 通道可達。	強烈推薦集成 EngageLabAppPush服務；華為、榮耀、OPPO 設備優先使用其廠商通道。
港版手機	中國香港	非中國品牌（如三星）：可達；華為港版：不可達；榮耀/OPPO港版及其他中國港版：需設備支持 FCM 才可達。	可達；華為港版：通過廠商或者EngageLab通道可達；榮耀/OPPO港版：通過廠商通道或 EngageLab 通道可達；其他中國港版/非中國品牌：通過 EngageLab 通道可達。	強烈推薦集成 EngageLabAppPush服務（已集成主流廠商通道）。華為港版必須使用廠商或者EngageLab通道；榮耀/OPPO港版可根據設備 FCM 支持情況選擇通道；其他品牌統一使用 EngageLab 通道。
	中國大陸	所有品牌：均不可達。	可達；華為/榮耀/OPPO港版：通過廠商通道或 EngageLab 通道可達；小米/魅族/vivo港版及其他中國港版/非中國品牌：通過 EngageLab 通道可達。	強烈推薦集成 EngageLabAppPush服務；所有港版設備在中國大陸地區均依賴 EngageLab 或廠商通道實現推送。

✅ 最佳化建議

✅ 所有裝置若無法整合 FCM 或廠商通道，建議統一使用 EngageLab 通道；
✅ 對於已成功整合廠商通道的裝置，建議優先配置為 pns_mtpush 策略（優先走廠商）；
✅ 海外 Android 裝置（尤其是 Google 原生系統）建議優先走 FCM；
✅ 中國大陸使用者建議強制整合並優先使用「廠商通道 + EngageLab 混合策略」。