Notifications push riches

Conditions préalables

Avant de pouvoir utiliser cette fonctionnalité, vous devrez intégrer le SDK Swift Braze. Il vous sera également nécessaire de configurer les notifications push.

Configuration des notifications push riches

É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 : Ajouter un groupe d’applications

Dans Xcode, veuillez ajouter la fonctionnalité Groupe d’applications à partir du volet Signing&Capabilities à votre cible d’application principale ainsi qu’à la cible Notification Service Extension. Ensuite, cliquez sur le bouton +. Utilisez l’ID de l’ensemble de votre application pour créer le groupe d’applications. Par exemple, si l’ID de l’ensemble de votre application est com.company.appname, vous pouvez nommer votre groupe d’applications group.com.company.appname.xyz.

Il est nécessaire de disposer d’un groupe d’applications partagé afin que votre application principale et l’extension de service de notification puissent accéder aux données partagées. Si vous n’ajoutez pas votre application à un groupe d’applications, il est possible que certains champs de la charge utile push ne soient pas renseignés et que votre application ne fonctionne pas correctement.

Étape 4 : 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

• swift package manager
• cocoapods
• manual

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

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 5 : Configuration du groupe d’applications dans Braze

Avant d’initialiser Braze, assignez le nom de votre groupe d’applications à la propriété push.appGroup de votre configuration Braze.

1
2
3
4
let configuration = Braze.Configuration(apiKey: "<YOUR-BRAZE-API-KEY>",
                                        endpoint: "<YOUR-BRAZE-ENDPOINT>")
configuration.push.appGroup = "REPLACE_WITH_APPGROUP"
let braze = Braze(configuration: configuration)

Étape 6 : 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. Veuillez créer une notification push via le compositeur de notifications push et joindre une image ou un GIF, ou fournir une URL hébergeant 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.