Contenu push

Conditions préalables

Avant de pouvoir utiliser cette fonctionnalité, vous devrez intégrer le SDK Swift Braze. Vous devrez également configurer les notifications push, ce qui implique la mise en œuvre du cadre UNNotification.

La version minimale suivante du SDK est requise pour recevoir les contenus push :

Mise en place des contenus push

Étape 1 : Ajout de la cible d’extension de contenu de notification

Dans votre projet d’application, sélectionnez Fichier > Nouveau > Cible, ajoutez une nouvelle cible Notification Content Extension et activez-la.

Xcode doit générer une nouvelle cible pour vous et créer des fichiers automatiquement pour vous, notamment :

• NotificationViewController.swift
• MainInterface.storyboard

Étape 2 : Activation des capacités

Dans Xcode, ajoutez la capacité Background Modes à l’aide du volet Signing & Capabilities à la cible de l’app principale. Sélectionnez les cases à cocher Récupération en arrière-plan et Notifications à distance.

Ajouter un groupe d’applications

En outre, à partir du volet Signing & Capabilities dans Xcode, ajoutez la capacité App Groups à votre cible d’application principale ainsi qu’aux cibles Notification Content 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.

Si vous n’ajoutez pas votre application à un groupe d’applications, votre application peut ne pas remplir certains champs de la charge utile de la notification push et ne fonctionnera pas entièrement comme prévu.

Étape 3 : Ajout du framework Push Story à 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 'YourNotificationContentExtensionTarget' do
pod 'BrazePushStory'
end

# Only include the below if you want to also integrate Rich Push
target 'YourNotificationServiceExtensionTarget' do
pod 'BrazeNotificationService'
end

Étape 4 : Mise à jour de votre contrôleur de visualisation de notification

Dans NotificationViewController.swift, ajoutez la ligne suivante pour importer les fichiers d’en-tête :

1
import BrazePushStory

Ensuite, remplacez l’implémentation par défaut en héritant de BrazePushStory.NotificationViewController :

1
class NotificationViewController: BrazePushStory.NotificationViewController {}

Gestion personnalisée des événements d’histoire push

Si vous souhaitez implémenter votre propre logique personnalisée pour gérer les événements de notification d’histoire push, héritez de BrazePushStory.NotificationViewController comme ci-dessus et remplacez les méthodes didReceive comme ci-dessous.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
import BrazePushStory
import UserNotifications
import UserNotificationsUI

class NotificationViewController: BrazePushStory.NotificationViewController {
  override func didReceive(_ notification: UNNotification) {
    super.didReceive(notification)
    
    // Custom handling logic
  }
  
  override func didReceive(_ response: UNNotificationResponse, completionHandler completion: @escaping (UNNotificationContentExtensionResponseOption) -> Void) {
    super.didReceive(response, completionHandler: completion)
    
    // Custom handling logic
  }
}

Étape 5 : Définir le fichier plist de l’extension de contenu de notification

Ouvrez le fichier Info.plist de l’Notification Content Extension, puis ajoutez et modifiez les clés suivantes sous NSExtension \ NSExtensionAttributes :

Votre fichier Info.plist doit correspondre à l’image suivante :

Étape 6 : Mise à jour de l’intégration Braze dans votre application principale

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)