Skip to content

Notifications push riches

Découvrez comment mettre en place des notifications push riches pour le SDK de Braze.

Conditions préalables

Avant de pouvoir utiliser cette fonctionnalité, vous devrez intégrer le SDK Swift Braze. Vous devrez également configurer les notifications push.

Mise en place de notifications push riches

Étape 1 : Création d’une extension de service

Pour créer une extension de service de notification, naviguez vers Fichier > Nouveau > Cible dans Xcode et sélectionnez Extension de service de notification.

Assurez-vous que l’option Embed In Application (Intégrer dans l’application ) est activée pour intégrer l’extension dans votre application.

Étape 2 : Configuration de l’extension du service de notification

Une extension de service de notification est un binaire propre qui est intégré à votre application. Elle doit être configurée dans le portail des développeurs Apple avec son propre ID d’application et son propre profil de provisionnement.

L’ID du bundle de l’extension du service de notification doit être distinct de l’ID du bundle de votre application principale. Par exemple, si l’ID de lot de votre application est com.company.appname, vous pouvez utiliser com.company.appname.AppNameServiceExtension pour votre extension de service.

Étape 3 : Intégration de riches notifications push

Pour obtenir un guide étape par étape sur l’intégration des notifications push enrichies avec BrazeNotificationService, reportez-vous à notre tutoriel.

Pour voir un exemple, reportez-vous à l’utilisation dans NotificationService de notre application Exemples.

Ajouter le framework de notifications push enrichies à votre application

Après avoir suivi le Guide d’intégration du gestionnaire de paquets Swift, ajoutez BrazeNotificationService à votre Notification Service Extension en procédant comme suit :

  1. Dans Xcode, sous Infrastructures et bibliothèques, sélectionnez l’icône d’ajout pour ajouter un framework.

    L'icône plus est située sous Infrastructures et bibliothèques dans Xcode.

  2. Sélectionnez le cadre “BrazeNotificationService”.

    Le framework BrazeNotificationService peut être sélectionné dans la fenêtre modale qui s'ouvre.

Ajoutez ce qui suit à 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 'YourNotificationServiceExtensionTarget' do
  pod 'BrazeNotificationService'
end

# Only include the below if you want to also integrate Push Stories
target 'YourNotificationContentExtensionTarget' do
  pod 'BrazePushStory'
end

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.

Pour ajouter BrazeNotificationService.xcframework à votre Notification Service Extension, voir Intégration manuelle.

Utiliser votre propre UNNotificationServiceExtension

Si vous devez utiliser votre propre UNNotificationServiceExtension, vous pouvez à la place appeler brazeHandle dans votre méthode didReceive.

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

class NotificationService: UNNotificationServiceExtension {

  override func didReceive(
    _ request: UNNotificationRequest,
    withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void
  ) {
    if brazeHandle(request: request, contentHandler: contentHandler) {
      return
    }

    // Custom handling here

    contentHandler(request.content)
  }
}

Étape 4 : Créer une notification enrichie dans votre tableau de bord

Votre équipe Marketing peut également créer des notifications enrichies à partir du tableau de bord. Créez une notification push via le compositeur de push et joignez simplement une image ou un GIF, ou fournissez une URL qui héberge une image, un GIF ou une vidéo. Notez que les ressources sont téléchargées à la réception des notifications push, vous devez donc prévoir des pics importants et synchrones de demandes si vous hébergez votre contenu.

Prerequisites

Before you can use this feature, you’ll need to integrate the Cordova Braze SDK. You’ll also need to set up push notifications.

Setting up rich push notifications

Step 1: Create a notification service extension

In your Xcode project, create a notification service extension. For a full walkthrough, see iOS Rich Push Notifications Tutorial.

Step 2: Add a new target

Open your Podfile and add BrazeNotificationService to the notification service extension target you just created. If BrazeNotificationService is already added to a target, remove it before continuing. To avoid duplicate symbol errors, use static linking.

1
2
3
4
target 'NOTIFICATION_SERVICE_EXTENSION' do
  use_frameworks! :linkage => :static
  pod 'BrazeNotificationService'
end

Replace NOTIFICATION_SERVICE_EXTENSION with the name of your notification service extension. Your Podfile should be similar to the following:

1
2
3
4
target 'MyAppRichNotificationService' do
  use_frameworks! :linkage => :static
  pod 'BrazeNotificationService'
end

Step 3: Reinstall your CocoaPods dependencies

In the terminal, go to your project’s iOS directory and reinstall your CocoaPod dependencies.

1
2
cd PATH_TO_PROJECT/platform/ios
pod install

Prerequisites

Before you can use this feature, you’ll need to integrate the React Native Braze SDK. You’ll also need to set up push notifications.

Using Expo to enable rich push notifications

For the React Native SDK, rich push notifications are available for Android by default.

To enable rich push notifications on iOS using Expo, configure the enableBrazeIosRichPush property to true in your expo.plugins object in app.json:

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "expo": {
    "plugins": [
      [
        "@braze/expo-plugin",
        {
          ...
          "enableBrazeIosRichPush": true
        }
      ]
    ]
  }
}

Lastly, add the bundle identifier for this app extension to your project’s credentials configuration: <your-app-bundle-id>.BrazeExpoRichPush.

CETTE PAGE A-T-ELLE ÉTÉ UTILE?
New Stuff!