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.

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 qui satisfait la condition d’annulation, puis dans Envoi de test, activez Remplacer les attributs des destinataires par ceux de l’utilisateur prévisualisé (ou ajoutez un membre d’un groupe de test de contenu qui remplit les conditions).

Annuler le message si « Number Games Attended » = 0

Par exemple, imaginons que vous ne souhaitiez pas envoyer de message aux clients qui n’ont assisté à aucun match :

1
2
3
4
5
6
7
{% 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 dont on sait qu’ils ont assisté à un match.

Envoyer un message uniquement aux clients anglophones

Vous pouvez envoyer un message uniquement aux clients anglophones en créant une instruction « if » qui correspond lorsque la langue du client est l’anglais, et une instruction « else » qui annule le message pour toute personne qui ne parle pas anglais ou dont le profil ne comporte pas de langue.

1
2
3
4
5
6
{% if ${language} == 'en' %}
Send this message in English!
{% else %}
{% abort_message() %}
{% endif %}

Par défaut, Braze enregistre un message d’erreur générique dans votre Journal d’activité des messages :

1
{% abort_message %} called

Vous pouvez également faire en sorte que le message d’annulation enregistre un contenu spécifique dans votre Journal d’activité des messages en incluant une chaîne de caractères entre les parenthèses :

1
{% abort_message('language was nil') %}

Rechercher des messages d’annulation

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’annulation spécifiques déclenchés lorsque la logique Liquid provoque l’annulation d’un message.

Moment d’évaluation de la logique d’annulation

Le moment où la logique d’annulation est évaluée dépend du canal de message.

Push, e-mail, SMS, webhooks et cartes de contenu

La logique d’annulation est évaluée au moment de l’envoi, lorsque Braze traite le message pour la distribution.

Messages in-app

La logique d’annulation est évaluée 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 les appels abort_message() — est exécuté lorsque la condition de déclenchement est remplie.

Remarques

La balise 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.