Observabilité de la messagerie
L’observabilité de la messagerie trace les événements de votre Canvas ou de votre Campaign pour vous permettre d’auditer vos envois de messages et de résoudre les problèmes associés. Elle vous aide à repérer des tendances, à voir comment les utilisateurs progressent dans un Canvas et à comprendre pourquoi des messages n’ont peut-être pas été envoyés comme prévu.
Conditions préalables
Pour accéder à Messaging Observability, vous devez disposer de l’autorisation « View Dashboard Reports » pour votre espace de travail.
Concepts clés
Envoyé et distribué
Ce tableau de bord indique comment Braze a traité un message en interne, et non le statut de distribution final du message.
Un message marqué comme « envoyé » dans ce tableau de bord signifie que Braze a bien traité et expédié le message. Pour la plupart des canaux, cela signifie que Braze a transmis le message au partenaire d’envoi tiers concerné. Cela ne garantit toutefois pas sa distribution finale sur l’appareil de l’utilisateur.
Lorsque Braze « envoie » un message, la distribution finale peut dépendre de services externes. Voici quelques exemples pour chaque canal.
| Canal | Exemple de distribution finale |
|---|---|
| Bannières | La bannière a été envoyée et peut être consultée. |
| Content Cards | La carte a été envoyée et peut être consultée. |
| Braze transmet le message à un fournisseur de services d’e-mailing (ESP). L’ESP est ensuite responsable de la distribution finale. Cet ESP peut par exemple signaler un « rebond » si l’adresse e-mail n’est pas valide ou si la boîte de réception est pleine. | |
| Messages in-app | Le message a été consulté par l’utilisateur et une impression a été enregistrée. |
| KakaoTalk | Le message a bien été transmis à un partenaire d’envoi. |
| LINE | Le message a bien été transmis à un partenaire d’envoi. |
| Notification push | Braze transmet le message au service de notification push approprié (comme Apple Push Notification service pour iOS ou Firebase Cloud Messaging pour Android). Ce service est responsable de la distribution finale de la notification sur l’appareil. |
| SMS/MMS/RCS | Braze transmet le message à une passerelle SMS (comme Twilio). Cette passerelle est responsable de la distribution finale à l’opérateur mobile. |
| Webhooks | La requête webhook a bien été effectuée et a renvoyé une réponse 2xx. |
| Le message a bien été transmis à un partenaire d’envoi. |
Événements de progression du Canvas
Pour les Canvas, Messaging Observability affiche également les événements de progression : il s’agit d’enregistrements qui retracent le parcours des utilisateurs, comme leur entrée dans le Canvas, leur entrée dans une étape ou leur sortie du Canvas. Les événements de progression sont distincts des résultats d’envoi des messages. Ils vous permettent de savoir où se trouvent les utilisateurs dans le Canvas.
Fraîcheur des données
La fréquence de mise à jour des données de ce tableau de bord peut varier en fonction de la charge du système. Bien qu’elle ne soit pas garantie, elle est généralement inférieure à une heure.
Configurer le tableau de bord
Vous pouvez ouvrir Messaging Observability depuis l’un de ces emplacements :
- Allez dans Analyse > Générateur de tableaux de bord, puis sélectionnez Messaging Observability dans la liste des tableaux de bord créés par Braze.
- Sur la page d’analyse d’un Canvas ou d’une Campaign, sélectionnez Messaging Observability. Le tableau de bord s’ouvre avec ce Canvas ou cette Campaign présélectionné, lorsque c’est possible.
Pour exécuter le tableau de bord et consulter vos données :
- Sélectionnez une date ou une plage de dates couvrant au maximum les sept derniers jours.
- Sélectionnez Campaigns ou Canvas comme source des rapports de votre tableau de bord.
- Sélectionnez une Campaign ou un Canvas.
- (Facultatif, Canvas uniquement) Sélectionnez une ou plusieurs étapes du Canvas pour limiter les résultats à ces étapes.
- Sélectionnez Exécuter le tableau de bord pour charger les données correspondant aux filtres choisis.

Après avoir modifié un filtre, sélectionnez à nouveau Exécuter le tableau de bord pour actualiser les vignettes récapitulatives, le graphique et le journal des événements. En attendant, le tableau de bord peut afficher l’avertissement « Résultats obsolètes ».

Interpréter les données

