Einrichten von Badges

Hinweis

Um Badges für Cordova- oder React Native-Plugins zu setzen, lesen Sie bitte die entsprechenden Anleitungen:

• Badges für Cordova
• Badges für React Native

Ab Version 6.4.0 des Pushwoosh iOS SDK hat sich der Prozess zur Verwaltung und Einstellung von Badges über Push-Benachrichtigungen geändert.

Wenn Sie bisher die Badge-Nummer verwendet haben, um die Anzahl der erhaltenen Push-Benachrichtigungen in Ihrer Anwendung anzuzeigen, müssen Sie auf eine neuere Version des iOS SDK (6.4.0 oder höher) migrieren. Die älteren Versionen werden bis zum Ende des zweiten Quartals 2022 unterstützt.

Was den Badge-Wert bestimmt

Der Badge-Wert stammt immer aus der Push-Benachrichtigung selbst. Keine Pushwoosh-Funktion setzt oder löscht ihn von sich aus. Das Senden von "ios_badges" in der /createMessage-Anfrage (oder das Feld Badges im Control Panel) setzt sowohl aps.badge (den absoluten Wert) als auch aps.pw_badge (das relative Delta) in der iOS-Payload. Android überträgt den entsprechenden Wert in pw_badges und benötigt das Modul com.pushwoosh:pushwoosh-badge, um ihn auf unterstützten Launchern anzuwenden. Das Speichern einer Push-Benachrichtigung in der Message Inbox setzt oder ändert den Badge-Wert niemals. Beides sind unabhängige Effekte derselben Push-Benachrichtigung.

Vorsicht

Der relative Badge-Wert +1/-1 wird nur von der Notification Service Extension angewendet, und nur, wenn diese installiert und mit einer passenden App Group konfiguriert ist, wie unten beschrieben. Ohne diese Einrichtung wendet das Betriebssystem den absoluten aps.badge-Wert aus der Payload unverändert an. Es gibt keine automatische Inkrementierung.

Wie man Badges einrichtet

Um Badges einzurichten, folgen Sie den nachstehenden Schritten:

1. Fügen Sie eine Notification Service Extension hinzu (File -> New -> Target…)

2. Wählen Sie die „Notification Service Extension“ aus

3. Ersetzen Sie die generierte NotificationService-Klasse durch eine Unterklasse von PushwooshNotificationServiceExtension. Pushwoosh übernimmt für Sie das Zählen der Badges, das Zustellungsereignis, den Download von Anhängen und den Timeout-Fallback:

Swift

import PushwooshFramework

class NotificationService: PushwooshNotificationServiceExtension {}

Objective-C

#import <PushwooshFramework/PushwooshFramework.h>

@interface NotificationService : PushwooshNotificationServiceExtension
@end

@implementation NotificationService
@end

4. Fügen Sie die App-Groups-Fähigkeit zu beiden Zielen hinzu – der Haupt-App und der Notification Service Extension – und verwenden Sie für beide dieselbe App Group.

5. Fügen Sie die App Group ID zur info.plist der Haupt-App hinzu:

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

Die Extension erbt diesen Wert von der Host-App, daher müssen Sie ihn nicht in der info.plist der Extension wiederholen – fügen Sie ihn dort nur hinzu, um den Wert der Host-App zu überschreiben.

Wenn Sie die info.plist-Datei nicht verwenden möchten, geben Sie die App Group im Code an, indem Sie pushwooshAppGroupsName in Ihrer NotificationServiceExtension-Klasse überschreiben:

Swift

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

Objective-C

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

Beispiel

Eine Push-Benachrichtigung mit Badges senden

Wenn Sie eine Push-Benachrichtigung mit Badges aus dem Pushwoosh Control Panel senden möchten, fügen Sie einfach den gewünschten Badge-Wert in das Textfeld Badges ein, wie im Bild unten gezeigt:

Hinweis

Sie können die folgenden Wertformate verwenden, um Badges korrekt zu senden: +1, -1 oder 5. Wenn Sie den Badge-Wert erhöhen möchten, verwenden Sie das „+“-Zeichen**,** wenn Sie die Badges verringern möchten, verwenden Sie das „-“-Zeichen**.** Sie können auch eine genaue Zahl festlegen, indem Sie z.B. 5 ohne Vorzeichen verwenden.

Teilen Sie uns Ihr Feedback mit

Ihr Feedback hilft uns, eine bessere Erfahrung zu schaffen. Daher würden wir uns freuen, von Ihnen zu hören, wenn Sie während des SDK-Integrationsprozesses auf Probleme stoßen. Sollten Sie auf Schwierigkeiten stoßen, zögern Sie bitte nicht, uns Ihre Gedanken über dieses Formular mitzuteilen.