Nachrichten abbrechen
Optional können Sie den Liquid-Nachrichten-Tag
abort_message("optional reason for aborting")innerhalb von Bedingungen verwenden, um das Senden einer Nachricht an eine:n Nutzer:in zu verhindern. Dieser Referenzartikel listet einige Beispiele auf, wie dieses Feature in Marketing-Kampagnen verwendet werden kann.
Wenn ein Nachrichtenschritt in einem Canvas abgebrochen wird, verlässt die/der Nutzer:in den Canvas nicht und wird zum nächsten Schritt weitergeleitet.
Testsendungen mit abort_message()
abort_message() stoppt die Sendung für Nutzer:innen, die Ihre Bedingung nicht erfüllen. Die Nachricht erscheint nicht in deren Profil und wird weder bei Zustellungen noch beim Frequency-Capping gezählt.
Wenn Testsendungen nie ankommen, zeigen Sie eine Vorschau als eine:n Nutzer:in an, der/die die Abbruchbedingung erfüllt. Aktivieren Sie dann unter Test Send die Option Override recipients’ attributes with current preview user’s attributes (oder fügen Sie ein Mitglied einer Content-Testgruppe hinzu, das die Bedingung erfüllt).
Nachricht abbrechen, wenn „Number Games Attended“ = 0
Angenommen, Sie möchten keine Nachricht an Kund:innen senden, die kein Spiel besucht haben:
{% 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 %}
Diese Nachricht wird nur an Kund:innen gesendet, die bekanntermaßen ein Spiel besucht haben.
Nachrichten nur an englischsprachige Kund:innen senden
Sie können Nachrichten nur an englischsprachige Kund:innen senden, indem Sie eine „if“-Anweisung erstellen, die zutrifft, wenn die Sprache einer Kundin oder eines Kunden Englisch ist, sowie eine „else“-Anweisung, die die Nachricht für alle abbricht, die kein Englisch sprechen oder keine Sprache in ihrem Profil hinterlegt haben.
{% if ${language} == 'en' %}
Send this message in English!
{% else %}
{% abort_message() %}
{% endif %}
Standardmäßig wird der abgebrochene Versand in Messaging Observability mit dem Ergebnis Liquid abort angezeigt.
Sie können einen Grund als String innerhalb der Klammern angeben:
{% abort_message('language was nil') %}
Abbruch-Nachrichten abfragen
Sie können den Query Builder oder Ihr eigenes Data Warehouse verwenden, sofern es mit Braze verbunden ist, um nach bestimmten Abbruch-Nachrichten zu suchen, die ausgelöst werden, wenn Liquid-Logik den Abbruch einer Nachricht verursacht.
Wann die Abbruchlogik ausgewertet wird
Der Zeitpunkt der Auswertung der Abbruchlogik hängt vom Nachrichtenkanal ab.
Push, E-Mail, SMS, Webhooks und Content Cards
Die Abbruchlogik wird zum Sendezeitpunkt ausgewertet, wenn Braze die Nachricht für die Zustellung verarbeitet.
In-App-Nachrichten
Die Abbruchlogik wird für vorlagenbasierte In-App-Nachrichten nur zu dem Zeitpunkt ausgewertet, an dem die In-App-Nachricht ausgelöst wird (zum Beispiel wenn Nutzer:innen das Trigger-Event ausführen oder eine Sitzung starten), nicht wenn die Nachricht ursprünglich an das Gerät gesendet wird. In-App-Nachrichten werden beim Sitzungsstart an das SDK übermittelt und lokal zwischengespeichert; das Liquid – einschließlich aller abort_message()-Aufrufe – wird ausgeführt, wenn die Trigger-Bedingung erfüllt ist.
Fehlerbehebung bei hohen Abbruchraten
Wenn eine Campaign oder ein Canvas-Schritt zeigt, dass viele Nutzer:innen eingetreten sind, aber nur wenige Nachrichten gesendet wurden, oder die Zustellungen niedriger als erwartet ausfallen, ist Abbruchlogik eine häufige Ursache – insbesondere wenn Liquid Attribute, Katalogdaten oder Listenwerte erfordert, die zum Zeitpunkt der Auswertung fehlen.
Messaging Observability prüfen
- Öffnen Sie Messaging Observability.
- Wählen Sie die Campaign oder das Canvas aus und klicken Sie dann auf Run Dashboard.
- Filtern Sie im detaillierten Protokoll nach dem Ergebnis Liquid abort.
- Beachten Sie, ob sich Abbrüche auf einen Kanal konzentrieren (z. B. nur E-Mail) oder kanalübergreifend im selben Canvas auftreten.
Attribute und Liquid zum Sendezeitpunkt überprüfen
Für Push, E-Mail, SMS, Webhooks und Content Cards wird die Abbruchlogik ausgeführt, wenn Braze die Nachricht zur Zustellung verarbeitet – nicht wenn Nutzer:innen ein Canvas betreten oder wenn ein Trigger-Event zuvor ausgelöst wurde.
- Bestätigen Sie, dass erforderliche angepasste Attribute, Event-Eigenschaften oder Katalog-Felder beim jeweiligen Nutzerprofil gesetzt sind, bevor der Nachrichtenschritt ausgeführt wird.
- Fügen Sie explizite nil- oder Leer-Prüfungen hinzu, bevor Sie
abort_message()aufrufen. Einelse-Branch, der bei fehlendem Wert abbricht, stoppt den Versand für alle Nutzer:innen ohne diese Daten. - Wenn die Personalisierung von einer Liste, einem Segment oder einer Connected-Content-Antwort abhängt, stellen Sie sicher, dass die Daten verfügbar sind, wenn der Nachrichtenschritt ausgeführt wird. Nutzer:innen können ein Canvas betreten, bevor die Listenmitgliedschaft oder nachgelagerte Daten bereitstehen.
Canvas-spezifisches Verhalten
Wenn ein Nachrichtenschritt in einem Canvas abgebrochen wird, verlassen die Nutzer:innen das Canvas nicht. Stattdessen fahren sie mit dem nächsten Schritt fort. Abbrüche wirken sich nur auf die Sendeanzahl für diesen Nachrichtenschritt aus.
In einem Kontextschritt betrifft abort_message nur die Variable, die es aufruft: Diese Variable wird nicht gesetzt, die anderen Variablen im Schritt werden weiterhin gesetzt, und die Nutzer:innen gehen zum nächsten Schritt über. Abbrüche im Kontextschritt werden nicht im Message Activity Log aufgezeichnet. Weitere Informationen finden Sie unter Kontext.
Bei der Diagnose von Canvas-Abbrüchen:
- Vergleichen Sie die eingetretenen Nutzer:innen im Nachrichtenschritt mit den gesendeten Nutzer:innen desselben Schritts.
- Wenn nur ein Kanal abbricht, überprüfen Sie das kanalspezifische Liquid oder den Abo-Status für diesen Schritt.
- Wenn Abbrüche nach einem Listen- oder Katalog-Update ansteigen, prüfen Sie, ob der Nachrichtenschritt ausgeführt wurde, bevor das Update abgeschlossen war.
Mit Vorschau und Testsendungen validieren
Zeigen Sie im Nachrichten-Editor eine Vorschau als Nutzer:in an, deren Profil einem betroffenen Empfänger bzw. einer betroffenen Empfängerin entspricht. Aktivieren Sie bei Testsendungen Override recipients’ attributes with current preview user’s attributes, wenn Ihre Abbruchlogik von Profildaten abhängt.
Weitere Beispiele für Abbrüche finden Sie unter Abbruchnachrichten abfragen.
Überlegungen
Das Liquid-Nachrichten-Tag abort_message() verhindert, dass Nachrichten an Nutzer:innen gesendet werden. Das bedeutet, dass die Nachricht nicht in Nutzerprofilen angezeigt wird und weder bei der Zustellung noch beim Frequency-Capping berücksichtigt wird.