Affichez le nombre de non-lus sur l'icône de votre app
Le badge est le plus petit message que vous puissiez adresser à un utilisateur, et sa lecture ne lui coûte rien. Définissez-le, incrémentez-le ou effacez-le depuis la même campagne et le même parcours que tout le reste de vos envois.
Plus de 80 000 entreprises nous font confiance pour développer leur engagement
Le format, en détail
Un badge est un simple nombre entier, et c’est tout son intérêt. Il ne mobilise ni bannière ni son, il ne consomme rien de l’autorisation de notifications si difficile à obtenir, et il continue d’agir sur l’utilisateur qui a balayé votre notification push il y a trois heures. Depuis l’éditeur ou l’API, vous pouvez agir de trois façons sur ce nombre, avec une réserve sur l’endroit où il s’affiche réellement.
Une valeur exacte
ios_badges: 5 affiche 5 sur l'icône, quelle que soit la valeur précédente. La valeur envoyée est celle que voit l'utilisateur : idéal lorsque votre serveur connaît déjà le total réel.
+1 et -1
Les modifications relatives augmentent ou diminuent le compteur sans que vous ayez à le suivre. Le SDK renvoie la valeur de l'appareil via l'endpoint interne /setBadge, si bien que le compteur Pushwoosh reste aligné sur l'icône réelle.
0 l'efface
Envoyez 0 et le badge disparaît de l'icône. L'effacer à l'ouverture fait toute la différence entre un compteur auquel l'utilisateur se fie et un point rouge qu'il apprend à ignorer.
Uniforme sur iOS, dépendant du launcher sur Android
Sur iOS, le badge est une valeur standard aps.badge et chaque appareil l'affiche de la même manière. Android n'a pas d'API native de badge : l'affichage dépend du launcher, et Pushwoosh le dit clairement plutôt que de promettre une couverture impossible.
Ce que vous contrôlez
| Ce que vous envoyez | Effet sur le compteur | Où le régler |
|---|---|---|
Un entier, 5 | Fixe le badge à exactement cette valeur | ios_badges / android_badges, ou le champ Badges |
+1, +3 | Incrémente le compteur actuel | Même champ. Également +n dans les presets Android |
-1 | Décrémente le compteur actuel | Même champ, pour une lecture ou un rejet côté serveur |
0 | Retire le badge de l'icône | Même champ, ou l'app à son lancement |
| Un appel SDK | Définit ou efface le badge à partir d'un événement in-app | setApplicationIconBadgeNumber sur iOS, PushwooshBadge sur Android |
| Rien | Le SDK applique le badge arrivé avec la notification push | Aucun code applicatif dans le cas iOS de base |
| Une extension | Modifie le compteur avant l'affichage de la notification | PWNotificationExtensionManager avec App Groups |
5ios_badges / android_badges, ou le champ Badges+1, +3+n dans les presets Android-10setApplicationIconBadgeNumber sur iOS, PushwooshBadge sur AndroidPWNotificationExtensionManager avec App GroupsOù le régler
Un champ Badges dans l'éditeur
Le formulaire Send-Push et les presets push acceptent un nombre, +n, -n ou 0. Modifier l'effet d'une campagne sur le compteur ne demande ni nouvelle version, ni développeur.
Une clé dans l'API
ios_badges et android_badges dans /createMessage. Sur iOS, la valeur est placée dans le champ aps.badge du payload qu'Apple transporte déjà.
Appliqué et synchronisé par le SDK
Le SDK applique la valeur reçue sans code applicatif et tient à jour la valeur côté serveur via /setBadge, pour que +1 parte du bon nombre.
Son rôle, au sein d’un parcours
Un compteur, plusieurs sources
Le badge est un attribut d’un message que vous envoyez déjà : il ne demande aucune intégration dédiée. Le même Customer Journey et le même profil client qui décident qui reçoit la notification push décident aussi de la valeur du compteur.
Reste à savoir ce qui alimente ce nombre. Le total de non-lus d’une Message Inbox peut constituer le compteur à lui seul, une notification silencieuse peut le modifier sans aucune alerte, et une notification push mobile visible le transporte au passage. Une étape à l’objectif du parcours le ramène à 0.
Trois récompenses s’accumulent pendant l’absence du joueur
Chaque récompense attribuée déclenche un événement, et chaque événement envoie une notification silencieuse qui ajoute +1. Rien ne sonne, rien n’allume l’écran verrouillé, et le soir venu l’icône affiche discrètement 3.
À l’ouverture de l’événement live, le même parcours envoie une seule notification visible, qui mérite d’interrompre. Quelle que soit celle des deux qui fait revenir le joueur, le SDK remet le badge à 0 au lancement : le compteur du lendemain repart d’une valeur juste.
Pour quels usages
Le badge rapporte en proportion de la densité de comptage : votre app a-t-elle un vrai nombre d’éléments non lus ou en attente, qui grossit et mérite de figurer sur une icône ? Les apps construites autour d’un compteur obtiennent un levier de réengagement gratuit ; celles qui n’ont rien à compter obtiennent un point rouge qui apprend à l’utilisateur à ignorer les points rouges.
| Moment | Ce que signifie le nombre | Pourquoi le badge convient |
|---|---|---|
| Médias et presse : articles non lus, nouveaux épisodes | 5 articles non lus | Le cas d'école, et celui qui ramène le plus sûrement un lecteur dans une session |
| E-commerce et marketplaces : articles du panier, offres non lues | 2 articles dans votre panier | Un rappel discret qui ne coûte au client aucune attention |
| Fintech : relevés, alertes, actions en attente | 1 action requise | Il existe un vrai compteur de documents non lus, et l'icône le porte sans exposer de détail sur l'écran verrouillé |
| Jeux mobiles : récompenses, vies rechargées, inscriptions aux événements | 3 éléments à récupérer | Le compteur fait déjà partie de la boucle de rétention, et récupérer est toute la motivation |
| Apps de créateurs et d'abonnement : nouveautés, messages privés, commentaires | 12 non lus | Un fil social tient déjà ce nombre en interne, l'icône n'a plus qu'à l'afficher |
| Trading et paris : alertes déclenchées, paris réglés | 4 alertes déclenchées | Les alertes s'accumulent en un nombre qui a un vrai sens pour l'utilisateur |
| Santé et télémédecine : résultats, messages sécurisés | Vos résultats sont disponibles | Le compteur s'affiche sur l'écran d'accueil tandis que le contenu reste derrière l'authentification |
| EdTech : leçons non lues, séries, devoirs | 2 leçons en attente | Une série ou une file de leçons est exactement le type de nombre qu'on aime solder |
Quand le badge n’est pas le bon outil
Le badge indique une quantité. Tout ce qui concerne la nature de ce qui attend, et son urgence, relève d’une autre surface.
- L’utilisateur doit savoir ce qui est arrivé : c’est le rôle d’une notification push mobile, d’une notification rich media ou d’un message in-app.
- Le moment ne peut pas attendre. Un badge est passif par nature : l’urgence relève d’un niveau d’interruption.
- L’état est continu plutôt que comptable : une commande en cours de livraison, un score en direct. C’est le rôle d’une Live Activity.
- L’app n’a pas de compteur naturel. Assurance, hôtellerie, fournisseurs d’énergie et outils à session unique n’ont qu’une facture ou une réservation : un badge y est du bruit.
- Votre audience est majoritairement Android et le badge serait un mécanisme central. Considérez-le comme un bonus sur cette plateforme et concevez le parcours pour qu’il fonctionne sans lui.
Couverture plateformes et technique
iOS a un seul badge, et chaque iPhone l’affiche de la même façon. Android n’a pas d’API de badge universelle : ce qui apparaît sur l’écran d’accueil dépend du launcher utilisé. Sur un marché français où iOS et Android sont tous deux très présents, cette différence compte. La dernière colonne nomme ce qui dessine réellement le nombre, car c’est là que se trouve la réponse honnête pour cette fonctionnalité.
| Fonctionnalité | iOS | Android | Web | Fourni par |
|---|---|---|---|---|
| Valeur de badge exacte | Oui, aps.badge standard | Au mieux, selon le launcher | – | Le payload push, appliqué par le SDK |
+1 et -1 relatifs | Oui, SDK Pushwoosh 6.4.0+ | +n dans les presets, selon le launcher | – | La notification push, avec /setBadge qui garde le compteur synchronisé |
Remise à 0 | Oui | Selon le launcher | – | Le payload push, ou l'app à son lancement |
| Champ Badges no-code | Oui, dans l'éditeur et les presets | Oui, une valeur de badge dans les presets | – | Pushwoosh Control Panel |
| Définir ou effacer depuis le code de l'app | setApplicationIconBadgeNumber | PushwooshBadge | – | Votre app, via le SDK Pushwoosh |
| Modifier le compteur avant l'affichage | Oui, dans une Notification Service Extension | – | – | PWNotificationExtensionManager avec App Groups |
| Mettre à jour le badge sans alerte | Oui | Au mieux | – | Une notification silencieuse, même audience et même parcours |
| Couverture launchers et appareils | Chaque iPhone, à l'identique | Sony, Samsung, LG, HTC, ASUS, ADW, APEX, NOVA, Huawei, ZUK, OPPO | – | com.pushwoosh:pushwoosh-badge avec les autorisations launcher |
| Pixel et launchers non pris en charge | n/a | – | – | Aucune API de badge Android native n'existe : rien ne s'affiche |
| Lire le compteur actuel depuis l'OS | – | – | – | iOS n'expose aucune API de lecture : le compteur vit dans votre app ou sur le serveur |
| Un badge d'icône tout court | Oui | Selon le launcher | – | Les navigateurs n'ont pas de surface équivalente pour le web push |
aps.badge standard+1 et -1 relatifs+n dans les presets, selon le launcher/setBadge qui garde le compteur synchronisé0setApplicationIconBadgeNumberPushwooshBadgePWNotificationExtensionManager avec App Groupscom.pushwoosh:pushwoosh-badge avec les autorisations launcherSécurité et hébergement
Pushwoosh fonctionne sur son propre matériel aux États-Unis et en Allemagne, dans le cadre du RGPD.
Comment ça marche
Définir un badge est no-code et gratuit sur toutes les formules. Le temps de développement se concentre sur deux points précis, et aucun ne concerne le cas iOS de base.
-
Composez le compteur (no-code)
Saisissez un nombre,
+n,-nou0dans le champ Badges du formulaire Send-Push ou d'un preset, ou envoyezios_badgesetandroid_badgesvia l'API Messages. Sur iOS, le cas de base ne demande rien à votre app : le SDK applique la valeur à la réception. -
Branchez les deux points nécessaires (développeur)
Android requiert la bibliothèque
com.pushwoosh:pushwoosh-badgeainsi que les autorisations propres à chaque launcher dans le manifest. L'effacement à l'ouverture de la notification et au lancement de l'app tient en un appel SDK, et une Notification Service Extension avec App Groups ne sert qu'aux compteurs qui doivent changer avant l'affichage. -
Orchestrez (no-code)
Alimentez le nombre à partir du total de non-lus de votre Message Inbox, modifiez-le avec une notification silencieuse sans alerte, et effacez-le à l'objectif du même Customer Journey qui pilote vos notifications push, messages in-app et e-mails.
Limites à connaître
Explorer les produits connexes
Notifications push mobiles Pushwoosh : hébergement UE, conforme RGPD, chaque appareil couvert, ciblage précis et parcours cross-canal.
Un centre de notifications in-app pour votre application et votre site. La livraison silencieuse touche aussi les utilisateurs qui ont refusé le push.
Concevez et optimisez vos campagnes avec un outil visuel unique. Communiquez, engagez, fidélisez, convertissez, segmentez et expérimentez avec le Constructeur de parcours client Pushwoosh.
Messages in-app Pushwoosh : réalisez onboarding, upsell, annonces et collecte de feedback au moment précis où vos utilisateurs sont attentifs dans l'application. Éditeur sans code, modèles natifs via SDK, analytics par élément. Conforme RGPD, données hébergées en UE. Démarrez gratuitement.
Définissez le niveau d'interruption iOS de vos notifications push : une alerte fraude ou un changement de porte traverse le mode Concentration. Sans code.
Plateforme de notifications push pour applications de jeux mobiles. Envoyez des alertes personnalisées, des offres spéciales et des rappels d'événements pour maintenir les joueurs engagés.