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 URLs 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: 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 verworfen und die App nicht geöffnet. Wenn der Nutzer die App das nächste Mal öffnet, werden die Analytics für die Klicks auf diese Aktionen auf den Server übertragen.

Wenn Sie Ihre eigenen angepassten Benachrichtigungskategorien erstellen möchten, sehen Sie sich die Anpassung der Aktions-Buttons an.

Schritt 2: Enablement der interaktiven Push-Bearbeitung

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 Click 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 Ihre App application:handleActionWithIdentifier:forRemoteNotification:completionHandler: einfügen, um die Handhabung 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 bei Verwendung von handleActionWithIdentifier dringend, mit dem UNNotification-Framework zu beginnen. Wir empfehlen dies aufgrund der Veralterung 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 Aktion-Button-Konfigurationen Ihres Designs zu triggern. Hier ist ein Beispiel, das die LIKE_CATEGORY nutzt, die auf dem Gerät angezeigt wird: