Warnung

Das AppboyKit (auch bekannt als Objective-C SDK) wird nicht mehr unterstützt und wurde durch das Swift SDK. ] ersetzt. Es wird keine neuen Features, Fehlerbehebungen, Sicherheitsupdates oder technischen Support mehr erhalten - Messaging und Analytics werden jedoch weiterhin wie gewohnt funktionieren. Weitere Informationen finden Sie unter Einführung in das neue Braze Swift SDK.

Aktions-Buttons

Das Braze iOS SDK unterstützt die standardmäßigen Push-Kategorien, einschließlich URL-Handling für jeden Push-Action-Button. Die Standard-Kategorien verfügen derzeit über vier Sets von Push-Action-Buttons: Accept/Decline, Yes/No, Confirm/Cancel und More.

Um unsere Standard-Push-Kategorien zu registrieren, folgen Sie den Anweisungen zur Integration:

1. Schritt: Hinzufügen von Braze Standard-Push-Kategorien

Verwenden Sie den folgenden Code, um sich für unsere Standard-Push-Kategorien zu registrieren, wenn Sie sich für Push anmelden:

• objective-c
• swift

1
2
3
4
5
6
7
8
9
// For UserNotification.framework (iOS 10+ only)
NSSet *appboyCategories = [ABKPushUtils getAppboyUNNotificationCategorySet];
[[UNUserNotificationCenter currentNotificationCenter] setNotificationCategories:appboyCategories];

// For UIUserNotificationSettings (before iOS 10)
NSSet *appboyCategories = [ABKPushUtils getAppboyUIUserNotificationCategorySet];
UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:UIUserNotificationTypeBadge
                                                                         categories:appboyCategories];
[[UIApplication sharedApplication] registerUserNotificationSettings:settings];

1
2
3
4
5
6
7
8
// For UserNotification.framework (iOS 10+ only)
let appboyCategories = ABKPushUtils.getAppboyUNNotificationCategorySet()
UNUserNotificationCenter.current().setNotificationCategories(appboyCategories)

// For UIUserNotificationSettings (before iOS 10)
let appboyCategories = ABKPushUtils.getAppboyUIUserNotificationCategorySet()
let settings = UIUserNotificationSettings.init(types: .badge, categories: appboyCategories)
UIApplication.shared.registerUserNotificationSettings(settings)

Wenn Sie auf Push-Action-Buttons mit Hintergrundaktivierung klicken, wird nur die Benachrichtigung geschlossen und die App nicht geöffnet. Wenn Nutzer:innen die App das nächste Mal öffnen, werden die Klick-Analytics für diese Aktionen an den Server übertragen.

Wenn Sie Ihre eigenen angepassten Benachrichtigungskategorien erstellen möchten, lesen Sie den Abschnitt zur Anpassung der Aktions-Buttons.

2. Schritt: Aktivieren der interaktiven Push-Verarbeitung

Wenn Sie das UNNotification-Framework verwenden und Braze-Delegates implementiert haben, sollten Sie diese Methode bereits integriert haben.

Um die Verarbeitung von Push-Action-Buttons, einschließlich Klick-Analytics und URL-Routing, zu aktivieren, fügen Sie den folgenden Code in die Delegate-Methode (void)userNotificationCenter:didReceiveNotificationResponse:withCompletionHandler: Ihrer App ein:

• objective-c
• swift

1
2
3
[[Appboy sharedInstance] userNotificationCenter:center
                           didReceiveNotificationResponse:response
                               withCompletionHandler:completionHandler];

1
2
3
Appboy.sharedInstance()?.userNotificationCenter(center,
                                                didReceive: response,
                                                withCompletionHandler: completionHandler)

Wenn Sie das UNNotification-Framework nicht verwenden, müssen Sie den folgenden Code in die Methode application:handleActionWithIdentifier:forRemoteNotification:completionHandler: Ihrer App einfügen, um die Verarbeitung unserer Push-Action-Buttons zu aktivieren:

• objective-c
• swift

1
2
3
[[Appboy sharedInstance] getActionWithIdentifier:identifier
                           forRemoteNotification:userInfo
                               completionHandler:completionHandler];

1
2
3
Appboy.sharedInstance()?.getActionWithIdentifier(identifier,
                                                 forRemoteNotification: userInfo,,
                                                 completionHandler: completionHandler)

Wichtig

Wir empfehlen Nutzer:innen von handleActionWithIdentifier dringend, auf das UNNotification-Framework umzusteigen. Wir empfehlen dies aufgrund der Deprecation von handleActionWithIdentifier.

Anpassung der Push-Kategorie

Braze bietet nicht nur eine Reihe von Standard-Push-Kategorien, sondern unterstützt auch angepasste Benachrichtigungskategorien und Aktionen. Nachdem Sie Kategorien in Ihrer Anwendung registriert haben, können Sie das Braze-Dashboard verwenden, um Benachrichtigungskategorien an Ihre Nutzer:innen zu senden.

Wenn Sie nicht das UserNotifications-Framework verwenden, lesen Sie die Dokumentation zu den alternativen Kategorien.

Diese Kategorien können dann über unser Dashboard Push-Benachrichtigungen zugewiesen werden, um die Aktions-Button-Konfigurationen Ihres Designs zu triggern. Hier ist ein Beispiel, das die LIKE_CATEGORY nutzt, die auf dem Gerät angezeigt wird: