Annuler des messages
Vous pouvez utiliser la balise Liquid
abort_message("optional reason for aborting")dans des conditions pour empêcher l’envoi d’un message à un utilisateur. Cet article de référence présente quelques exemples d’utilisation de cette fonctionnalité dans des campagnes marketing.

Si une étape de message est annulée dans un Canvas, l’utilisateur ne quittera pas le Canvas et passera à l’étape suivante.
Envois de test avec abort_message()
abort_message() interrompt l’envoi pour les utilisateurs qui ne remplissent pas votre condition. Le message n’apparaîtra pas sur leur profil et ne sera pas comptabilisé dans les réceptions ni dans la limite de fréquence.
Si les envois de test n’arrivent jamais, prévisualisez en tant qu’utilisateur satisfaisant la condition d’abandon, puis dans Test Send activez Override recipients’ attributes with current preview user’s attributes (ou ajoutez un membre d’un groupe de test de contenu qui remplit les critères).
Abandonner le message si « Number Games Attended » = 0
Par exemple, supposons que vous ne souhaitiez pas envoyer de message aux clients qui n’ont pas assisté à un match :
{% if custom_attribute.${Number_Game_Attended} == 1 %}
Loved the game? Get 10% off your second one with code SAVE10.
{% elsif custom_attribute.${Number_Game Attended} > 1 %}
Love the games? Get 10% off your next one with code SAVE10.
{% else %}
{% abort_message() %}
{% endif %}
Ce message ne sera envoyé qu’aux clients connus pour avoir assisté à un match.
Envoyer des messages uniquement aux clients anglophones
Vous pouvez envoyer des messages uniquement aux clients anglophones en créant une instruction « if » qui correspond lorsque la langue d’un client est l’anglais, et une instruction « else » qui interrompt le message pour toute personne qui ne parle pas anglais ou qui n’a pas de langue définie dans son profil.
{% if ${language} == 'en' %}
Send this message in English!
{% else %}
{% abort_message() %}
{% endif %}
Par défaut, l’envoi interrompu apparaît dans Messaging Observability avec le résultat Liquid abort.
Vous pouvez inclure une chaîne de caractères expliquant la raison entre les parenthèses :
{% abort_message('language was nil') %}
Rechercher les messages d’abandon
Vous pouvez utiliser le générateur de requêtes ou votre propre entrepôt de données, s’il est connecté à Braze, pour rechercher des messages d’abandon spécifiques déclenchés lorsque la logique Liquid provoque l’abandon d’un message.
Quand la logique d’abandon est évaluée
Le moment où la logique d’abandon est évaluée dépend du canal de communication.
Notifications push, e-mail, SMS, webhooks et Content Cards
La logique d’abandon est évaluée au moment de l’envoi, lorsque Braze traite le message pour la distribution.
In-App Messages
La logique d’abandon est évaluée pour les messages in-app modélisés uniquement au moment où le message in-app est déclenché (par exemple, lorsque l’utilisateur effectue l’événement déclencheur ou démarre une session), et non lorsque le message est initialement envoyé à l’appareil. Les messages in-app sont transmis au SDK au démarrage de la session et mis en cache localement ; le Liquid, y compris tout appel à abort_message(), est exécuté lorsque la condition de déclenchement est remplie.
Résolution des problèmes liés aux taux d’abandon élevés
Si une campagne ou une étape de Canvas affiche de nombreux utilisateurs entrés mais peu d’envois, ou si les réceptions semblent plus faibles que prévu, la logique d’abandon en est souvent la cause, en particulier lorsque Liquid nécessite des attributs, des données de catalogue ou des valeurs de liste qui sont absentes au moment de l’évaluation.
Vérifier l’observabilité de la messagerie
- Ouvrez Observabilité de la messagerie.
- Sélectionnez la campagne ou le Canvas, puis sélectionnez Run Dashboard.
- Dans le journal granulaire, filtrez par le résultat Liquid abort.
- Notez si les abandons se concentrent sur un seul canal (comme l’e-mail uniquement) ou sur plusieurs canaux dans le même Canvas.
Vérifier les attributs et le Liquid au moment de l’envoi
Pour les notifications push, les e-mails, les SMS, les webhooks et les Content Cards, la logique d’abandon s’exécute lorsque Braze traite le message pour la réception, et non lorsque l’utilisateur est entré dans un Canvas ou lorsqu’un événement déclencheur s’est produit précédemment.
- Confirmez que les attributs personnalisés, les propriétés d’événement ou les champs de catalogue requis sont définis sur l’utilisateur avant l’exécution de l’étape Message.
- Ajoutez des vérifications explicites de valeur nil ou vide avant d’appeler
abort_message(). Une brancheelsequi abandonne lorsqu’une valeur est manquante interrompt l’envoi pour tout utilisateur ne disposant pas de cette donnée. - Si la personnalisation dépend d’une liste, d’un Segment ou d’une réponse de contenu connecté, confirmez que les données sont disponibles au moment de l’exécution de l’étape Message. Un utilisateur peut entrer dans un Canvas avant que l’appartenance à une liste ou que les données en aval soient prêtes.
Comportement spécifique au Canvas
Si une étape Message est abandonnée dans un Canvas, l’utilisateur ne quitte pas le Canvas. Au lieu de cela, il passe à l’étape suivante. Les abandons n’affectent que le nombre d’envois pour cette étape Message.
Lors du diagnostic des abandons dans un Canvas :
- Comparez les utilisateurs entrés dans l’étape Message aux utilisateurs envoyés pour la même étape.
- Si un seul canal est abandonné, examinez le Liquid spécifique au canal ou le statut d’abonnement pour cette étape.
- Si les abandons augmentent soudainement après une mise à jour de liste ou de catalogue, vérifiez si l’étape Message s’est exécutée avant la fin de la mise à jour.
Valider avec l’aperçu et les envois de test
Prévisualisez en tant qu’utilisateur dans le composeur de message dont le profil correspond à un destinataire concerné. Pour les envois de test, activez Override recipients’ attributes with current preview user’s attributes lorsque votre logique d’abandon dépend des données de profil.
Pour plus d’exemples d’abandon, consultez Requêter les messages d’abandon.
Considérations
La balise de message Liquid abort_message() empêche l’envoi de messages aux utilisateurs, ce qui signifie que le message ne s’affichera pas sur les profils utilisateur et ne sera pas comptabilisé dans les réceptions ni dans la limite de fréquence.