Passer au contenu

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.
E-mail 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.
WhatsApp 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 :

  1. Sélectionnez une date ou une plage de dates couvrant au maximum les sept derniers jours.
  2. Sélectionnez Campaigns ou Canvas comme source des rapports de votre tableau de bord.
  3. Sélectionnez une Campaign ou un Canvas.
  4. (Facultatif, Canvas uniquement) Sélectionnez une ou plusieurs étapes du Canvas pour limiter les résultats à ces étapes.
  5. Sélectionnez Exécuter le tableau de bord pour charger les données correspondant aux filtres choisis.

Le tableau de bord Messaging Observability avec ses vignettes récapitulatives. Le graphique des événements au fil du temps affiche les entrées, les suppressions, les échecs et les envois, et un avertissement « Résultats obsolètes » indique que les filtres ont changé depuis la dernière exécution.

Interpréter les données

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.

Le journal des événements avec le filtre Événements défini sur « Tous les événements ». Les lignes comprennent Échec de l’étape Délai, Utilisateur non éligible, Sortie du Canvas, Envoyé vers la destination et Abandon Liquid.

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.

É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.

É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 :
  • Il remplit les critères de sortie du Canvas.
  • Le Canvas ou l’étape est arrêté, ou l’étape est supprimée.
  • Il n’est pas éligible pour continuer, ou son parcours dans le Canvas est manquant.
  • Une étape Délai ne peut pas se poursuivre, car un délai personnalisé ne peut pas être calculé ou l’heure du délai est déjà passée.
  • Une étape Parcours d’action comporte une fenêtre d’évaluation qui ne peut pas être calculée, ou reçoit une action en double.
  • Une étape Chemins d’expérience ne peut pas se poursuivre, par exemple lorsqu’une répartition ne peut pas être appliquée, qu’un groupe d’exclusion ne peut pas être envoyé ou qu’un groupe de contrôle n’a pas d’étape suivante.
  • Une étape épuise ses nouvelles tentatives.

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.

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 :
  • L’étape du Canvas a été supprimée
  • Le Canvas a été arrêté, ce qui rend toutes les étapes inactives
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 à :
  • Timing intelligent
  • Heures calmes
  • Heure locale
  • Limites de débit de la vitesse de distribution (non applicable à l’entrée dans un Canvas)
  • Retards dans la chaîne d’envoi des messages
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 :
  • Taille maximale dépassée (2 Ko)
  • Date d’expiration non valide
  • Le message contient des caractères non valides
É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 :
  • La variable fournie à l’étape de délai personnalisé était vide ou d’un type non valide
  • Le délai dépasse la durée maximale autorisée dans le Canvas
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 :
  • L’utilisateur a été ciblé via l’envoi de messages par API, mais n’a jamais existé dans Braze.
  • L’utilisateur a été supprimé avant l’envoi du message ou l’exécution de l’étape du Canvas.
  • L’utilisateur a été fusionné avec un autre profil avant l’envoi du message.
É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.
New Stuff!