Configuración de badges

Nota

Para configurar los badges para los plugins de Cordova o React Native, por favor consulte las guías correspondientes:

• Badges para Cordova
• Badges para React Native

A partir de la versión 6.4.0 del SDK de Pushwoosh para iOS, el proceso de gestión y configuración de los badges a través de las notificaciones push ha cambiado.

Si anteriormente utilizaba el número de badges para indicar la cantidad de notificaciones push recibidas en su aplicación, debe migrar a una versión más reciente del SDK de iOS (6.4.0 o posterior). Las versiones anteriores serán compatibles hasta el final del segundo trimestre de 2022.

¿Qué determina el valor del badge?

El badge siempre proviene de la propia notificación push. Ninguna función de Pushwoosh lo establece o lo borra por sí sola. Enviar "ios_badges" en la solicitud /createMessage (o el campo badges en el Panel de Control) establece tanto aps.badge (el valor absoluto) como aps.pw_badge (el delta relativo) en el payload de iOS. Android lleva el valor equivalente en pw_badges y necesita el módulo com.pushwoosh:pushwoosh-badge para aplicarlo en los launchers compatibles. Guardar una notificación push en Message Inbox nunca establece ni cambia el badge. Los dos son efectos independientes de la misma notificación push.

Precaución

El valor relativo del badge +1/-1 solo es aplicado por la Extensión de Servicio de Notificación, y solo cuando está instalada y configurada con un App Group correspondiente como se describe a continuación. Sin esa configuración, el sistema operativo aplica el valor absoluto de aps.badge del payload tal como está. No hay autoincremento.

Cómo configurar los badges

Para configurar los badges, siga los siguientes pasos:

1. Añada la Extensión de Servicio de Notificación (File -> New -> Target…)

2. Seleccione la “Notification Service Extension”

3. Reemplace la clase NotificationService generada con una subclase de PushwooshNotificationServiceExtension. Pushwoosh se encarga del conteo de badges, el evento de entrega, la descarga de adjuntos y el fallback por tiempo de espera por usted:

Swift

import PushwooshFramework

class NotificationService: PushwooshNotificationServiceExtension {}

Objective-C

#import <PushwooshFramework/PushwooshFramework.h>

@interface NotificationService : PushwooshNotificationServiceExtension
@end

@implementation NotificationService
@end

4. Añada la capacidad de App Groups a ambos targets — la aplicación principal y la Extensión de Servicio de Notificación — y use el mismo App Group para cada uno.

5. Añada el ID del App Group al info.plist de la aplicación principal:

<key>PW_APP_GROUPS_NAME</key>
<string>group.com.example.demoapp_example</string>

La extensión hereda este valor de la aplicación anfitriona, por lo que no necesita repetirlo en el info.plist de la extensión — añádalo allí solo para sobrescribir el valor del anfitrión.

Si prefiere no usar el archivo info.plist, proporcione el App Group en el código sobrescribiendo pushwooshAppGroupsName en su clase NotificationServiceExtension:

Swift

override func pushwooshAppGroupsName() -> String? {
    "group.com.example.demoapp_example"
}

Objective-C

- (NSString *)pushwooshAppGroupsName {
    return @"group.com.example.demoapp_example";
}

Ejemplo

Enviar una notificación push con badges

Si desea enviar una notificación push con badges desde el Panel de Control de Pushwoosh, simplemente añada el valor de badge deseado al campo de texto badges como se muestra en la imagen a continuación:

Nota

Puede usar los siguientes formatos de valor para enviar los badges correctamente: +1, -1 o 5. Si desea incrementar el valor del badge, use el signo ”+”, si desea decrementar los badges, use el signo ”-”. También puede establecer el número exacto usando, por ejemplo, 5 sin signo.

Comparta sus comentarios con nosotros

Sus comentarios nos ayudan a crear una mejor experiencia, por lo que nos encantaría saber de usted si tiene algún problema durante el proceso de integración del SDK. Si encuentra alguna dificultad, no dude en compartir sus pensamientos con nosotros a través de este formulario.