Observabilité de la messagerie
L’observabilité de la messagerie trace les événements à travers votre Canvas ou Campaign afin que vous puissiez auditer et résoudre les problèmes de messagerie. Utilisez-la pour repérer les tendances, voir comment les utilisateurs progressent dans un Canvas et diagnostiquer pourquoi les messages n’ont peut-être pas été envoyés comme prévu.
Pour accéder à l’observabilité de la messagerie, vous devez disposer de la permission utilisateur « View Dashboard Reports » pour votre espace de travail.
Concepts clés
Envoyé et distribué
Ce tableau de bord rend compte de la manière dont Braze a traité un message en interne, et non du statut final de distribution du message.
Un message marqué comme « envoyé » dans ce tableau de bord signifie que Braze l’a traité et expédié avec succès. Pour la plupart des canaux, cela signifie que Braze a transmis le message au partenaire d’envoi tiers concerné. Toutefois, cela ne garantit pas la distribution finale sur l’appareil de l’utilisateur.
Lorsque Braze « envoie » un message, la distribution finale peut dépendre de services externes. Voici des exemples pour chaque canal.
| Canal | Exemple de distribution finale |
|---|---|
| Content Cards | La carte a été envoyée et est éligible à l’affichage. |
| 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 est invalide ou si la boîte de réception est pleine. | |
| In-App Messages | Le message a été vu par l’utilisateur et une impression a été enregistrée. |
| LINE | Le message a été transmis avec succès à 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 auprès de l’opérateur mobile. |
| Webhooks | La requête webhook a été effectuée avec succès, renvoyant une réponse 2xx. |
| Le message a été transmis avec succès à un partenaire d’envoi. |
Événements de progression dans un Canvas
Pour les Canvas, la fonctionnalité Messaging Observability affiche également les événements de progression : des enregistrements indiquant comment les utilisateurs avancent dans le parcours, comme l’entrée dans le Canvas, l’entrée dans une étape ou la sortie du Canvas. Les événements de progression sont distincts des résultats d’envoi des messages. Ils vous permettent de voir où se trouvent les utilisateurs dans le Canvas.
Fraîcheur des données
La fréquence de mise à jour des données dans ce tableau de bord peut varier en fonction de la charge du système. Bien que la fréquence de mise à jour ne soit pas garantie, elle est généralement inférieure à une heure dans la plupart des cas.
Configurer le tableau de bord
Ouvrez Messaging Observability depuis l’un de ces emplacements :
- Accédez à Analytics > Dashboard Builder, puis sélectionnez Messaging Observability dans la liste des tableaux de bord créés par Braze.
- Sur une page d’analyse Canvas ou Campaign, sélectionnez Messaging Observability. Le tableau de bord s’ouvre avec ce Canvas ou cette Campaign présélectionné(e) lorsque disponible.
Pour exécuter le tableau de bord et afficher vos données :
- Sélectionnez une date ou une plage de dates couvrant jusqu’aux sept derniers jours.
- Sélectionnez Campaigns ou Canvas comme source pour vos rapports de 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 Run dashboard pour charger les données correspondant aux filtres sélectionnés.
Après avoir modifié un filtre, sélectionnez à nouveau Run dashboard pour actualiser les tuiles de résumé, le graphique et le journal des événements. En attendant, le tableau de bord peut afficher un avertissement « Outdated results ».
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.
Tuiles récapitulatives
En haut de la page, les tuiles récapitulatives pour la période sélectionnée affichent :
- Entrées : Toutes les entrées éligibles de Canvas ou de Campaign évaluées dans la plage de temps sélectionnée. Ces nombres peuvent légèrement différer de la vue analytique, car Messaging Observability utilise des données de résolution de problèmes provenant de sources différentes.
- Suppressions : Messages que Braze n’a intentionnellement pas envoyés après l’entrée, par exemple en raison de l’éligibilité, de la limite de fréquence ou des heures calmes. Pour plus de détails, consultez Suppressions.
- Échecs : Messages ayant échoué de manière inattendue, par exemple à cause d’erreurs Liquid, webhook ou de notification push. Pour plus de détails, consultez Échecs.
- Envoyés : Messages ayant quitté avec succès le traitement de Braze. Cela ne garantit pas la livraison au destinataire. La livraison dépend du canal, de l’opérateur et de l’appareil. Pour plus de détails, consultez Envoyés et livrés.
Événements au fil du temps
Ce graphique de série temporelle affiche une répartition horaire des événements pour les filtres sélectionnés. Utilisez les vues du graphique pour comparer les totaux d’ensemble ou pour détailler les suppressions et les échecs par résultat. Les libellés de résultat dans ce graphique sont des libellés normalisés du tableau de bord, et non des valeurs brutes du payload d’événement.
Journal des événements
Le Journal des événements liste les événements individuels enregistrés par Braze pour chaque utilisateur selon les filtres et la plage de temps sélectionnés, principalement les suppressions, les progressions et les échecs. Utilisez-le pour examiner des enregistrements spécifiques, 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 depuis le filtre Events (par exemple, Suppressions > Frequency capped, ou Progressions > Entered step).
- Saisissez un ID utilisateur dans le champ de recherche pour afficher les lignes correspondant à cet utilisateur.
Lorsque vous appliquez les deux filtres, le tableau renvoie les lignes correspondant à la fois aux événements sélectionnés et à l’ID utilisateur saisi.
Sélectionnez View sur une ligne pour ouvrir un panneau latéral avec plus de contexte sur cet événement. Depuis le panneau, vous pouvez également sélectionner Ask Operator pour obtenir des conseils de remédiation.
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 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 comment les utilisateurs avancent dans un Canvas. Ils sont propres à Canvas uniquement. L’entrée dans une Campaign apparaît sous Entrées comme Entered campaign.
Les libellés des événements de progression dans Messaging Observability sont des libellés lisibles du tableau de bord. Les comptages ou la dénomination peuvent différer d’autres surfaces analytiques de Braze, car ces jeux de données ont des représentations et des flux de traitement différents.
| Événement de progression | Explication |
|---|---|
| Entered 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é. |
| Entered Action Path step | L’utilisateur est entré dans une étape de parcours d’action et a emprunté un parcours après une action (ou le parcours par défaut). |
| Entered Agent step | L’utilisateur est entré dans une étape Agent où le contexte a été évalué. |
| Entered Audience Path step | L’utilisateur est entré dans une étape de parcours d’audience et a emprunté un parcours d’audience (ou le parcours par défaut). |
| Entered Audience Sync step | L’utilisateur est entré dans une étape Audience Sync et la synchronisation d’audience a commencé. |
| Entered Content Optimizer step | L’utilisateur est entré dans une étape Content Optimizer et une variante a été sélectionnée. |
| Entered Context step | L’utilisateur est entré dans une étape de contexte où les variables de contexte ont été définies ou évaluées. |
| Entered Decision Split step | L’utilisateur est entré dans une étape d’arbre décisionnel et a emprunté une branche. |
| Entered Delay step | L’utilisateur est entré dans une étape de délai et est en attente, avance immédiatement (par exemple, un délai nul) ou progresse autrement dans cette étape. |
| Entered Experiment Path step | L’utilisateur est entré dans une étape de chemin d’expérience et a été assigné à une variante d’expérience. |
| Entered Feature Flag step | L’utilisateur est entré dans une étape Feature Flag et les feature flags sont en cours d’évaluation. |
| Entered Message step | L’utilisateur est entré dans une étape de message. Les suppressions, échecs ou envois ultérieurs pour cette étape apparaissent comme des événements distincts. |
| Entered Send to Destination step | L’utilisateur est entré dans une étape d’envoi vers une destination. Braze vérifie s’il est éligible pour entrer dans le Canvas de destination. |
| Entered User Update step | L’utilisateur est entré dans une étape de mise à jour utilisateur. Les attributs utilisateur sont en cours de mise à jour, ou l’utilisateur est temporairement retardé par la limitation de débit de User Update. |
| Sent to destination | L’utilisateur a été envoyé vers le Canvas de destination et est passé à l’étape suivante dans le Canvas actuel. |
| Not sent to destination | L’utilisateur n’est pas entré dans le Canvas de destination (par exemple, en raison d’une incompatibilité d’audience) et est passé à l’étape suivante dans le Canvas actuel. |
| Destination not found | Le Canvas de destination n’a pas été trouvé. L’utilisateur est passé à l’étape suivante dans le Canvas actuel. |
| Exited Canvas | L’utilisateur a quitté le Canvas. Cela se produit lorsque :
|
Suppressions
Les suppressions sont des non-envois intentionnels après l’entrée, déclenchés par des paramètres, l’éligibilité ou les contrôles de distribution.
Les libellés de suppression et d’échec dans Messaging Observability sont des libellés lisibles du tableau de bord. Dans les événements d’engagement liés aux messages de Currents, les informations d’interruption sont représentées par des champs tels que abort_type et abort_log. Étant donné que ces jeux de données ont des représentations et des flux de traitement différents, les comptages ou la dénomination peuvent différer entre Currents et Messaging Observability.
Paramètres d’envoi
| Suppression | Explication |
|---|---|
| Aborted due to priority | L’envoi a été interrompu car un autre message de priorité supérieure pour cet utilisateur était déjà en attente, ou ce message a été dépriorisé. |
| Banner expired | Le banner a expiré avant de pouvoir être distribué. |
| Content Card expired | La Content Card a expiré avant que l’utilisateur ne la voie. |
| Content Optimizer variant deactivated | L’assignation de variante Content Optimizer a été désactivée avant l’envoi. |
| Frequency capped | L’utilisateur a déjà reçu le nombre maximum de messages autorisés selon les règles de limite de fréquence de votre espace de travail, l’envoi a donc été annulé. |
| Inactive campaign | La Campaign a été arrêtée alors que le message était en cours de traitement, il a donc été interrompu. |
| Inactive Canvas | Le Canvas a été arrêté avant que l’utilisateur n’entre dans le parcours. |
| Inactive Canvas step | Cela peut se produire dans le Canvas si :
|
| Quiet Hours abort | Les heures calmes étaient activées pour la Campaign ou l’étape du Canvas avec l’option de repli définie sur Abort message. L’utilisateur a déclenché la Campaign ou est entré dans l’étape de message du Canvas pendant les heures calmes, le message a donc été interrompu. Cependant, cela ne fait pas sortir l’utilisateur du Canvas. |
| Volume limited | La Campaign ou le Canvas a atteint la limite de volume définie, l’envoi a donc été annulé. |
Éligibilité de l’utilisateur
| Suppression | Explication |
|---|---|
| Duplicate user identifier | Plusieurs utilisateurs avec un identifiant correspondant (tel qu’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é interrompu. |
| Exception or exit event | L’utilisateur était précédemment éligible pour recevoir le message, mais soit
|
| User failed pre-check for Message step | Braze effectue un premier ensemble de vérifications de base concernant l’éligibilité de l’audience, la rééligibilité et l’éligibilité du canal avant les validations complètes de distribution pour une étape de message Canvas. Ce résultat signifie que l’utilisateur ou le message a échoué à l’une de ces vérifications, le message a donc été interrompu pour cette étape. |
| User failed pre-check for triggered message | Braze effectue un premier ensemble de vérifications de base concernant l’éligibilité de l’audience, la rééligibilité et l’éligibilité du canal avant de créer un message à envoyer depuis 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é interrompu. |
| User no longer eligible | 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 fasse entrer l’utilisateur dans le Canvas. Le délai entre le moment où l’utilisateur a initialement rempli les critères d’audience et le moment où il en est sorti peut être dû à des retards liés à :
|
| User not eligible for channel | 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 invalides, l’absence de jetons push éligibles, des restrictions d’é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. |
| User not eligible for step | L’utilisateur n’a pas rempli les validations de distribution définies pour l’étape de message ou faisait partie d’une liste de suppression. Selon les paramètres des Validations de distribution, l’utilisateur peut avoir quitté le Canvas ou être passé à l’étape suivante. |
| User not re-eligible | 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 réentrée. Cela peut se produire si l’utilisateur a déjà reçu la Campaign ou est entré dans le Canvas trop récemment, si un autre envoi pour la même Campaign est déjà en cours pour cet utilisateur, ou si la rééligibilité ou la réentrée est désactivée. |
Échecs
Les échecs sont des erreurs inattendues survenant lors du traitement ou des tentatives de distribution.
| Échec | Explication |
|---|---|
| Connected Content failed | Braze a tenté d’envoyer le message, mais le contenu connecté a échoué après le nombre maximum de tentatives (cinq par défaut). Ce comptage représente le nombre de messages interrompus après avoir atteint le nombre maximum de tentatives, et non le nombre total de requêtes de contenu connecté ayant échoué. |
| Content Card invalid | La Content Card contenait des erreurs et n’a pas été envoyée à l’utilisateur. Voici quelques raisons courantes :
|
| Delay step failure | L’étape de délai a échoué, provoquant la sortie de l’utilisateur du Canvas. Cet échec peut survenir lorsque :
|
| Liquid abort | L’étiquette Liquid abort_message a été appelée, l’envoi a donc été annulé. |
| Liquid rendering timeout | Le rendu du modèle Liquid a pris trop de temps. Cela survient le plus souvent pour les banners, les messages in-app et les e-mails. |
| Liquid syntax error | Le modèle Liquid contenait une erreur d’analyse, le message a donc été annulé. |
| Media URL failure | Braze n’a pas pu traiter l’URL média dans le message. Cela peut se produire lorsque l’URL est bloquée, invalide, expire, retourne un statut HTTP invalide ou échoue à la validation SSL. |
| Partner delivery error | Braze a tenté d’envoyer ce message à votre partenaire de distribution pendant 24 heures, mais le partenaire a retourné des erreurs temporaires pendant toute la fenêtre. |
| Product recommendation invalid | La recommandation produit ou la sélection du 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 supprimé tous les éléments du catalogue. |
| Push credentials invalid | Les identifiants push pour cette application sont manquants ou invalides, l’envoi a donc été annulé. Mettez à jour vos identifiants dans App Settings. |
| Rate limited over 72 hours | Le message a été limité en débit pendant plus de 72 heures en raison des limites de débit de vitesse de distribution, l’envoi a donc été interrompu. |
| Subscription group failure | 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 des numéros d’envoi manquants pour SMS ou WhatsApp, ou un MMS non pris en charge sur le service de messagerie configuré. |
| User profile not found | L’utilisateur n’a jamais existé ou n’existe plus dans Braze. Voici quelques cas courants :
|
| Webhook failed | Le webhook a reçu un code de réponse non réussi (non-2xx). Les codes d’erreur courants peuvent être des erreurs client 4XX, des erreurs serveur ou des délais d’expiration 5XX, ou 598 Host Unhealthy ou des requêtes brièvement interrompues. |
| Other | Échecs qui ne correspondent à aucune des autres catégories de ce tableau. Si vous constatez une proportion importante d’échecs de type Other, contactez le support Braze pour obtenir de l’aide. |
Questions fréquentes
Que signifie un échec de « pré-vérification » ?
Une « pré-vérification » désigne un contrôle de validation groupé à haute vitesse qui s’exécute 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 de message Canvas). Considérez-la comme une sortie anticipée conçue pour une vitesse maximale. Au lieu 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 une seule « première passe ».
Si un utilisateur échoue à cette vérification groupée unique, il est immédiatement exclu. Cette approche groupée permet à Braze de traiter des volumes massifs 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 « Autre » ?
Il s’agit d’échecs qui n’entrent dans aucune des catégories existantes du tableau de bord. Si vous constatez encore une proportion importante d’échecs « Autre », contactez le support Braze pour obtenir une assistance supplémentaire.
Pourquoi les Entrées, les Suppressions, les Échecs et les Envoyés ne correspondent-ils pas à la taille d’audience attendue ?
Cela peut se produire pour plusieurs raisons :
- Critères d’audience : Moins d’utilisateurs que prévu ont pu satisfaire les critères d’audience (par exemple, ils n’étaient pas dans le Segment ou ne possédaient pas les attributs nécessaires) au moment du lancement de la Campaign ou du Canvas.
- Traitement en cours : Des messages ou des étapes Canvas peuvent encore être en cours de traitement. Des utilisateurs peuvent encore se trouver dans des étapes antérieures du Canvas et ne pas avoir atteint les étapes de message.
- Progression sans envoi : Les utilisateurs peuvent générer des événements de progression (comme l’entrée dans une étape de délai ou d’arbre décisionnel) sans qu’il y ait de suppression, d’échec ou d’envoi correspondant dans la même fenêtre.
- Fraîcheur des données : Les données du tableau de bord sont mises à jour environ toutes les 15 minutes, mais cela n’est pas garanti. Les données les plus récentes pour cette Campaign ou ce Canvas peuvent ne pas encore être disponibles dans le tableau de bord.
- Cas limites : Il existe une faible probabilité que vous rencontriez un cas limite qui n’est pas pris en compte dans ce tableau de bord à l’heure actuelle. Si vous pensez que c’est le cas, contactez le support Braze.
Pourquoi les totaux des tuiles ou du journal d’événements peuvent-ils être supérieurs à l’audience d’une Campaign ou d’un Canvas ?
Cela peut se produire pour les raisons suivantes :
- Messages multicanaux : La Campaign ou l’étape Canvas était configurée pour envoyer sur plusieurs canaux (par exemple, SMS et e-mail). Un même utilisateur peut recevoir 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é plus d’une fois dans les tuiles et le journal d’événements.
- Par exemple, vous envoyez une Campaign de notification push à 100 utilisateurs, 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 également une suppression pour la notification push Android (« Utilisateur non éligible pour le canal »).
- Étapes de message multiples (Canvas uniquement) : Votre Canvas peut comporter plusieurs étapes de message dans un parcours donné. Ce tableau de bord agrège tous les événements, donc un même utilisateur peut être comptabilisé plusieurs fois s’il passe par plusieurs étapes dans la période sélectionnée.
- Messages de test : L’envoi de test (qui est comptabilisé dans le tableau de bord) peut rendre les totaux supérieurs à la taille de l’audience.