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 framework UNNotification.

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

Configuration du contenu push

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

Dans votre projet d’application, accédez au menu File > New > Target, ajoutez une nouvelle cible Notification Content Extension et activez-la.

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

• NotificationViewController.swift
• MainInterface.storyboard

Étape 2 : Activation des capacités

Dans Xcode, ajoutez la capacité Background Modes à la cible principale de l’application à l’aide du volet Signing & Capabilities. Cochez les cases Background fetch et Remote notifications.

Ajouter un groupe d’applications

De plus, à 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’identifiant de bundle de votre application pour créer le groupe d’applications. Par exemple, si l’identifiant de bundle de votre application est com.company.appname, vous pouvez nommer votre groupe d’applications group.com.company.appname.xyz.

Important

Les groupes d’applications dans ce contexte font référence à l’App Groups Entitlement d’Apple et non à votre identifiant d’espace de travail Braze (anciennement groupe d’applications).

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

Étape 3 : Ajout du framework Push Story à votre application

• gestionnaire de paquets swift
• cocoapods
• manuel

Après avoir suivi le guide d’intégration du gestionnaire de paquets Swift, ajoutez BrazePushStory à votre Notification Content Extension :

Ajoutez la ligne suivante à 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 'YourNotificationContentExtensionTarget' do
pod 'BrazePushStory'
end

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

Remarque

Pour savoir comment implémenter les notifications push enrichies, consultez Notifications enrichies.

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.

Téléchargez le dernier BrazePushStory.zip depuis la page des versions GitHub, extrayez-le et ajoutez le BrazePushStory.xcframework à l’Notification Content Extension de votre projet.

Important

Assurez-vous que Do Not Embed est sélectionné pour BrazePushStory.xcframework dans la colonne Embed.

Étape 4 : Mise à jour de votre contrôleur de vue 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 de contenu push

Si vous souhaitez implémenter votre propre logique personnalisée pour gérer les événements de notification de contenu push, héritez de BrazePushStory.NotificationViewController comme ci-dessus et surchargez 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 :

Ajoutez également le dictionnaire Braze de niveau supérieur suivant au même fichier Info.plist, en remplaçant REPLACE_WITH_APPGROUP par le groupe d’applications que vous avez créé à l’étape 2 :

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)