Umfassender Leitfaden zu Benachrichtigungs-Badges: Ein zentrales Feature zur Steigerung der App-Interaktion

Überblick zum Badge-Wert

Benachrichtigungs-Badges sind ein zentrales Feature zur Steigerung der Nutzerbindung in mobilen Anwendungen. Indem die Anzahl ungelesener Nachrichten direkt auf dem App-Symbol angezeigt wird, erhöhen Badges effektiv die Rückkehrquote und die Öffnungsrate von Benachrichtigungen.

EngageLab bietet eine umfassende, plattformübergreifende Badge-Lösung, mit der Entwickler ein optimales Nutzererlebnis bereitstellen können.


Übersicht zur Kanalunterstützung

Aufgrund systembedingter Einschränkungen verschiedener Smartphone-Hersteller unterstützen nur bestimmte Push-Kanäle die Anzeige von Badges. Die Unterstützungsübersicht sieht wie folgt aus:

Hersteller Badge-/Badge-Nummer-Unterstützung Implementierungshinweise Badge-Einschränkungen
Google FCM Badge wird unterstützt Wird standardmäßig als Punkt angezeigt, folgt dem Systemverhalten Kein explizites Limit
Huawei / Honor Numerischer Badge wird unterstützt Badge-Nummer erhöht sich mit eingehenden Benachrichtigungen In der Regel auf 99 begrenzt
Xiaomi Numerischer Badge wird unterstützt Folgt der systemeigenen Logik, jede neue Benachrichtigung erhöht um 1 Limit systemabhängig, nicht explizit dokumentiert
OPPO Desktop-Zahlenbadge über Herstellerkanal unterstützt Desktop-Zahlenbadge auf der OPPO Open Platform freischalten; über badge_operation_type und badge_message_count setzen. Ohne Berechtigung kann die Anfrage erfolgreich sein, der Badge aber nicht greifen. Finale Anzeigegrenze und Desktop-Richtlinie folgen OPPO.
VIVO Auto-Erhöhung über Herstellerkanal und SDK-Badge-Einstellung unterstützt Herstellerkanal nutzt add_badge; lokale Benachrichtigungen und SDK setNotificationBadge/resetNotificationBadge werden ebenfalls unterstützt. vivo-Badge-Berechtigung freischalten und Desktop-Badge aktivieren. Finale Anzeigegrenze und Verhalten hängen von OS-Version und Desktop-Richtlinie ab.
Meizu Numerischer Badge nicht unterstützt Nur roter Punkt
iOS Numerischer Badge wird unterstützt Badge-Nummer kann über Push-Payload oder SDK-APIs verwaltet werden Sehr hoch; kein dokumentiertes Limit

Typische Anwendungsfälle

  • Soziale Apps: Synchronisierung der Anzahl ungelesener Nachrichten in Echtzeit
  • E-Commerce-Apps: Erinnerung an ausstehende Bestellungen oder Aktionen
  • News-Apps: Anzeige ungelesener Artikel

iOS-Badges: Präzises Badge-Management

Technische Architektur

alt text


Badge-Konfiguration auf Client-Seite

Badge setzen (mit Callback)

Unterstützt ab Version: v5.2.0

image.png


Badge löschen

Löscht den auf dem MTPush-Server gespeicherten Badgewert, entspricht folgendem Aufruf:

setBadge: 0
              
              setBadge: 0

            
Diesen Codeblock im schwebenden Fenster anzeigen

image.png


Badge-Konfiguration auf Server-Seite

Beim Versand von Push-Benachrichtigungen muss das Feld badge im ios-Payload konfiguriert werden.

Feld Typ Optional Beschreibung Hinweise
badge Int oder String Optional Badge-Nummer auf dem App-Icon • Kann als N, +N oder -N gesetzt werden, wobei N im Bereich [0, 99] liegt.
• Ist der Wert 10, kann der Badge als N, 10+N oder 10-N interpretiert werden (Werte unter 0 löschen den Badgewert).
• Ein Wert von 0 oder ein leerer String löscht den Badge.
• Wird das Feld weggelassen, bleibt der Badge unverändert.
• Die offiziellen MTPush-API-Bibliotheken (SDKs) setzen standardmäßig den Wert "+1".

