logo文件
AppPush
文檔首頁
用戶指南開發者指南資料安全最佳實踐
搜尋
繁體中文
English
繁體中文
简体中文
日本語
ภาษาไทย
Español
Indonesian
Deutsch
Français
登錄
最佳實踐 / 如何設定通知徽章

通知徽章完整指南：提升應用程式參與度的關鍵功能

最新更新：大約 1 個月前

通知徽章值概述

通知徽章是提升行動應用程式參與度的核心功能之一。透過直接在應用程式圖示上顯示未讀訊息數量，通知徽章能有效提升用戶回訪率與通知開啟率。

EngageLab 提供完善的跨平台通知徽章解決方案，協助您打造最佳的用戶體驗。

支援渠道概覽

由於不同行動裝置廠商在系統層級上的限制，僅部分推播渠道支援通知徽章顯示。各渠道支援狀態如下：

廠商 徽章／數字徽章支援 實作說明 注意事項
Google FCM 支援徽章 預設顯示為點狀，遵循系統行為 無明確上限
華為／榮耀 支援數字徽章 徽章數量隨通知增長 通常上限為９９
小米 支援數字徽章 遵循系統預設邏輯，每次新通知數量加１ 系統定義限制，未明確記錄
OPPO 不支援數字徽章 預設僅支援紅點。數字徽章需經 OPPO 特別批准，通常僅授權給微信、QQ 等應用 未指定；數字徽章通常不可用
VIVO 廠商確認中，目前測試不支援 線上資訊依 OS 版本與推播渠道而異 通常上限為９９
魅族 不支援數字徽章 僅支援紅點 —
iOS 支援數字徽章 徽章數量可透過推播負載或 SDK 應用程式介面（API）管理 非常高，無記錄上限

常見使用場景

  • 社交應用：即時同步未讀訊息數量
  • 電商應用：提醒待付款帳單或待處理訂單
  • 新聞應用：顯示未讀新聞通知

iOS 通知徽章：精確徽章管理

技術架構說明

技術架構圖：iOS 通知徽章管理流程 圖說：iOS 通知徽章管理的技術架構示意圖，展示從伺服器推播到用戶端顯示徽章的完整流程。

客戶端徽章設定

設定徽章（含回調）

支援版本：v5.2.0

設定徽章程式碼範例 圖說：iOS 端設定通知徽章的程式碼範例

清除徽章

清除 MTPush 伺服器上儲存的徽章值，相當於呼叫：

setBadge: 0
              
              setBadge: 0
此代碼塊在浮窗中顯示

清除徽章程式碼範例 圖說：iOS 端清除通知徽章的程式碼範例

伺服端徽章設定

發送推播通知時，需於 ios 負載中設定 badge 欄位。

欄位 類型 是否可選 描述 相關說明
badge Int 或 String 可選 應用程式圖示徽章數量 • 可設為 N、+N 或 -N，其中 N 範圍為 [0, 99]。
• 若值為 10，徽章可解釋為 N、10+N 或 10-N（值低於 0 將清除徽章）。
• 值為 0 或空字串時清除徽章。
• 若省略，徽章數量保持不變。
• 官方 MTPush API 函式庫（SDK）預設徽章值為「+1」。

參數使用範例

  • 設定固定徽章數量：badge: 5
  • 增加徽章數量：badge: "+2"
  • 減少徽章數量：badge: "-1"
  • 清除徽章：badge: 0 或 badge: ""

華為／榮耀通知徽章

客戶端設定

<!-- AndroidManifest.xml 權限設定 --> <uses-permission android:name="com.huawei.android.launcher.permission.CHANGE_BADGE"/> <uses-permission android:name="com.hihonor.android.launcher.permission.CHANGE_BADGE"/>
              
              <!-- AndroidManifest.xml 權限設定 -->
<uses-permission android:name="com.huawei.android.launcher.permission.CHANGE_BADGE"/>
<uses-permission android:name="com.hihonor.android.launcher.permission.CHANGE_BADGE"/>
此代碼塊在浮窗中顯示

入口 Activity 配置

重要提醒： 應用程式的入口 Activity 必須正確設定。華為與榮耀裝置採用相同配置邏輯。

入口 Activity 配置範例 圖說：AndroidManifest.xml 入口 Activity 配置範例

進階伺服端參數

參數 描述 商業應用價值
badge_add_num 增加徽章數量 適用於即時通訊應用，避免徽章數量不同步
badge_set_num 設定徽章為固定值 適用於狀態指標，如待處理任務
badge_class 指定啟動器 Activity 確保徽章正確關聯至目標應用程式

參數使用範例

  • 增加徽章數量：badge_add_num: 3
  • 設定固定徽章數量：badge_set_num: 8
  • 指定目標 Activity：badge_class: com.example.MainActivity

小米通知徽章

支援 MIUI 6 及以上版本 的裝置可顯示數字徽章。MIUI 系統會自動處理徽章顯示邏輯：

📱 接收通知 → 徽章＋１（開發者無需額外操作）
🔄 開啟應用程式 → 徽章自動清除
⚡ MIUI 6+ 支援所有版本，涵蓋絕大多數小米用戶

最佳實踐建議

統一跨平台策略

  • 分層實現：優先於 iOS、華為與小米平台完整支援數字徽章
  • 回退兼容性：對於 OPPO、VIVO 及其他不支援平台，採用紅點指示
  • 一致用戶體驗：盡量保持通知徽章邏輯一致，提升應用程式參與度
icon
聯繫銷售