Des notifications riches
Les notifications riches sont des notifications push avec des images, des GIF et des vidéos. Pour activer cette fonctionnalité, vous devez créer une extension de service de notification - un type d’extension qui permet de modifier une charge utile push avant qu’elle ne soit affichée. Reportez-vous à la page
UNNotificationAttachment
pour obtenir la liste des types et tailles de fichiers pris en charge.
Étape 1 : Création d’une extension de service
Pour créer une extension de service de notification, naviguez vers Fichier > Nouveau > Cible dans Xcode et sélectionnez Extension de service de notification.
Assurez-vous que l’option Embed In Application (Intégrer dans l’application ) est activée pour intégrer l’extension dans votre application.
Étape 2 : Configuration de l’extension du service de notification
Une extension de service de notification est un binaire propre qui est intégré à votre application. Elle doit être configurée dans le portail des développeurs Apple avec son propre ID d’application et son propre profil de provisionnement.
L’ID du bundle de l’extension du service de notification doit être distinct de l’ID du bundle de votre application principale. Par exemple, si l’ID de lot de votre application est com.company.appname
, vous pouvez utiliser com.company.appname.AppNameServiceExtension
pour votre extension de service.
Étape 3 : Intégration de riches notifications push
Pour obtenir un guide étape par étape sur l’intégration des notifications push enrichies avec BrazeNotificationService
, reportez-vous à notre tutoriel.
Pour voir un exemple, reportez-vous à l’utilisation dans NotificationService
de notre application Exemples.
Ajouter le framework de notifications push enrichies à votre application
Après avoir suivi le Guide d’intégration du gestionnaire de paquets Swift, ajoutez BrazeNotificationService
à votre Notification Service Extension
en procédant comme suit :
-
Dans Xcode, sous Infrastructures et bibliothèques, sélectionnez l’icône d’ajout pour ajouter un framework.
-
Sélectionnez le cadre “BrazeNotificationService”.
Ajoutez ce qui suit à votre Podfile :
1
2
3
4
5
6
7
8
9
10
11
12
13
14
target 'YourAppTarget' do
pod 'BrazeKit'
pod 'BrazeUI'
pod 'BrazeLocation'
end
target 'YourNotificationServiceExtensionTarget' do
pod 'BrazeNotificationService'
end
# Only include the below if you want to also integrate Push Stories
target 'YourNotificationContentExtensionTarget' do
pod 'BrazePushStory'
end
Pour savoir comment mettre en œuvre les contenus push, consultez la documentation.
Après avoir mis à jour le Podfile, naviguez jusqu’au répertoire de votre projet d’application Xcode dans votre terminal et exécutez pod install
.
Pour ajouter BrazeNotificationService.xcframework
à votre Notification Service Extension
, voir Intégration manuelle.
Utiliser votre propre UNNotificationServiceExtension
Si vous devez utiliser votre propre UNNotificationServiceExtension, vous pouvez à la place appeler brazeHandle
dans votre méthode didReceive
.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
import BrazeNotificationService
import UserNotifications
class NotificationService: UNNotificationServiceExtension {
override func didReceive(
_ request: UNNotificationRequest,
withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void
) {
if brazeHandle(request: request, contentHandler: contentHandler) {
return
}
// Custom handling here
contentHandler(request.content)
}
}
Étape 4 : Créer une notification enrichie dans votre tableau de bord
Votre équipe Marketing peut également créer des notifications enrichies à partir du tableau de bord. Créez une notification push via le compositeur de push et joignez simplement une image ou un GIF, ou fournissez une URL qui héberge une image, un GIF ou une vidéo. Notez que les ressources sont téléchargées à la réception des notifications push, vous devez donc prévoir des pics importants et synchrones de demandes si vous hébergez votre contenu.