Le tableau de bord affiche jusqu’aux sept derniers jours de données. Tous les horodatages s’affichent dans le fuseau horaire de votre espace de travail.
Vignettes récapitulatives
En haut de la page, des vignettes récapitulatives pour la période sélectionnée indiquent :
- Entrées : Toutes les entrées éligibles dans un Canvas ou une campagne évaluées sur la période sélectionnée. Ces chiffres peuvent légèrement différer de la vue analytique, car l’observabilité des messages utilise des données de résolution des problèmes issues de sources différentes.
- Suppressions : Messages que Braze n’a volontairement pas envoyés après l’entrée, par exemple pour des raisons d’éligibilité, de limite de fréquence ou d’heures calmes. Pour en savoir plus, consultez la section Suppressions.
- Échecs : Messages qui ont échoué de manière inattendue, par exemple à cause d’erreurs Liquid, de webhook ou de notification push. Pour en savoir plus, consultez la section Échecs.
- Envoyés : Messages qui ont bien quitté le traitement de Braze. Cela ne garantit pas leur réception par le destinataire, qui dépend du canal, de l’opérateur et de l’appareil. Pour en savoir plus, consultez la section Envoyés et reçus.
Événements au fil du temps
Ce graphique chronologique présente une répartition horaire des événements pour les filtres sélectionnés. Utilisez les vues du graphique pour comparer les totaux de l’aperçu ou pour détailler les suppressions et les échecs par résultat. Les libellés de résultat de ce graphique sont des libellés normalisés du tableau de bord, et non les valeurs brutes du payload des événements.
Journal des événements
Le Journal des événements répertorie les événements individuels que Braze a enregistrés pour chaque utilisateur selon les filtres et la période sélectionnés, principalement des suppressions, des progressions et des échecs. Utilisez-le pour examiner des enregistrements précis, notamment l’horodatage, l’ID utilisateur, l’étape du Canvas, l’événement, la description et le canal de communication.

Filtrez le tableau pour cibler des enregistrements précis :
- Sélectionnez des catégories d’événements ou des événements individuels dans le filtre Événements (par exemple, Suppressions > Limite de fréquence atteinte, ou Progressions > Entrée dans l’étape).
- Saisissez un ID utilisateur dans le champ de recherche pour afficher les lignes de cet utilisateur.
Lorsque vous appliquez les deux filtres, le tableau renvoie les lignes qui correspondent à la fois aux événements sélectionnés et à l’ID utilisateur saisi.
Sélectionnez Afficher sur une ligne pour ouvrir un panneau latéral offrant plus de contexte sur cet événement. Depuis ce panneau, vous pouvez également sélectionner Demander à Operator pour obtenir des conseils de résolution.

Les filtres de canal s’appliquent aux événements liés à un canal de communication spécifique. Certains événements ne dépendent d’aucun canal : ils peuvent donc toujours apparaître dans les vues agrégées, même lorsque vous appliquez un filtre de canal.
Événements de progression
Les événements de progression décrivent la manière dont les utilisateurs avancent dans un Canvas. Ils concernent uniquement les Canvas. L’entrée dans une campagne apparaît sous Entrées en tant que Entrée dans la campagne.

