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:

Schritt 1: Standard-Push-Kategorien von Braze hinzufügen

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

• 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)

Das Tippen auf Push-Action-Buttons mit Hintergrundaktivierungsmodus schließt lediglich die Benachrichtigung und öffnet nicht die App. Wenn Nutzer:innen die App das nächste Mal öffnen, werden die Klick-Analytics für diese Aktionen an den Server übermittelt.

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

Schritt 2: Interaktive Push-Behandlung aktivieren

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

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

• 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 zu application:handleActionWithIdentifier:forRemoteNotification:completionHandler: Ihrer App hinzufügen, um unsere Behandlung von 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 dringend, dass Nutzer:innen, die handleActionWithIdentifier verwenden, auf das UNNotification-Framework umsteigen. Wir empfehlen dies aufgrund der Einstellung von handleActionWithIdentifier.

Anpassung der Push-Kategorie

Zusätzlich zu einem Satz von Standard-Push-Kategorien unterstützt Braze angepasste Benachrichtigungskategorien und -aktionen. Nachdem Sie Kategorien in Ihrer App registriert haben, können Sie das Braze-Dashboard verwenden, um Benachrichtigungskategorien an Ihre Nutzer:innen zu senden.

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

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