Contenu push

Prerequisites

Before you can use this feature, you’ll need to integrate the Cordova Braze SDK. Vous devrez également mettre en place les notifications push, ce qui implique l’implémentation du framework UNNotification.

Les versions SDK suivantes sont nécessaires pour recevoir des Push Stories :

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é Modes d’arrière-plan en utilisant le volet Signature et capacités pour la cible principale de l’application. Sélectionnez les cases à cocher Récupération en arrière-plan et Notifications à distance.

Ajouter un groupe d’applications

De plus, depuis le volet Signature et capacités dans Xcode, ajoutez la capacité Groupes d’applications à votre cible d’application principale ainsi qu’aux cibles d’extension de contenu de notification. 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

• gestionnaire de paquets swift
• cocoapods
• manual (manuel)

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)