Pon el contador de no leídos en el ícono de tu app
Un badge es lo más pequeño que le puedes decir a un usuario, y leerlo no le cuesta nada. Fíjalo, súmale o bórralo desde la misma campaña y el mismo journey que todo lo demás que envías.
Más de 80,000 empresas confían en nosotros para escalar su engagement
El formato, completo
Un badge es un solo número entero, y ese es todo su atractivo. No ocupa un banner ni suena, no gasta el permiso de notificaciones que tanto te costó conseguir, y sigue funcionando con el usuario que descartó tu push hace tres horas. Hay tres cosas que puedes hacer con ese número desde el editor o la API, más una advertencia sobre dónde se muestra realmente.
Un número exacto
ios_badges: 5 pone un 5 en el ícono, sin importar lo que había antes. El valor que envías es el que ve el usuario, justo lo que quieres cuando tu servidor ya conoce el total real.
+1 y -1
Los cambios relativos suben o bajan el contador sin que tengas que llevar la cuenta. El SDK reporta el valor del dispositivo a través del endpoint interno /setBadge, así el contador de Pushwoosh queda igual al ícono real.
0 lo borra
Envía 0 y el badge desaparece del ícono. Borrarlo al abrir la app es la diferencia entre un contador en el que los usuarios confían y un punto rojo que aprenden a ignorar.
iOS uniforme, Android según el launcher
En iOS el badge es un valor estándar de aps.badge y todos los dispositivos lo dibujan igual. En Android no existe una API nativa de badges, así que la visualización depende del launcher, y Pushwoosh lo dice claramente en lugar de prometer una cobertura que no puede entregar.
Lo que controlas
| Lo que envías | Qué le pasa al contador | Dónde se configura |
|---|---|---|
Un entero, 5 | Fija el badge exactamente en ese valor | ios_badges / android_badges, o el campo Badges |
+1, +3 | Incrementa el contador actual | El mismo campo. También +n en los presets de Android |
-1 | Reduce el contador actual | El mismo campo, para una lectura o un descarte del lado del servidor |
0 | Quita el badge del ícono | El mismo campo, o la app al abrirse |
| Una llamada al SDK | Fija o borra el badge desde un evento dentro de la app | setApplicationIconBadgeNumber en iOS, PushwooshBadge en Android |
| Nada | El SDK aplica el badge que llegó con el push | Sin código en la app para el caso básico de iOS |
| Una extensión | Cambia el contador antes de mostrar la notificación | PWNotificationExtensionManager con App Groups |
5ios_badges / android_badges, o el campo Badges+1, +3+n en los presets de Android-10setApplicationIconBadgeNumber en iOS, PushwooshBadge en AndroidPWNotificationExtensionManager con App GroupsDónde lo configuras
Un campo Badges en el editor
El formulario Send-Push y los presets de push aceptan un número, +n, -n o 0. Cambiar lo que una campaña hace con el contador no requiere release ni desarrollador.
Una clave en la API
ios_badges y android_badges en /createMessage. En iOS el valor se escribe en el campo aps.badge del payload que Apple ya transporta.
Aplicado y sincronizado por el SDK
El SDK aplica el valor recibido sin código en la app, y mantiene actualizado el badge del lado del servidor mediante /setBadge, para que +1 cuente desde el número correcto.
Su función, dentro de un journey
Un contador, varias fuentes
El badge es un atributo de un mensaje que ya estás enviando, así que no necesita una integración propia. El mismo Customer Journey y el mismo perfil de cliente que deciden quién recibe el push también deciden en qué número queda el contador.
La única pregunta abierta es qué alimenta ese número. El total de no leídos de un Message Inbox puede ser el contador directamente, un silent push puede moverlo sin ninguna alerta, y una notificación push móvil visible lo lleva consigo. Un paso en el objetivo del journey lo regresa a 0.
Tres recompensas se acumulan mientras el jugador no está
Cada recompensa otorgada dispara un evento, y cada evento envía un silent push que suma +1. Nada suena, nada ilumina la pantalla de bloqueo, y para la noche el ícono marca 3 sin hacer ruido.
Cuando se abre el evento en vivo, el mismo journey envía un push visible que sí vale la interrupción. Sea cual sea el que traiga de vuelta al jugador, el SDK borra el badge a 0 al abrir la app, así que el contador de mañana empieza desde algo real.
Para qué usarlo
El badge rinde en proporción a la densidad del contador: si tu app tiene un número real y creciente de cosas pendientes o sin leer que valga la pena poner en un ícono. Las apps construidas alrededor de un contador obtienen gratis un empujón de reactivación genuino; las apps sin nada que contar obtienen un punto rojo que enseña a los usuarios a ignorar los puntos rojos.
| Momento | Qué significa el número | Por qué encaja el badge |
|---|---|---|
| E-commerce y marketplaces: productos en el carrito, ofertas sin leer | 2 productos en tu carrito | Un recordatorio discreto que no le cuesta al comprador nada de atención |
| FinTech: estados de cuenta, alertas, acciones pendientes | 1 acción pendiente | Hay un conteo real de documentos sin leer, y el ícono lo muestra sin poner detalles en la pantalla de bloqueo |
| Medios y noticias: notas sin leer, episodios nuevos | 5 notas sin leer | El caso de libro, y el que trae de vuelta a un lector a una sesión de forma confiable |
| EdTech: lecciones sin leer, rachas, tareas | 2 lecciones esperando | Una racha o una cola de lecciones es justo el tipo de número que la gente quiere cerrar |
| Juegos móviles: recompensas, vidas recargadas, entradas a eventos | 3 cosas por reclamar | El contador ya es parte del loop de retención, y reclamar es toda la motivación |
| Apps de creadores y suscripción: lanzamientos, DMs, comentarios | 12 sin leer | Un feed social ya lleva este número internamente, así que el ícono solo tiene que mostrarlo |
| Trading y apuestas: alertas disparadas, apuestas liquidadas | 4 alertas disparadas | Las alertas se acumulan en un número que de verdad significa algo para el usuario |
| Salud y telemedicina: resultados, mensajes seguros | Tus resultados están listos | El contador viaja en la pantalla de inicio mientras el contenido queda detrás de la autenticación |
Cuándo el badge no es la herramienta correcta
El badge reporta una cantidad. Todo lo que tiene que ver con qué está esperando, y con qué urgencia, pertenece a otra superficie.
- El usuario necesita saber qué llegó: eso es una notificación push móvil, un push con rich media o un mensaje in-app.
- El momento no puede esperar. Un badge es pasivo por diseño, así que la urgencia corresponde a un nivel de interrupción.
- El estado es continuo, no un conteo: un pedido en camino, un marcador en vivo. Eso es una Live Activity.
- La app no tiene un contador natural que crezca. Seguros, hoteles, servicios públicos y herramientas de una sola sesión tienen una factura o una reserva, y ahí un badge es ruido.
- Tu audiencia es mayormente Android, como pasa en gran parte de LATAM, y el badge sería una mecánica principal. Trátalo ahí como best-effort y diseña el flujo para que funcione sin él.
Cobertura de plataformas y técnica
iOS tiene un solo badge, y todos los iPhone lo dibujan igual. Android no tiene una API universal de badges, así que lo que aparece en la pantalla de inicio depende del launcher que use cada persona. La última columna nombra qué dibuja realmente el número, porque en esta función ahí está la respuesta honesta.
| Capacidad | iOS | Android | Web | Lo entrega |
|---|---|---|---|---|
| Valor exacto del badge | Sí, aps.badge estándar | Best-effort, según el launcher | – | El payload del push, aplicado por el SDK |
+1 y -1 relativos | Sí, Pushwoosh SDK 6.4.0+ | +n en los presets, según el launcher | – | El push, con /setBadge manteniendo el contador sincronizado |
Borrar a 0 | Sí | Según el launcher | – | El payload del push, o la app al abrirse |
| Campo Badges no-code | Sí, en el editor y los presets | Sí, un valor de badge en los presets | – | Pushwoosh Control Panel |
| Fijar o borrar desde el código de la app | setApplicationIconBadgeNumber | PushwooshBadge | – | Tu app, a través del Pushwoosh SDK |
| Cambiar el contador antes de mostrar | Sí, en una Notification Service Extension | – | – | PWNotificationExtensionManager con App Groups |
| Actualizar el badge sin alerta | Sí | Best-effort | – | Un silent push, misma audiencia y mismo journey |
| Cobertura de launchers y dispositivos | Todos los iPhone, igual | Sony, Samsung, LG, HTC, ASUS, ADW, APEX, NOVA, Huawei, ZUK, OPPO | – | com.pushwoosh:pushwoosh-badge con permisos de launcher |
| Pixel y launchers no compatibles | n/a | – | – | No existe una API nativa de badges en Android, así que no se muestra nada |
| Leer el contador actual desde el SO | – | – | – | iOS no expone una API de lectura, así que el contador vive en tu app o en el servidor |
| Un badge en el ícono de la app | Sí | Según el launcher | – | Los navegadores no tienen una superficie equivalente para el web push |
aps.badge estándar+1 y -1 relativos+n en los presets, según el launcher/setBadge manteniendo el contador sincronizado0setApplicationIconBadgeNumberPushwooshBadgePWNotificationExtensionManager con App Groupscom.pushwoosh:pushwoosh-badge con permisos de launcherSeguridad y hosting
Pushwoosh opera en su propio hardware en EE.UU. y Alemania, bajo GDPR.
Cómo funciona
Configurar un badge es no-code y gratis en todos los planes. El trabajo de ingeniería se concentra en dos lugares puntuales, y ninguno es el caso básico de iOS.
-
Define el contador (no-code)
Escribe un número,
+n,-no0en el campo Badges del formulario Send-Push o de un preset, o envíaios_badgesyandroid_badgesa través de la Messages API. En iOS el caso básico no necesita nada de tu app: el SDK aplica el valor al recibirlo. -
Conecta los dos lugares que lo necesitan (desarrollador)
Android necesita la librería
com.pushwoosh:pushwoosh-badgemás los permisos específicos de cada launcher en el manifest. Borrar al abrir el push o la app es una sola llamada al SDK, y una Notification Service Extension con App Groups solo hace falta para contadores que deben cambiar antes de mostrarse. -
Orquéstalo (no-code)
Alimenta el número con el total de no leídos de tu Message Inbox, muévelo con un silent push que no muestra alerta, y bórralo en el objetivo del mismo Customer Journey que maneja tu push, in-app y email.
Límites que conviene conocer
Explora productos relacionados
Notificaciones push móviles con Pushwoosh: alcance total, contenido enriquecido, targeting preciso y 99% de uptime. Convierte usuarios en clientes fieles.
Message Inbox suma un centro de notificaciones in-app a tu app y sitio web. Llega incluso a quienes rechazaron el push, y los mensajes quedan guardados.
Diseña y optimiza tus campañas con una única herramienta visual. Comunica, conecta, retén, convierte, segmenta y experimenta con el Constructor de Viajes del Cliente de Pushwoosh.
Mensajería in-app de Pushwoosh: onboarding, upsell, anuncios y feedback justo cuando tus usuarios están activos en la app. Editor sin código, plantillas nativas vía SDK, analítica por elemento. Cumple con GDPR. Empieza gratis.
Define el nivel de interrupción de iOS en el push que ya envías, para que una alerta de fraude o un cambio de puerta atraviese el modo Concentración.
Plataforma de notificaciones push móviles para aplicaciones de juegos. Envíe alertas personalizadas, ofertas especiales y recordatorios de eventos para mantener a los jugadores volviendo.