Les libellés des événements de progression dans l’observabilité des messages sont des libellés lisibles du tableau de bord. Les chiffres ou les noms peuvent différer de ceux d’autres outils d’analyse de Braze, car ces jeux de données reposent sur des représentations et des chaînes de traitement différentes.
| Événement de progression | Explication |
|---|---|
| Entrée dans le Canvas | L’utilisateur est entré dans le Canvas. L’entrée peut être planifiée, basée sur une action ou déclenchée par API. Les utilisateurs inscrits dans un groupe de contrôle peuvent également apparaître sous ce libellé. |
| Entrée dans l’étape Parcours d’action | L’utilisateur est entré dans une étape Parcours d’action et a suivi un parcours après une action (ou le parcours « Tous les autres »). |
| Entrée dans l’étape Agent | L’utilisateur est entré dans une étape Agent où le contexte a été évalué. |
| Entrée dans l’étape Parcours d’audience | L’utilisateur est entré dans une étape Parcours d’audience et a suivi un parcours d’audience (ou le parcours « Tous les autres »). |
| Entrée dans l’étape Synchronisation d’audience | L’utilisateur est entré dans une étape Synchronisation d’audience et la synchronisation de l’audience a commencé. |
| Entrée dans l’étape Content Optimizer | L’utilisateur est entré dans une étape Content Optimizer et une variante a été sélectionnée. |
| Entrée dans l’étape Contexte | L’utilisateur est entré dans une étape Contexte où des variables de contexte ont été définies ou évaluées. |
| Entrée dans l’étape Arbre décisionnel | L’utilisateur est entré dans une étape de l’arbre décisionnel et a suivi une branche. |
| Entrée dans l’étape Délai | L’utilisateur est entré dans une étape Délai et il est en attente, passe immédiatement à la suite (par exemple, avec un délai nul) ou progresse d’une autre manière dans cette étape. |
| Entrée dans l’étape Chemins d’expérience | L’utilisateur est entré dans une étape des chemins d’expérience et a été affecté à une variante de l’expérience. |
| Entrée dans l’étape Feature Flag | L’utilisateur est entré dans une étape Feature Flag et les feature flags sont en cours d’évaluation. |
| Entrée dans l’étape Message | L’utilisateur est entré dans une étape Message. Les suppressions, échecs ou envois ultérieurs pour cette étape apparaissent comme des événements distincts. |
| Entrée dans l’étape Envoyer vers la destination | L’utilisateur est entré dans une étape Envoyer vers la destination. Braze vérifie s’il remplit les conditions pour entrer dans le Canvas de destination. |
| Entrée dans l’étape Mise à jour utilisateur | L’utilisateur est entré dans une étape Mise à jour utilisateur. Ses attributs sont en cours de mise à jour, ou il est temporairement retardé par la limitation du débit de l’étape Mise à jour utilisateur. |
| Envoyé vers la destination | L’utilisateur a été envoyé vers le Canvas de destination et est passé à l’étape suivante du Canvas actuel. |
| Non envoyé vers la destination | L’utilisateur n’est pas entré dans le Canvas de destination (par exemple, en raison d’une audience non correspondante) et est passé à l’étape suivante du Canvas actuel. |
| Destination introuvable | Le Canvas de destination est introuvable. L’utilisateur est passé à l’étape suivante du Canvas actuel. |
| Sortie du Canvas | L’utilisateur a quitté le Canvas. Cela se produit lorsque :
|
Suppressions
Les suppressions sont des non-envois volontaires après l’entrée, motivés par des paramètres, l’éligibilité ou des contrôles de distribution.

