App-Icon-Badges

Die Zahl ungelesener Inhalte direkt am App-Icon

Ein Badge ist die kleinste Botschaft an Ihre Nutzer, und das Lesen kostet sie nichts. Setzen, erhöhen oder löschen Sie ihn aus derselben Kampagne und Journey wie alles andere, was Sie versenden.

Drei iPhone-Homescreens nebeneinander, auf denen einige App-Icons einen roten Ungelesen-Zähler in der Ecke tragen und die übrigen Icons keinen Badge

Über 80.000 Unternehmen vertrauen Pushwoosh beim Skalieren ihres Engagements

Sicherheit & Hosting

Ein Badge zeigt nur eine Zahl und keinen Inhalt auf dem Sperrbildschirm. Die Daten, aus denen diese Zahl entsteht, verarbeitet Pushwoosh auf eigener Hardware in den USA und in Deutschland, gemäß DSGVO.

ISO 27001:2022 CertifiedISO 27001 CertifiedGDPR CompliantData Privacy FrameworkHIPAA CompliantSOC 2 Type 2 CertifiedOWASP Compliant

Das Format im Detail

Ein Badge ist eine einzige Ganzzahl, und genau das macht ihn attraktiv. Er braucht weder Banner noch Ton, verbraucht nichts von der mühsam gewonnenen Berechtigung und wirkt auch bei Nutzern, die Ihren Push vor drei Stunden weggewischt haben. Mit dieser Zahl können Sie aus dem Composer oder der API drei Dinge tun, dazu kommt ein Hinweis, wo sie tatsächlich angezeigt wird.

Ein exakter Wert

ios_badges: 5 setzt eine 5 auf das Icon, unabhängig vom bisherigen Wert. Der gesendete Wert ist genau der, den der Nutzer sieht. Das ist richtig, wenn Ihr Server die tatsächliche Summe bereits kennt.

+1 und -1

Relative Änderungen erhöhen oder senken den Zähler, ohne dass Sie ihn selbst nachverfolgen. Das SDK meldet den Wert auf dem Gerät über den internen Endpoint /setBadge zurück, sodass der Zähler bei Pushwoosh mit dem echten Icon übereinstimmt.

0 löscht ihn

Senden Sie 0, und der Badge verschwindet vom Icon. Das Löschen beim Öffnen macht den Unterschied zwischen einem Zähler, dem Nutzer vertrauen, und einem roten Punkt, den sie zu ignorieren lernen.

iOS einheitlich, Android abhängig vom Launcher

Auf iOS ist der Badge ein Standardwert aps.badge, und jedes Gerät stellt ihn gleich dar. Android hat keine native Badge-API, die Darstellung hängt also vom Launcher ab. Pushwoosh sagt das offen, statt eine Abdeckung zu suggerieren, die es nicht liefern kann.

Was Sie steuern

Was Sie sendenWas mit dem Zähler passiertWo es liegt
Eine Ganzzahl, 5Setzt den Badge auf genau diesen Wertios_badges / android_badges oder das Feld Badges
+1, +3Erhöht den aktuellen ZählerDasselbe Feld. Auch +n in den Android-Presets
-1Senkt den aktuellen ZählerDasselbe Feld, für ein serverseitiges Gelesen oder Verwerfen
0Entfernt den Badge vom IconDasselbe Feld oder die App beim Start
Ein SDK-AufrufSetzt oder löscht den Badge aus einem In-App-EventsetApplicationIconBadgeNumber auf iOS, PushwooshBadge auf Android
NichtsDas SDK übernimmt den Badge, der mit dem Push eintrifftKein App-Code im iOS-Grundfall
Eine ExtensionÄndert den Zähler, bevor die Benachrichtigung angezeigt wirdPWNotificationExtensionManager mit App Groups
Was Sie senden
1 / 7
Eine Ganzzahl, 5
Was mit dem Zähler passiert
Setzt den Badge auf genau diesen Wert
Wo es liegt
ios_badges / android_badges oder das Feld Badges
Was Sie senden
2 / 7
+1, +3
Was mit dem Zähler passiert
Erhöht den aktuellen Zähler
Wo es liegt
Dasselbe Feld. Auch +n in den Android-Presets
Was Sie senden
3 / 7
-1
Was mit dem Zähler passiert
Senkt den aktuellen Zähler
Wo es liegt
Dasselbe Feld, für ein serverseitiges Gelesen oder Verwerfen
Was Sie senden
4 / 7
0
Was mit dem Zähler passiert
Entfernt den Badge vom Icon
Wo es liegt
Dasselbe Feld oder die App beim Start
Was Sie senden
5 / 7
Ein SDK-Aufruf
Was mit dem Zähler passiert
Setzt oder löscht den Badge aus einem In-App-Event
Wo es liegt
setApplicationIconBadgeNumber auf iOS, PushwooshBadge auf Android
Was Sie senden
6 / 7
Nichts
Was mit dem Zähler passiert
Das SDK übernimmt den Badge, der mit dem Push eintrifft
Wo es liegt
Kein App-Code im iOS-Grundfall
Was Sie senden
7 / 7
Eine Extension
Was mit dem Zähler passiert
Ändert den Zähler, bevor die Benachrichtigung angezeigt wird
Wo es liegt
PWNotificationExtensionManager mit App Groups

