Conserver les notifications push dans une boîte de réception Content Cards

Gardez les contenus push importants à portée de main, même après qu’une notification a été ignorée. Envoyez une Content Card correspondante dans une boîte de réception in-app personnalisée, puis filtrez cette boîte de réception à l’aide de paires clé-valeur.

À propos de cet exemple

Pyrite Financial, une marque fictive de banque mobile, commence à envoyer des notifications push avec Braze. Lorsqu’un client ignore une notification push, le message disparaît de l’interface de l’appareil.

Les équipes Marketing et Produit souhaitent que les clients puissent ouvrir une boîte de réception persistante à partir d’une icône en forme de cloche dans l’application. Les clients peuvent y consulter à nouveau les alertes de documents disponibles, les avis de transaction et les messages de maintenance planifiée.

Elles utilisent déjà des Content Cards dans une autre partie de l’application (par exemple, pour des articles). Ce modèle ajoute un second emplacement de Content Cards : une boîte de réception qui peut recevoir :

• Une notification push uniquement
• Une Content Card uniquement
• Une notification push accompagnée d’une Content Card correspondante

Un appui sur la notification push et un appui sur la Content Card peuvent renvoyer par deep link vers la même destination (par exemple, les documents). Pour certains messages push, l’appui ouvre directement la boîte de réception.

Cet exemple montre comment orchestrer l’envoi des notifications push et des Content Cards. Pour créer l’interface de la boîte de réception personnalisée dans le SDK, consultez le Tutoriel : Boîtes de réception Content Cards. Pour en savoir plus sur la mise en page des cartes, consultez Créer des Content Cards personnalisées.

Points à prendre en compte

• Les Content Cards restent disponibles jusqu’à 30 jours après leur envoi. Elles sont prises en compte dans la limite de 250 cartes non expirées par utilisateur, cartes ignorées comprises. Chaque payload de carte est limité à 2 Ko après le rendu Liquid. Consultez Créer une Content Card.
• Si vous utilisez déjà des Content Cards ailleurs dans votre application, utilisez des paires clé-valeur (par exemple, feed_type: inbox ou feed_type: article) pour créer des emplacements distincts. Chaque écran n’affiche alors que ses propres cartes. Toutes les cartes partagent un même flux SDK tant que votre application ne les filtre pas. Consultez Personnaliser les flux de Content Cards.
• Les Content Cards s’actualisent automatiquement au début de chaque session. Les actualisations supplémentaires passent par requestContentCardsRefresh. Actualisez à l’ouverture de la boîte de réception ou lors d’un glisser pour actualiser. Évitez les actualisations continues ou à chaque changement d’onglet pour ne pas atteindre les limites de débit d’actualisation.
• Les interfaces de boîte de réception personnalisées doivent enregistrer manuellement les impressions, les clics et les rejets. Les badges de messages non lus (par exemple, un point sur l’icône de cloche) sont gérés par votre application.
• Chaque notification push devant persister dans la boîte de réception nécessite une Content Card correspondante. Incluez les bonnes paires clé-valeur et les bons deep links. Utilisez un modèle de campagne multicanal ou un modèle de Canvas afin que le canal Content Cards soit toujours inclus.
• Utilisez une campagne multicanal pour envoyer simultanément une notification push et une Content Card sans logique de suivi. Utilisez Canvas lorsque vous avez besoin de délais, d’embranchements, de réengagement ou d’étapes ultérieures basées sur l’engagement.

Configuration

Étape 1 : Définir les paires clé-valeur et les deep links de la boîte de réception

Mettez-vous d’accord sur les extras (paires clé-valeur) que l’application utilise pour filtrer les cartes de la boîte de réception et agir en conséquence. Le tableau suivant présente un exemple.

Définissez les destinations de deep link pour chaque cas d’usage. Le tableau suivant présente des exemples de destinations.

Demandez à votre équipe d’ingénierie d’implémenter le filtrage, l’état non lu facultatif et l’analyse à partir de ces clés. Réutilisez les mêmes clés dans chaque Content Card de la boîte de réception.

Étape 2 : Choisir une campagne multicanal ou un Canvas

Choisissez une campagne multicanal ou un Canvas en fonction du parcours. Le tableau suivant compare les deux approches.

