Contenu push

Conditions préalables

Avant de pouvoir utiliser cette fonctionnalité, vous devrez intégrer le SDK Braze Swift. 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 : Ajouter la cible Notification Content Extension

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

Xcode devrait générer automatiquement une nouvelle cible et créer les fichiers suivants :

• NotificationViewController.swift
• MainInterface.storyboard

Étape 2 : Activer les capacités

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

Ajouter un groupe d’applications

De plus, depuis le panneau Signing & Capabilities dans Xcode, ajoutez la capacité App Groups à la cible principale de votre application ainsi qu’aux cibles Notification Content Extension. Cliquez ensuite 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

Dans ce contexte, les groupes d’applications font référence au droit App Groups d’Apple et non à l’identifiant de votre espace de travail Braze (anciennement groupe d’applications).

Si vous n’ajoutez pas votre application à un groupe d’applications, votre application risque de ne pas remplir certains champs du payload push et ne fonctionnera pas pleinement comme prévu.

Étape 3 : Ajouter le 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 les instructions d’implémentation des notifications push enrichies, consultez Notifications enrichies.

Après avoir mis à jour le Podfile, accédez au répertoire de votre projet d’application Xcode dans votre terminal et exécutez pod install.

Téléchargez le dernier fichier BrazePushStory.zip depuis la page des versions GitHub, extrayez-le et ajoutez le BrazePushStory.xcframework à la 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 : Mettre à jour 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 indiqué dans l’exemple précédent et surchargez les méthodes didReceive dans l’exemple suivant.

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 : Configurer le plist de la Notification Content Extension

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

De plus, ajoutez 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 devrait correspondre à l’image suivante :

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

Avant d’initialiser Braze, attribuez 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)