Notifications push silencieuses

Conditions préalables

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

Limites d’iOS

Le système d’exploitation iOS peut bloquer les notifications pour certaines fonctionnalités. Notez que si vous rencontrez des difficultés avec ces fonctionnalités, le blocage des notifications silencieuses d’iOS peut en être la cause. Pour plus de détails, consultez la documentation d’Apple sur les méthodes d’instance et les notifications non reçues.

Mise en place de notifications push silencieuses

Pour utiliser les notifications push silencieuses afin de déclencher des tâches en arrière-plan, vous devez configurer votre application de manière à recevoir des notifications même lorsqu’elle est en arrière-plan. Pour ce faire, ajoutez la capacité Background Modes à l’aide du volet Signing & Capabilities à la cible principale de l’application dans Xcode. Cochez la case Remote notifications.

Même avec le mode arrière-plan des notifications à distance activé, le système ne lancera pas votre application en arrière-plan si l’utilisateur a quitté l’application de manière forcée. L’utilisateur doit explicitement lancer l’application ou redémarrer l’appareil avant que l’application ne puisse être automatiquement lancée en arrière-plan par le système.

Pour plus d’informations, consultez la documentation sur l’envoi de mises à jour en arrière-plan et la documentation de application:didReceiveRemoteNotification:fetchCompletionHandler:.

Envoi de notifications push silencieuses

Pour envoyer une notification push silencieuse, définissez l’indicateur content-available sur 1 dans le payload d’une notification push.

Remarque

Ce qu’Apple appelle une notification à distance est simplement une notification push normale avec l’indicateur content-available activé.

L’indicateur content-available peut être défini dans le tableau de bord de Braze ainsi que dans notre objet Apple push via l’API d’envoi de messages.

Avertissement

Il n’est pas recommandé d’associer un titre et un corps avec content-available=1, car cela peut entraîner un comportement indéfini. Pour qu’une notification soit véritablement silencieuse, excluez à la fois le titre et le corps lorsque vous définissez l’indicateur content-available sur 1. Pour plus de détails, consultez la documentation officielle d’Apple sur les mises à jour en arrière-plan.

Lors de l’envoi d’une notification push silencieuse, vous pouvez également inclure des données dans le payload de la notification, afin que votre application puisse référencer l’événement. Cela peut vous éviter quelques requêtes réseau et améliorer la réactivité de votre application.

Ignorer les notifications push internes

Braze utilise des notifications push silencieuses pour gérer en interne certaines fonctionnalités avancées, telles que le suivi des désinstallations. Si votre application effectue des actions automatiques au lancement ou lors de pushs en arrière-plan, envisagez de conditionner cette activité afin qu’elle ne soit pas déclenchée par des notifications push internes.

Par exemple, si votre logique appelle vos serveurs pour obtenir du nouveau contenu à chaque push en arrière-plan ou lancement d’application, vous souhaiterez peut-être empêcher le déclenchement des pushs internes de Braze afin d’éviter un trafic réseau inutile. Étant donné que Braze envoie certains types de pushs internes à tous les utilisateurs à peu près au même moment, une charge serveur importante peut survenir si les appels réseau au lancement provenant de pushs internes ne sont pas contrôlés.

Étape 1 : Vérifiez les actions automatiques de votre application

Vérifiez que votre application ne contient pas d’actions automatiques aux endroits suivants et mettez à jour votre code pour ignorer les pushs internes de Braze :

1. Récepteurs de push. Les notifications push en arrière-plan appellent application:didReceiveRemoteNotification:fetchCompletionHandler: sur le UIApplicationDelegate.
2. Délégué d’application. Les pushs en arrière-plan peuvent lancer les applications suspendues en arrière-plan, déclenchant les méthodes application:willFinishLaunchingWithOptions: et application:didFinishLaunchingWithOptions: sur votre UIApplicationDelegate. Vérifiez les launchOptions de ces méthodes pour déterminer si l’application a été lancée à partir d’un push en arrière-plan.

Étape 2 : Utilisez la méthode utilitaire de push interne

Vous pouvez utiliser la méthode utilitaire statique dans Braze.Notifications pour vérifier si votre application a reçu ou a été lancée par un push interne de Braze. Braze.Notifications.isInternalNotification(_:) renvoie true pour toutes les notifications push internes de Braze, ce qui inclut le suivi des désinstallations et les notifications de synchronisation des indicateurs de fonctionnalité.

Par exemple :

• swift
• objective-c

1
2
3
4
5
6
7
func application(_ application: UIApplication,
                 didReceiveRemoteNotification userInfo: [AnyHashable : Any],
                 fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
  if (!Braze.Notifications.isInternalNotification(userInfo)) {
    // Gated logic here (for example pinging server for content)
  }
}

1
2
3
4
5
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler {
  if (![BRZNotifications isInternalNotification:userInfo]) {
    // Gated logic here (for example pinging server for content)
  }
}