Les libellés de suppression et d’échec dans l’observabilité des messages sont des libellés lisibles du tableau de bord. Dans les événements d’engagement liés aux messages de Currents, les informations d’abandon sont représentées par des champs tels que abort_type et abort_log. Comme ces jeux de données reposent sur des représentations et des chaînes de traitement différentes, les chiffres ou les noms peuvent différer entre Currents et l’observabilité des messages.
Paramètres d’envoi
| Suppression | Explication |
|---|---|
| Abandon en raison de la priorité | L’envoi a été abandonné, car un autre message de priorité supérieure était déjà en attente pour cet utilisateur, ou ce message a été dépriorisé. |
| Bannière expirée | La bannière a expiré avant de pouvoir être distribuée. |
| Content Card expirée | La content card a expiré avant que l’utilisateur ne la voie. |
| Variante Content Optimizer désactivée | L’affectation de la variante Content Optimizer a été désactivée avant l’envoi. |
| Limite de fréquence atteinte | L’utilisateur a déjà reçu le nombre maximal de messages autorisé par les règles de limite de fréquence de votre espace de travail : l’envoi a donc été annulé. |
| Campagne inactive | La campagne a été arrêtée alors que le message était en cours d’acheminement : il a donc été abandonné. |
| Canvas inactif | Le Canvas a été arrêté avant que l’utilisateur n’entre dans le parcours. |
| Étape du Canvas inactive | Cela peut se produire dans le Canvas si :
|
| Abandon pendant les heures calmes | Les heures calmes étaient activées pour la campagne ou l’étape du Canvas, avec l’option de repli définie sur Abandonner le message. L’utilisateur a déclenché la campagne ou est entré dans l’étape Message du Canvas pendant les heures calmes : le message a donc été abandonné. L’utilisateur ne quitte toutefois pas le Canvas. |
| Volume limité | La campagne ou le Canvas a atteint la limite de volume définie : l’envoi a donc été annulé. |
Éligibilité des utilisateurs
| Suppression | Explication |
|---|---|
| Identifiant utilisateur en double | Plusieurs utilisateurs possédant un identifiant identique (comme un ID externe, une adresse e-mail ou un numéro de téléphone) étaient éligibles pour recevoir ce message. Pour éviter les envois en double au même utilisateur, ce message a été abandonné. |
| Événement d’exception ou de sortie | L’utilisateur était auparavant éligible pour recevoir le message, mais il a :
|
| Échec de la vérification préalable pour l’étape Message | Braze effectue une première série de vérifications de base portant sur l’éligibilité à l’audience, la rééligibilité et l’éligibilité au canal avant les validations complètes de distribution pour une étape Message du Canvas. Ce résultat signifie que l’utilisateur ou le message a échoué à l’une de ces vérifications : le message a donc été abandonné pour cette étape. |
| Échec de la vérification préalable pour le message déclenché | Braze effectue une première série de vérifications de base portant sur l’éligibilité à l’audience, la rééligibilité et l’éligibilité au canal avant de créer un message à envoyer à partir de ce déclencheur. Ce résultat signifie que l’utilisateur ou le message a échoué à l’une de ces vérifications : le message a donc été abandonné. |
| Utilisateur plus éligible | L’utilisateur faisait initialement partie de l’audience cible, mais ne correspondait plus aux critères d’audience avant que Braze n’envoie le message ou ne le fasse entrer dans le Canvas. Le délai entre le moment où l’utilisateur a rempli les critères d’audience et celui où il en est sorti peut s’expliquer par des retards dus à :
|
| Utilisateur non éligible pour le canal | L’utilisateur n’est pas éligible pour recevoir ce message sur le canal sélectionné. Les raisons courantes incluent des identifiants de canal manquants ou non valides, l’absence de jetons push éligibles, des restrictions liées à l’état d’abonnement, une fonctionnalité de canal non prise en charge ou des pays bloqués pour les canaux basés sur le téléphone. |
| Utilisateur non éligible pour l’étape | L’utilisateur n’a pas satisfait aux validations de distribution définies pour l’étape Message ou figurait dans une liste de suppression. Selon les paramètres de Validations de la distribution, l’utilisateur peut avoir quitté le Canvas ou être passé à l’étape suivante. |
| Utilisateur non rééligible | L’utilisateur était éligible pour recevoir le message ou entrer dans le Canvas, mais l’envoi a été annulé en raison des paramètres de rééligibilité ou de rentrée. Cela peut se produire si l’utilisateur a déjà reçu la campagne ou est entré dans le Canvas trop récemment, si un autre envoi de la même campagne est déjà en cours pour cet utilisateur, ou si la rééligibilité ou la rentrée est désactivée. |
Échecs
Les échecs sont des erreurs inattendues survenues lors du traitement ou des tentatives de distribution.
| Échec | Explication |
|---|---|
| Échec du contenu connecté | Braze a tenté d’envoyer le message, mais le contenu connecté a échoué après le nombre maximal de nouvelles tentatives (cinq par défaut). Ce chiffre représente le nombre de messages abandonnés après avoir atteint le nombre maximal de nouvelles tentatives, et non le nombre total de requêtes de contenu connecté ayant échoué. |
| Content Card non valide | La content card comportait des erreurs et n’a pas été envoyée à l’utilisateur. Voici quelques raisons courantes :
|
| Échec de l’étape Délai | L’étape Délai a échoué, ce qui a fait sortir l’utilisateur du Canvas. Cet échec peut se produire lorsque :
|
| Abandon Liquid | L’étiquette Liquid abort_message a été appelée : l’envoi a donc été annulé. |
| Délai de rendu Liquid dépassé | Le rendu du modèle Liquid a pris trop de temps. Cela se produit le plus souvent pour les bannières, les messages in-app et les e-mails. |
| Erreur de syntaxe Liquid | Le modèle Liquid comportait une erreur d’analyse : le message a donc été annulé. |
| Échec de l’URL du média | Braze n’a pas pu traiter l’URL du média dans le message. Cela peut se produire lorsque l’URL est bloquée, non valide, expire, renvoie un statut HTTP non valide ou échoue à la validation SSL. |
| Erreur de distribution du partenaire | Braze a tenté d’envoyer ce message à votre partenaire de distribution pendant 24 heures, mais celui-ci a renvoyé des erreurs temporaires pendant toute cette période. |
| Recommandation produit non valide | La recommandation produit ou la sélection de catalogue n’a pas pu être utilisée pour cet envoi. Les raisons courantes incluent une recommandation manquante ou archivée, un entraînement incomplet ou des filtres ayant exclu tous les articles du catalogue. |
| Identifiants push non valides | Les identifiants push de cette application sont manquants ou non valides : l’envoi a donc été annulé. Mettez à jour vos identifiants dans Paramètres de l’application. |
| Débit limité pendant plus de 72 heures | Le message a été bridé pendant plus de 72 heures en raison des limites de débit de la vitesse de distribution : l’envoi a donc été abandonné. |
| Échec du groupe d’abonnement | Le message n’a pas pu être envoyé en raison de problèmes de configuration du groupe d’abonnement ou du service de messagerie. Les raisons courantes incluent l’absence de numéros d’envoi pour les SMS ou WhatsApp, ou des MMS non pris en charge par le service de messagerie configuré. |
| Profil utilisateur introuvable | L’utilisateur n’a jamais existé ou n’existe plus dans Braze. Voici quelques cas courants :
|
| Échec du webhook | Le webhook a reçu un code de réponse d’échec (autre que 2xx). Les codes d’erreur courants peuvent être des erreurs client 4XX, des erreurs serveur ou des délais d’attente dépassés 5XX, ou encore 598 Host Unhealthy ou des requêtes brièvement interrompues. |
| Autre | Échecs qui n’entrent dans aucune des autres catégories de ce tableau. Si vous constatez une proportion importante d’échecs de type Autre, contactez l’assistance Braze pour obtenir de l’aide. |
Foire aux questions
Que signifie un échec de « pré-vérification » ?
Une « pré-vérification » désigne un contrôle de validation groupé et ultrarapide, exécuté au tout début d’une étape du pipeline (par exemple lorsqu’un message est déclenché ou lors de l’envoi d’une étape Message d’un Canvas). Considérez-la comme une sortie anticipée conçue pour une vitesse maximale. Au lieu d’exécuter de nombreux contrôles distincts et gourmands en ressources (comme la validation de chaque détail du profil d’un utilisateur), Braze regroupe plusieurs validations de base en une seule « première passe ».
Si un utilisateur échoue à ce contrôle groupé unique, il est immédiatement écarté. Cette approche groupée permet à Braze de traiter des volumes massifs de messages à grande vitesse. Elle peut aussi contribuer à des performances plus rapides et plus stables pour vos campagnes et vos Canvas, en réduisant la latence de traitement de chaque message.
Que signifie un échec « Autre » ?
Il s’agit d’échecs qui n’entrent dans aucune des catégories existantes du tableau de bord. Si vous constatez toujours une proportion importante d’échecs « Autre », contactez l’assistance Braze pour obtenir de l’aide.
Pourquoi la somme des Entrées, Suppressions, Échecs et Envois ne correspond-elle pas à la taille d’audience attendue ?
Plusieurs raisons peuvent l’expliquer :
- Critères d’audience : il est possible que moins d’utilisateurs que prévu aient rempli les critères d’audience (par exemple, ils ne faisaient pas partie du segment ou ne possédaient pas les attributs nécessaires) au moment du lancement de la campagne ou du Canvas.
- Traitement en cours : des messages ou des étapes du Canvas sont peut-être encore en cours de traitement. Des utilisateurs peuvent encore se trouver dans des étapes antérieures du Canvas et n’avoir atteint aucune étape Message.
- Progression sans envoi : des utilisateurs peuvent générer des événements de progression (par exemple en entrant dans une étape Délai ou Arbre décisionnel) sans suppression, échec ou envoi correspondant sur la même période.
- Fraîcheur des données : les données du tableau de bord sont mises à jour environ toutes les 15 minutes, mais ce délai n’est pas garanti. Les données les plus récentes de cette campagne ou de ce Canvas ne sont peut-être pas encore arrivées dans le tableau de bord.
- Cas particuliers : il est possible, dans de rares cas, que vous rencontriez un cas particulier que ce tableau de bord ne prend pas encore en compte. Si vous pensez que c’est le cas, contactez l’assistance Braze.
Pourquoi les totaux des vignettes ou du journal des événements peuvent-ils dépasser l’audience d’une campagne ou d’un Canvas ?
Cela peut se produire pour les raisons suivantes :
- Messages multicanaux : la campagne ou l’étape du Canvas a été configurée pour envoyer sur plusieurs canaux (par exemple SMS et e-mail). Un même utilisateur peut obtenir un résultat « envoyé » sur un canal (comme l’e-mail) et une suppression ou un échec sur un autre (comme « Utilisateur non éligible pour le canal »). Dans ce cas, cet utilisateur est comptabilisé plusieurs fois dans les vignettes et le journal des événements.
- Par exemple, vous envoyez une campagne de notifications push à 100 utilisateurs, en ciblant à la fois iOS et Android. Si un utilisateur ne possède qu’un appareil iOS, il reçoit la notification push iOS (« envoyé »), mais déclenche aussi une suppression pour la notification push Android (« Utilisateur non éligible pour le canal »).
- Plusieurs étapes Message (Canvas uniquement) : votre Canvas peut comporter plusieurs étapes Message dans un même parcours. Ce tableau de bord agrège tous les événements : un même utilisateur peut donc être comptabilisé plusieurs fois s’il traverse plusieurs étapes au cours de la période sélectionnée.
- Messages de test : les envois de test (comptabilisés dans le tableau de bord) peuvent faire dépasser la taille de l’audience par les totaux.