通知バッジの設定方法

バッジの価値概要

通知バッジは、モバイルアプリにおけるユーザーエンゲージメントを高めるための重要な機能です。
アプリアイコン上に未読件数を表示することで、アプリの再訪や通知確認を自然に促します。

EngageLab では、クロスプラットフォームに対応したバッジソリューションを提供し、開発者が一貫性のあるユーザー体験を設計できるよう支援しています。

プッシュチャネル別対応状況

モバイル端末メーカーごとの OS 仕様により、すべてのプッシュチャネルが通知バッジに対応しているわけではありません。
主な対応状況は以下のとおりです。

ベンダー	バッジ／数値バッジ対応	実装上のポイント	バッジ制限
Google FCM	バッジ対応	システム仕様により既定ではドット表示	明確な上限なし
Huawei / Honor	数値バッジ対応	通知受信ごとにバッジ数が加算される	通常 99 まで
Xiaomi	数値バッジ対応	システム標準ロジックにより通知ごとに +1	システム依存
OPPO	数値バッジ非対応	標準は赤点のみ。数値表示は特別審査が必要	原則利用不可
VIVO	メーカー確認中（現時点では非対応）	OS やチャネルにより挙動が異なる	通常 99 まで
Meizu	数値バッジ非対応	赤点のみ表示	–
iOS	数値バッジ対応	プッシュペイロードまたは SDK API で制御	明示的な上限なし

主な利用シーン

SNS アプリ：未読メッセージ数のリアルタイム表示
EC アプリ：未対応注文やアクションの通知
ニュースアプリ：未読記事数の可視化

iOS バッジ：精密なバッジ管理

技術構成

通知バッジの技術構成図

クライアント側バッジ設定

バッジ設定（コールバック付き）

対応バージョン：v5.2.0 以降

iOS バッジ設定画面例

バッジのクリア

MTPush サーバーに保存されているバッジ値をリセットします。
動作としては、以下の設定と同等です。

setBadge: 0

              
              setBadge: 0

このコードブロックはフローティングウィンドウ内に表示されます

バッジクリア設定例

サーバー側バッジ設定

プッシュ通知送信時は、ios ペイロード内で badge フィールドを指定します。

フィールド	型	必須	説明	補足
badge	Int または String	任意	アプリアイコンに表示する数値	• `N`、`+N`、`-N` の形式で指定可能（`N` は `[0, 99]`）。 • 例として値が `10` の場合、固定値・加算・減算として解釈される。 • 0 未満になった場合はクリア扱い。 • `0` または空文字はバッジをクリア。 • 未指定の場合は既存の値を維持。 • MTPush SDK では既定値として `"+1"` が設定される。

Huawei / Honor バッジ

クライアント側設定

<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 を正しく設定する必要があります。Huawei と Honor は共通のロジックで動作します。

Huawei / Honor バッジ設定画面

サーバー側の拡張パラメータ

パラメータ	説明	ビジネス上の利点
`badge_add_num`	バッジ数を加算	メッセージ系アプリでの不整合防止
`badge_set_num`	バッジ数を固定値に設定	タスク管理や状態表示に適する
`badge_class`	起動 Activity を指定	正しいアプリにバッジを紐付け

Xiaomi バッジ

MIUI 6 以降の端末では数値バッジに対応しています。
バッジの制御は MIUI システムが自動的に行います。

📱 通知受信時：バッジが +1
🔄 アプリ起動時：バッジは自動でクリア
⚡ MIUI 6 以降の全バージョンに対応し、多くの Xiaomi 端末をカバーします。

ベストプラクティス

クロスプラットフォーム統一方針

段階的対応：iOS、Huawei、Xiaomi では数値バッジを優先
代替手段：OPPO、VIVO など非対応端末では赤点表示を活用
体験の一貫性：可能な範囲で共通のバッジロジックを維持

通知バッジガイド：アプリのエンゲージメント向上を支える基本機能