Wo Sie es festlegen

Ein Feld Badges im Composer

Das Send-Push-Formular und die Push-Presets akzeptieren eine Zahl, +n, -n oder 0. Was eine Kampagne mit dem Zähler macht, ändern Sie ohne Release und ohne Entwickler.

Ein Schlüssel in der API

ios_badges und android_badges in /createMessage. Auf iOS wird der Wert in das Feld aps.badge des Payloads geschrieben, den Apple ohnehin überträgt.

Vom SDK angewendet und synchronisiert

Das SDK übernimmt den eintreffenden Wert ohne App-Code und hält den serverseitigen Badge-Stand über /setBadge aktuell, damit +1 vom richtigen Wert aus zählt.

Was der Badge in einer Journey leistet

Ein Zähler, mehrere Quellen

Der Badge ist ein Attribut einer Nachricht, die Sie ohnehin senden, und braucht deshalb keine eigene Integration. Dieselbe Customer Journey und dasselbe Kundenprofil, die bestimmen, wer den Push erhält, bestimmen auch, welchen Wert der Zähler annimmt.

Offen bleibt nur, was die Zahl speist. Die Summe ungelesener Nachrichten in der Message Inbox kann direkt der Zähler sein, ein Silent Push kann ihn ganz ohne Alarm verändern, und ein sichtbarer Mobile Push nimmt ihn einfach mit. Ein Schritt am Journey-Ziel setzt ihn wieder auf 0.

Drei Belohnungen sammeln sich, während der Spieler weg ist

Jede vergebene Belohnung löst ein Event aus, und jedes Event sendet einen Silent Push, der +1 addiert. Nichts klingelt, nichts erhellt den Sperrbildschirm, und am Abend zeigt das Icon unauffällig eine 3.

Wenn das Live-Event startet, sendet dieselbe Journey einen sichtbaren Push, der die Unterbrechung wert ist. Egal welcher der beiden den Spieler zurückholt: Das SDK setzt den Badge beim Start auf 0, damit der Zähler am nächsten Tag von einem korrekten Stand ausgeht.

Wofür sich Badges lohnen

Der Badge lohnt sich in dem Maß, in dem Ihre App eine echte, wachsende Zahl ungelesener oder offener Dinge hat, die aufs Icon gehört. Apps, die um einen Zähler herum gebaut sind, erhalten einen kostenlosen Anstoß zur Reaktivierung. Apps ohne Zählbares erhalten einen roten Punkt, der Nutzern beibringt, rote Punkte zu ignorieren.