Pour un exemple de ce modèle, consultez Content Cards dans Canvas — Boîte de réception des notifications push.

Étape 3 : Configurer l’envoi des messages

Campagne multicanal

1. Accédez à Envoi de messages > Campagnes, sélectionnez Créer une campagne, puis Multicanal.
2. À l’étape Composer, sélectionnez Ajouter un canal et ajoutez les canaux push et Content Cards.
3. Rédigez la notification push. Dans Comportement au clic, définissez le deep link vers la boîte de réception ou une autre destination in-app.
4. Rédigez la Content Card avec un texte identique ou complémentaire. Dans l’onglet Paramètres, sélectionnez Ajouter une nouvelle paire et ajoutez les paires clé-valeur de la boîte de réception définies à l’étape 1. Définissez le deep link de la Content Card.
5. Planifiez une livraison par événement pour des événements tels qu’un nouveau document. Utilisez une livraison planifiée pour les maintenances planifiées. Définissez l’audience.
6. Enregistrez un modèle ou une liste de contrôle afin que les futures campagnes push associées à la boîte de réception incluent le canal Content Cards et les mêmes extras.

Canvas

1. Accédez à Envoi de messages > Canvas, puis sélectionnez Créer un Canvas. Définissez la planification d’entrée et l’audience du parcours (par exemple, un événement personnalisé lorsqu’un document est prêt).
2. Ajoutez une étape Message incluant à la fois les canaux push et Content Cards. Utilisez des étapes Message consécutives si le flux l’exige.
3. Rédigez la notification push et la Content Card de la même façon que pour la campagne, en incluant les deep links et les paires clé-valeur de la boîte de réception.
4. Si vous le souhaitez, ajoutez des étapes ultérieures basées sur l’engagement avec la Content Card. Par exemple, si aucun clic n’a lieu dans les 48 heures, envoyez un message de relance. Avant de vous appuyer sur ces filtres, vérifiez quelles données d’analyse votre boîte de réception personnalisée enregistre.

Étape 4 : Vérifier le comportement de la boîte de réception dans l’application

Avant le lancement, vérifiez avec votre équipe d’ingénierie que l’application :

1. S’abonne une seule fois aux mises à jour des Content Cards, tôt dans le cycle de vie de l’application. Réutilisez un abonnement existant si des Content Cards sont déjà en production ailleurs.
2. Affiche la boîte de réception à partir des cartes en cache, puis l’actualise à l’ouverture ou lors d’un glisser pour actualiser.
3. Filtre les cartes dont les extras correspondent à la boîte de réception (par exemple, feed_type égal à inbox).
4. Enregistre les impressions, les clics et les rejets pour l’interface personnalisée. Sur React Native, utilisez ces méthodes du SDK :
   • getCachedContentCards
   • requestContentCardsRefresh
   • logContentCardImpression
   • logContentCardClicked
   • logContentCardDismissed
   • processContentCardClickAction
   • Privilégiez getCachedContentCards plutôt que la méthode obsolète getContentCards.
5. Ignore éventuellement une carte lorsque le client effectue l’action associée (par exemple, ouvre doc_id dans les documents). Ce comportement s’ajoute à l’appui sur le bouton de rejet dans la boîte de réception.

Étape 5 : Tester les trois modes d’envoi

• Notification push uniquement : La notification arrive et aucune carte n’apparaît dans la boîte de réception.
• Content Card uniquement : La carte apparaît dans la boîte de réception et aucune notification push n’est envoyée.
• Notification push et Content Card : Les deux sont envoyées ensemble et les deep links fonctionnent comme prévu. La carte reste disponible après que la notification push a été ignorée. Le badge de messages non lus, le rejet et l’analyse fonctionnent comme attendu.

Testez l’actualisation dans des conditions de navigation réalistes afin que les limites de débit ne bloquent pas les mises à jour de la boîte de réception pendant les tests.

Articles connexes

• Créer une Content Card
• Content Cards dans Canvas
• Créer une campagne multicanal
• Tutoriel : Boîtes de réception Content Cards
• Créer des Content Cards personnalisées
• Personnaliser le flux de Content Cards
• Enregistrer les données d’analyse des Content Cards
• Créer un message push