Contenu push

Les contenus push permettent aux marketeurs d’utiliser la fonctionnalité de carrousel de photos pour créer une séquence de pages au sein d’une notification push. Ces pages se composent d’une image, d’une action de clic, d’un titre et d’une description.

La configuration des Push Stories pour votre application iOS nécessite des étapes supplémentaires au-delà de l’intégration des notifications push standard, qui sont décrites dans cet article.

Conditions préalables

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

Assurez-vous d’avoir suivi le didacticiel d’intégration des notifications push pour activer les notifications push dans votre application. Dans le cadre de cette tâche, vous devriez avoir implémenté le framework UNNotification, qui est nécessaire pour cette fonctionnalité.

É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)