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 « Afficher les rapports du tableau de bord » 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é. Toutefois, cela ne garantit pas sa distribution finale sur l’appareil de l’utilisateur.
Lorsque Braze « envoie » un message, sa 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). Ce fournisseur est ensuite responsable de la distribution finale. Il 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. |
| 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 dans les Canvas
Pour les Canvas, Messaging Observability affiche également les événements de progression : il s’agit d’enregistrements de la manière dont les utilisateurs avancent dans le parcours, par exemple lorsqu’ils entrent dans le Canvas, entrent dans une étape ou quittent le Canvas. Les événements de progression sont distincts des résultats d’envoi des messages. Ils vous aident à 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 que cette fréquence ne soit pas garantie, elle est probablement inférieure à une heure dans la plupart des cas.
Configurer le tableau de bord
Vous pouvez ouvrir Messaging Observability depuis l’un des emplacements suivants :
- 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 une page d’analyse de Canvas ou de campagne, sélectionnez Messaging Observability. Le tableau de bord s’ouvre alors avec ce Canvas ou cette campagne présélectionné(e), si 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 campagne 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. Tant que vous ne l’avez pas fait, 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 présentent les informations suivantes pour la période sélectionnée :
- Entrées : Toutes les entrées éligibles dans un Canvas ou une campagne évaluées pendant la période sélectionnée. Ces chiffres peuvent légèrement différer de la vue analytique, car Messaging Observability s’appuie sur des données de résolution des problèmes issues d’autres sources.
- 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 plus de détails, consultez Suppressions.
- Échecs : Messages qui ont échoué de manière inattendue, par exemple à cause d’erreurs Liquid, de webhook ou de notification push. Pour plus de détails, consultez É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 plus de détails, consultez Envoyés et reçus.
Événements au fil du temps
Ce graphique chronologique présente une ventilation horaire des événements correspondant aux filtres sélectionnés. Utilisez les vues du graphique pour comparer les totaux globaux ou pour ventiler 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 vous concentrer sur des enregistrements spécifiques :
- 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 concernant 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 contenant 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 sont indépendants du 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 façon dont les utilisateurs avancent dans un Canvas. Ils concernent uniquement les Canvas. L’entrée dans une campagne apparaît sous Entrées avec le libellé Entrée dans la campagne.
Les libellés des événements de progression dans Messaging Observability sont des libellés lisibles propres au tableau de bord. Les chiffres ou les dénominations peuvent différer de ceux d’autres surfaces d’analyse de Braze, car ces jeux de données ont des représentations et des chemins de traitement différents.
| É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 emprunté 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 emprunté 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 Optimiseur de contenu | L’utilisateur est entré dans une étape Optimiseur de contenu 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 emprunté une branche. |
| Entrée dans l’étape Délai | L’utilisateur est entré dans une étape Délai et il est en attente, avance immédiatement (par exemple, en cas de 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 d’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 sous forme d’é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 de l’utilisateur | L’utilisateur est entré dans une étape Mise à jour de l’utilisateur. Les attributs utilisateur sont en cours de mise à jour, ou l’utilisateur est temporairement retardé par la limitation du débit de l’étape Mise à jour de l’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 dans les cas suivants :
|
Suppressions
Les suppressions sont des non-envois volontaires après l’entrée, dictés par des paramètres, des règles d’éligibilité ou des contrôles de distribution.
Les libellés de suppression et d’échec dans Messaging Observability sont des libellés lisibles propres au 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 ont des représentations et des chemins de traitement différents, les chiffres ou les dénominations peuvent différer entre Currents et Messaging Observability.
Paramètres d’envoi
| Suppression | Explication |
|---|---|
| Abandonné en raison de la priorité | L’envoi a été abandonné, car un autre message de priorité plus élevée é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 de l’Optimiseur de contenu désactivée | L’affectation de la variante de l’Optimiseur de contenu 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 dans les cas suivants :
|
| Abandon dû aux 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é. Toutefois, l’utilisateur ne quitte pas le Canvas pour autant. |
| 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 ayant un identifiant correspondant (par exemple 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 soit
|
| Échec de la vérification préalable pour l’étape Message | Avant les validations complètes de distribution d’une étape Message du Canvas, 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. Ce résultat signifie que l’utilisateur ou le message n’a pas satisfait 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é | Avant de créer un message à envoyer à partir de ce déclencheur, 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. Ce résultat signifie que l’utilisateur ou le message n’a pas satisfait 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 liés aux éléments suivants :
|
| Utilisateur non éligible au 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 jeton push éligible, 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 à l’étape | L’utilisateur n’a pas satisfait les validations de distribution définies pour l’étape Message, ou faisait partie d’une liste de suppression. Selon les paramètres de validations de distribution, l’utilisateur a pu quitter le Canvas ou passer à 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 nouvelle entré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 nouvelle entré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 tentatives (cinq par défaut). Ce chiffre correspond au nombre de messages abandonnés après avoir atteint le nombre maximal de tentatives, et non au nombre total de requêtes de contenu connecté ayant échoué. |
| Content Card non valide | La Content Card contenait 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 dans les cas suivants :
|
| 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 avec les bannières, les messages in-app et les e-mails. |
| Erreur de syntaxe Liquid | Le modèle Liquid contenait 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 le partenaire 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é limité pendant plus de 72 heures en raison des limites de débit de la vitesse d’envoi : 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 indiquant un échec (autre que 2xx). Les codes d’erreur courants peuvent être des erreurs client 4XX, des erreurs serveur ou des expirations 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 une vérification de validation groupée et très rapide, exécutée au tout début d’une étape du pipeline (par exemple lors du déclenchement d’un message ou de l’envoi d’une étape Message d’un Canvas). Considérez-la comme une sortie anticipée conçue pour aller le plus vite possible. Plutôt que d’exécuter de nombreuses vérifications distinctes et gourmandes en ressources (comme la validation de chaque détail du profil d’un utilisateur), Braze regroupe plusieurs validations de base en un seul « premier passage ».
Si un utilisateur échoue à cette vérification groupée, il est immédiatement écarté. Cette approche permet à Braze de traiter d’énormes volumes de messages à grande vitesse et peut contribuer à des performances plus rapides et plus stables pour vos Campaigns et Canvas, en réduisant la latence de traitement de chaque message.
Que signifie un échec de type « 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 de type Autre, contactez l’assistance Braze pour obtenir de l’aide.
Pourquoi le total des entrées, suppressions, échecs et envois ne correspond-il pas à la taille d’audience attendue ?
Plusieurs raisons peuvent expliquer cette situation :
- 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 disposaient pas des attributs nécessaires) au moment du lancement de la Campaign ou du Canvas.
- Traitement en cours : Les messages ou les étapes du Canvas sont peut-être encore en cours de traitement. Des utilisateurs peuvent se trouver dans des étapes antérieures du Canvas et ne pas encore avoir atteint d’étape Message.
- Progression sans envoi : Les utilisateurs peuvent générer des événements de progression (par exemple en entrant dans une étape Délai ou une étape de l’arbre décisionnel) sans suppression, échec ni envoi correspondant dans 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 Campaign ou de ce Canvas ne sont peut-être pas encore arrivées dans le tableau de bord.
- Cas particuliers : Il est possible, bien que peu probable, que vous rencontriez un cas particulier qui n’est pas encore pris en compte dans ce tableau de bord. 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 Campaign ou d’un Canvas ?
Cela peut se produire pour les raisons suivantes :
- Messages multicanaux : La Campaign ou l’étape du Canvas a été configurée pour envoyer sur plusieurs canaux (comme le SMS et l’e-mail). Un même utilisateur peut obtenir un résultat « envoyé » pour un canal (comme l’e-mail) et une suppression ou un échec pour 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 Campaign 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 passe par plusieurs étapes au cours de la période sélectionnée.
- Messages de test : Les envois de test (qui sont comptabilisés dans le tableau de bord) peuvent rendre les totaux supérieurs à la taille de l’audience.