MomentWas die Zahl bedeutetWarum der Badge passt
E-Commerce & Marktplätze: Artikel im Warenkorb, ungelesene Angebote2 Artikel im WarenkorbEine leise Erinnerung, die den Käufer keinerlei Aufmerksamkeit kostet
Fintech: Kontoauszüge, Alarme, offene Aktionen1 Aktion erforderlichEs gibt eine echte Zahl ungelesener Dokumente, und das Icon trägt sie, ohne Details auf den Sperrbildschirm zu bringen
Gesundheit & Telemedizin: Befunde, sichere NachrichtenIhre Befunde sind daDer Zähler steht auf dem Homescreen, der Inhalt bleibt hinter der Authentifizierung
Trading & Wetten: ausgelöste Alarme, abgerechnete Wetten4 Alarme ausgelöstAlarme summieren sich zu einer Zahl, die für den Nutzer wirklich etwas bedeutet
Medien & News: ungelesene Artikel, neue Folgen5 ungelesene ArtikelDer Lehrbuchfall, der Leser zuverlässig in eine neue Sitzung zurückholt
EdTech: ungelesene Lektionen, Streaks, Aufgaben2 Lektionen wartenEin Streak oder eine Lektionsliste ist genau die Art Zahl, die Menschen abarbeiten
Creator- & Abo-Apps: Drops, DMs, Kommentare12 ungelesenEin sozialer Feed führt diese Zahl intern ohnehin, das Icon muss sie nur zeigen
Mobile Games: Belohnungen, aufgefüllte Leben, Event-Teilnahmen3 Dinge abzuholenDer Zähler ist bereits Teil der Retention-Schleife, und das Abholen ist die eigentliche Motivation
Moment
1 / 8
E-Commerce & Marktplätze: Artikel im Warenkorb, ungelesene Angebote
Was die Zahl bedeutet
2 Artikel im Warenkorb
Warum der Badge passt
Eine leise Erinnerung, die den Käufer keinerlei Aufmerksamkeit kostet
Moment
2 / 8
Fintech: Kontoauszüge, Alarme, offene Aktionen
Was die Zahl bedeutet
1 Aktion erforderlich
Warum der Badge passt
Es gibt eine echte Zahl ungelesener Dokumente, und das Icon trägt sie, ohne Details auf den Sperrbildschirm zu bringen
Moment
3 / 8
Gesundheit & Telemedizin: Befunde, sichere Nachrichten
Was die Zahl bedeutet
Ihre Befunde sind da
Warum der Badge passt
Der Zähler steht auf dem Homescreen, der Inhalt bleibt hinter der Authentifizierung
Moment
4 / 8
Trading & Wetten: ausgelöste Alarme, abgerechnete Wetten
Was die Zahl bedeutet
4 Alarme ausgelöst
Warum der Badge passt
Alarme summieren sich zu einer Zahl, die für den Nutzer wirklich etwas bedeutet
Moment
5 / 8
Medien & News: ungelesene Artikel, neue Folgen
Was die Zahl bedeutet
5 ungelesene Artikel
Warum der Badge passt
Der Lehrbuchfall, der Leser zuverlässig in eine neue Sitzung zurückholt
Moment
6 / 8
EdTech: ungelesene Lektionen, Streaks, Aufgaben
Was die Zahl bedeutet
2 Lektionen warten
Warum der Badge passt
Ein Streak oder eine Lektionsliste ist genau die Art Zahl, die Menschen abarbeiten
Moment
7 / 8
Creator- & Abo-Apps: Drops, DMs, Kommentare
Was die Zahl bedeutet
12 ungelesen
Warum der Badge passt
Ein sozialer Feed führt diese Zahl intern ohnehin, das Icon muss sie nur zeigen
Moment
8 / 8
Mobile Games: Belohnungen, aufgefüllte Leben, Event-Teilnahmen
Was die Zahl bedeutet
3 Dinge abzuholen
Warum der Badge passt
Der Zähler ist bereits Teil der Retention-Schleife, und das Abholen ist die eigentliche Motivation

Wann der Badge das falsche Werkzeug ist

Der Badge meldet eine Menge. Alles darüber, was wartet und wie dringend es ist, gehört auf eine andere Oberfläche.

  • Der Nutzer muss wissen, was eingetroffen ist: Das ist ein Mobile Push, ein Rich-Media-Push oder eine In-App-Nachricht.
  • Der Moment kann nicht warten. Ein Badge ist bewusst passiv, Dringlichkeit gehört zu einer Unterbrechungsstufe.
  • Der Zustand ist fortlaufend statt zählbar: eine Bestellung unterwegs, ein laufender Spielstand. Das ist eine Live Activity.
  • Die App hat keine natürlich wachsende Zahl. Versicherungen, Hotels, Versorger und Tools für eine einzelne Sitzung haben eine Rechnung oder eine Buchung, ein Badge ist dort nur Rauschen.
  • Ihre Zielgruppe nutzt überwiegend Android und der Badge wäre eine Hauptmechanik. Behandeln Sie ihn dort als Best-Effort und gestalten Sie den Ablauf so, dass er auch ohne ihn funktioniert.