Huawei / Honor Badges

Konfiguration auf Client-Seite

<!-- Berechtigungskonfiguration im AndroidManifest.xml --> <uses-permission android:name="com.huawei.android.launcher.permission.CHANGE_BADGE"/> <uses-permission android:name="com.hihonor.android.launcher.permission.CHANGE_BADGE"/>
              
              <!-- Berechtigungskonfiguration im AndroidManifest.xml -->
<uses-permission android:name="com.huawei.android.launcher.permission.CHANGE_BADGE"/>
<uses-permission android:name="com.hihonor.android.launcher.permission.CHANGE_BADGE"/>

            
Diesen Codeblock im schwebenden Fenster anzeigen

Portal-Konfiguration

Wichtig:
Die Start-Activity der App muss korrekt konfiguriert sein. Huawei und Honor verwenden die gleiche Konfigurationslogik.

image.png


Erweiterte Server-Parameter

Parameter Beschreibung Geschäftlicher Nutzen
badge_add_num Badge-Nummer erhöhen Ideal für Messenger-Apps, um Badge-Inkonsistenzen zu vermeiden
badge_set_num Badge auf festen Wert setzen Geeignet für Statusanzeigen wie ausstehende Aufgaben
badge_class Launcher-Activity angeben (Start-Activity) Stellt sicher, dass der Badge der richtigen App zugeordnet wird

Xiaomi Badges

Geräte mit MIUI 6 und höher unterstützen numerische Badges.
Das MIUI-System übernimmt die Badge-Logik automatisch:

📱 Benachrichtigung empfangen → Badge +1 (kein Eingreifen der Entwickler:innen erforderlich)
🔄 App öffnen → Badge wird automatisch gelöscht
MIUI 6+ wird in allen Versionen unterstützt und deckt damit den Großteil der Xiaomi-Nutzer ab


OPPO-Badges: herstellerseitige Serverkonfiguration

In der Push-Anfrage unter options.third_party_channel.oppo setzen:

{ "badge_operation_type": 1 }
              
              {
  "badge_operation_type": 1
}

            
Diesen Codeblock im schwebenden Fenster anzeigen
  • badge_operation_type=1: Badge um 1 erhöhen; badge_message_count ist nicht erforderlich.
  • badge_operation_type=0: aktuellen Badge mit badge_message_count überschreiben; 0 löscht den Badge.
  • Vor dem Senden muss die Desktop-Zahlenbadge-Funktion für die App auf der OPPO Open Platform freigeschaltet werden; appseitig ist keine zusätzliche Badge-Integration nötig.

vivo-Badges: Herstellerkanal und SDK-Steuerung

Badge über den Herstellerkanal automatisch erhöhen:

{ "add_badge": true }
              
              {
  "add_badge": true
}

            
Diesen Codeblock im schwebenden Fenster anzeigen

Dieses Feld liegt unter options.third_party_channel.vivo. Für lokale Benachrichtigungen oder fachliches Synchronisieren ungelesener Zähler rufen Sie MTPushPrivatesApi.setNotificationBadge zum Setzen und resetNotificationBadge zum Zurücksetzen auf. Das tatsächliche Verhalten hängt von der vivo-Badge-Berechtigung, der OS-Version und dem Desktop-Badge-Schalter des Nutzers ab. Auf OriginOS nutzt +1 die System-API add_badge, +N (N > 1) wird als kumulativer Zielwert gesetzt.

Best-Practice-Empfehlungen

Einheitliche plattformübergreifende Strategie

  • Stufenweise Implementierung: Volle Unterstützung numerischer Badges auf iOS, Huawei und Xiaomi priorisieren
  • Fallback-Kompatibilität: Rote Punktindikatoren für OPPO, VIVO und andere nicht unterstützte Plattformen verwenden
  • Konsistentes Nutzererlebnis: Badge-Logik möglichst plattformübergreifend vereinheitlichen
Icon Solid Transparent White Qiyu
Vertrieb kontaktieren