Boutons d’action
Le SDK Braze Swift offre une prise en charge de la gestion des URL pour les boutons d’action push.
Il existe quatre ensembles de boutons d’action par défaut pour les catégories de notification push par défaut de Braze : Accept/Decline
, Yes/No
, Confirm/Cancel
et More
.
Si vous souhaitez créer vos propres catégories de notifications personnalisées, consultez la personnalisation des boutons d’action.
Intégration automatique (recommandé)
Lors de l’intégration de la notification push en utilisant l’option de configuration configuration.push.automation
, Braze enregistre automatiquement les boutons d’action pour les catégories de notification push par défaut et gère les analyses de clics sur les boutons d’action de notification push ainsi que le routage des URL.
Intégration manuelle
Pour activer manuellement ces boutons d’action push, enregistrez d’abord les catégories push par défaut. Ensuite, utilisez la méthode de délégué didReceive(_:completionHandler:)
pour activer les boutons d’action push.
Étape 1 : Ajout des catégories de notification push par défaut de Braze
Utilisez le code suivant pour vous inscrire aux catégories push par défaut lorsque vous vous inscrivez à push :
1
UNUserNotificationCenter.current().setNotificationCategories(Braze.Notifications.categories)
1
[[UNUserNotificationCenter currentNotificationCenter] setNotificationCategories:BRZNotifications.categories];
Cliquer sur les boutons d’action push avec le mode d’activation en arrière-plan ne fera que rejeter la notification et n’ouvrira pas l’application. Lorsque l’utilisateur ouvrira à nouveau l’application, l’analyse de clics de bouton pour ces actions sera transmise au serveur.
Étape 2 : Activer la gestion interactive des notifications push
Pour activer la gestion de notre bouton d’action push, y compris l’analyse des clics et le routage des URL, ajoutez le code suivant à la méthode de délégation de votre application didReceive(_:completionHandler:)
:
1
AppDelegate.braze?.notifications.handleUserNotification(response: response, withCompletionHandler: completionHandler)
1
2
[AppDelegate.braze.notifications handleUserNotificationWithResponse:response
withCompletionHandler:completionHandler];
Si vous utilisez le framework UNNotification
et que vous avez implémenté les méthodes de notification de Braze, vous devriez déjà avoir intégré cette méthode.
Personnalisation de la catégorie de notifications push
En plus de fournir un ensemble de catégories de push par défaut, Braze prend en charge les catégories et actions de notification personnalisées. Après avoir enregistré des catégories dans votre application, vous pouvez utiliser le tableau de bord Braze pour envoyer ces catégories de notification personnalisées à vos utilisateurs.
Ces catégories peuvent ensuite être affectées aux notifications push via notre tableau de bord pour déclencher les configurations des boutons d’action de votre conception.
Exemple de catégorie de notification personnalisée
Voici un exemple qui tire parti du LIKE_CATEGORY
affiché sur l’appareil :
Étape 1 : Enregistrer une catégorie
Pour enregistrer une catégorie dans votre application, utilisez une approche similaire à la suivante :
1
2
3
4
5
6
7
8
9
10
Braze.Notifications.categories.insert(
.init(identifier: "LIKE_CATEGORY",
actions: [
.init(identifier: "LIKE_IDENTIFIER", title: "Like", options: [.foreground]),
.init(identifier: "UNLIKE_IDENTIFIER", title: "Unlike", options: [.foreground])
],
intentIdentifiers: []
)
)
UNUserNotificationCenter.current().setNotificationCategories(Braze.Notifications.categories)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
NSMutableSet<UNNotificationCategory *> *categories = [BRZNotifications.categories mutableCopy];
UNNotificationAction *likeAction = [UNNotificationAction actionWithIdentifier:@"LIKE_IDENTIFIER"
title:@"Like"
options:UNNotificationActionOptionForeground];
UNNotificationAction *unlikeAction = [UNNotificationAction actionWithIdentifier:@"UNLIKE_IDENTIFIER"
title:@"Unlike"
options:UNNotificationActionOptionForeground];
UNNotificationCategory *likeCategory = [UNNotificationCategory categoryWithIdentifier:@"LIKE_CATEGORY"
actions:@[likeAction, unlikeAction]
intentIdentifiers:@[]
options:UNNotificationCategoryOptionNone];
[categories addObject:likeCategory];
[UNUserNotificationCenter.currentNotificationCenter setNotificationCategories:categories];
Lorsque vous créez une UNNotificationAction
, vous pouvez spécifier une liste d’options d’action. Par exemple, UNNotificationActionOptions.foreground
permet à vos utilisateurs d’ouvrir votre application après avoir appuyé sur le bouton d’action. Ceci est nécessaire pour les comportements de navigation au clic, tels que « Ouvrir l’application » et « Lien profond dans l’application ». Pour plus d’informations, voir UNNotificationActionOptions
.
Étape 2 : Sélectionnez vos catégories
Après avoir enregistré une catégorie, utilisez le tableau de bord Braze pour envoyer des notifications de ce type aux utilisateurs.
Vous n’avez besoin de définir des catégories de notification personnalisées que pour les boutons d’action avec actions spéciales, telles que le lien profond dans votre application ou l’ouverture d’une URL. Vous n’avez pas besoin de les définir pour les boutons d’action qui ne font que rejeter une notification.
- Dans le tableau de bord Braze, sélectionnez Messagerie > Notifications Push, puis choisissez votre campagne push iOS.
- Sous Composer une notification push, activez les Boutons d’action.
- Dans le menu déroulant Catégorie de notification iOS, sélectionnez Entrez la catégorie iOS personnalisée préenregistrée.
- Enfin, entrez l’une des catégories que vous avez créées plus tôt. L’exemple suivant utilise la catégorie personnalisée :
LIKE_CATEGORY
.