Der Zähler lenkt den Blick. Der Push muss das Öffnen trotzdem wert sein

50 Push-Benachrichtigungen als Vorlage, jeweils mit Text und Gestaltung dahinter.

Beispiele ansehen

Plattformen & technische Abdeckung

iOS hat einen Badge, und jedes iPhone stellt ihn gleich dar. Android hat keine universelle Badge-API, was auf dem Homescreen erscheint, entscheidet der Launcher des Nutzers. Die letzte Spalte nennt, was die Zahl tatsächlich zeichnet, denn bei dieser Funktion liegt dort die ehrliche Antwort.

FunktioniOSAndroidWebBereitgestellt durch
Exakter Badge-WertJa, Standard aps.badgeBest-Effort, abhängig vom Launcher–Der Push-Payload, vom SDK angewendet
Relativ +1 und -1Ja, Pushwoosh SDK 6.4.0++n in den Presets, abhängig vom Launcher–Der Push, /setBadge hält den Zähler synchron
Auf 0 löschenJaAbhängig vom Launcher–Der Push-Payload oder die App beim Start
No-Code-Feld BadgesJa, im Composer und in PresetsJa, ein Badge-Wert in den Presets–Pushwoosh Control Panel
Setzen oder Löschen aus dem App-CodesetApplicationIconBadgeNumberPushwooshBadge–Ihre App, über das Pushwoosh SDK
Zähler vor der Anzeige ändernJa, in einer Notification Service Extension––PWNotificationExtensionManager mit App Groups
Badge ohne Alarm aktualisierenJaBest-Effort–Ein Silent Push, gleiche Zielgruppe und Journey
Launcher- und GeräteabdeckungJedes iPhone, identischSony, Samsung, LG, HTC, ASUS, ADW, APEX, NOVA, Huawei, ZUK, OPPO–com.pushwoosh:pushwoosh-badge mit Launcher-Berechtigungen
Pixel und nicht unterstützte Launchern/a––Es gibt keine native Android-Badge-API, daher wird nichts angezeigt
Aktuellen Zähler vom OS auslesen–––iOS bietet keine Lese-API, der Zähler liegt in Ihrer App oder auf dem Server
Überhaupt ein App-Icon-BadgeJaAbhängig vom Launcher–Browser haben für Web-Push keine vergleichbare Oberfläche
Funktion
1 / 11
Exakter Badge-Wert
iOS
Ja, Standard aps.badge
Android
Best-Effort, abhängig vom Launcher
Web
–
Bereitgestellt durch
Der Push-Payload, vom SDK angewendet
Funktion
2 / 11
Relativ +1 und -1
iOS
Ja, Pushwoosh SDK 6.4.0+
Android
+n in den Presets, abhängig vom Launcher
Web
–
Bereitgestellt durch
Der Push, /setBadge hält den Zähler synchron
Funktion
3 / 11
Auf 0 löschen
iOS
Ja
Android
Abhängig vom Launcher
Web
–
Bereitgestellt durch
Der Push-Payload oder die App beim Start
Funktion
4 / 11
No-Code-Feld Badges
iOS
Ja, im Composer und in Presets
Android
Ja, ein Badge-Wert in den Presets
Web
–
Bereitgestellt durch
Pushwoosh Control Panel
Funktion
5 / 11
Setzen oder Löschen aus dem App-Code
iOS
setApplicationIconBadgeNumber
Android
PushwooshBadge
Web
–
Bereitgestellt durch
Ihre App, über das Pushwoosh SDK
Funktion
6 / 11
Zähler vor der Anzeige ändern
iOS
Ja, in einer Notification Service Extension
Android
–
Web
–
Bereitgestellt durch
PWNotificationExtensionManager mit App Groups
Funktion
7 / 11
Badge ohne Alarm aktualisieren
iOS
Ja
Android
Best-Effort
Web
–
Bereitgestellt durch
Ein Silent Push, gleiche Zielgruppe und Journey
Funktion
8 / 11
Launcher- und Geräteabdeckung
iOS
Jedes iPhone, identisch
Android
Sony, Samsung, LG, HTC, ASUS, ADW, APEX, NOVA, Huawei, ZUK, OPPO
Web
–
Bereitgestellt durch
com.pushwoosh:pushwoosh-badge mit Launcher-Berechtigungen
Funktion
9 / 11
Pixel und nicht unterstützte Launcher
iOS
n/a
Android
–
Web
–
Bereitgestellt durch
Es gibt keine native Android-Badge-API, daher wird nichts angezeigt
Funktion
10 / 11
Aktuellen Zähler vom OS auslesen
iOS
–
Android
–
Web
–
Bereitgestellt durch
iOS bietet keine Lese-API, der Zähler liegt in Ihrer App oder auf dem Server
Funktion
11 / 11
Überhaupt ein App-Icon-Badge
iOS
Ja
Android
Abhängig vom Launcher
Web
–
Bereitgestellt durch
Browser haben für Web-Push keine vergleichbare Oberfläche

So funktioniert es

Einen Badge zu setzen ist No-Code und in jedem Plan kostenlos. Entwicklungsaufwand entsteht nur an zwei eng umrissenen Stellen, und keine davon ist der iOS-Grundfall.

  1. Zähler festlegen (No-Code)

    Tragen Sie eine Zahl, +n, -n oder 0 in das Feld Badges des Send-Push-Formulars oder eines Presets ein, oder senden Sie ios_badges und android_badges über die Messages API. Auf iOS braucht der Grundfall nichts von Ihrer App: Das SDK übernimmt den Wert beim Eintreffen.

  2. Die zwei nötigen Stellen anbinden (Entwickler)

    Android braucht die Bibliothek com.pushwoosh:pushwoosh-badge sowie die launcherspezifischen Berechtigungen im Manifest. Das Löschen beim Öffnen des Pushs und beim App-Start ist ein SDK-Aufruf, eine Notification Service Extension mit App Groups ist nur für Zähler nötig, die sich vor der Anzeige ändern müssen.

  3. Orchestrieren (No-Code)

    Speisen Sie die Zahl aus der Ungelesen-Summe Ihrer Message Inbox, verändern Sie sie mit einem Silent Push ohne Alarm und löschen Sie sie am Ziel derselben Customer Journey, die auch Push, In-App und E-Mail steuert.

Grenzen, die Sie kennen sollten

Ein Zählerelement mit einer einheitlichen und einer fragmentierten Plattform. Das sind seine Grenzen.

  • iOS ist einheitlich und vollwertig. Android ist Best-Effort, weil das Betriebssystem keine universelle Badge-API hat und der Launcher entscheidet, was erscheint.
  • Die Android-Abdeckung ist tatsächlich uneinheitlich. Samsung und Xiaomi nutzen unterschiedliche Mechanismen, Googles eigener Pixel-Launcher zeigt Icon-Badges weitgehend nicht an, und manche Drittanbieter-Launcher ignorieren sie.
  • Badge-Updates auf Android hängen vom Akku-Management ab. Doze und App Standby drosseln die nötige Hintergrundarbeit, und eine zwangsweise beendete App kann den Zähler erst nach erneutem Öffnen aktualisieren.
  • Huawei-Geräte überlassen die Badge-Steuerung dem eigenen Huawei-Launcher, das Verhalten variiert also je nach Gerät und EMUI- oder HarmonyOS-Version.
  • Relative Werte +1 und -1 setzen voraus, dass das SDK den aktuellen Wert kennt. Eine App, die den Badge ohne Synchronisierung überschreibt, kann eine serverseitige Erhöhung vom falschen Wert aus zählen lassen, und iOS bietet keine API, um den Systembadge zurückzulesen.
  • Die Badge-Mechanik per Push hat sich mit dem iOS SDK 6.4.0 geändert. Apps, die den Badge zum Zählen empfangener Pushs nutzten, mussten migrieren. Planen Sie mit dem aktuellen Verhalten, nicht mit dem alten.
  • Der Badge transportiert eine Menge und sonst nichts. Was wartet und wie dringend es ist, muss aus einem Push, einer In-App-Nachricht oder einer Unterbrechungsstufe kommen.
  • Er hinterlässt kaum serverseitige Spuren. Nur Kampagnen, die den Badge ausdrücklich setzen, erscheinen im gespeicherten Payload, das Anwenden und Löschen durch das SDK nicht. Messen Sie ihn deshalb mit einer Kohorte mit Badge gegen eine ohne, statt ihn in einem Bericht zu suchen.