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.
Testversand mit abort_message()
abort_message() stoppt den Versand für Nutzer:innen, die Ihre Bedingung nicht erfüllen. Die Nachricht erscheint nicht in deren Profil und wird weder als Zustellung noch beim Frequency-Capping gezählt.
Wenn Testversände nicht ankommen, zeigen Sie eine Vorschau als Nutzer:in an, die die Abbruchbedingung erfüllt, und 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 Bedingungen erfüllt).
Nachricht abbrechen, wenn „Number Games Attended“ = 0
Angenommen, Sie möchten keine Nachricht an Kund:innen senden, die noch 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 Kund:in Englisch ist, und 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 Begründungsstring in den Klammern angeben:
{% abort_message('language was nil') %}
Abfrage von Abbruchnachrichten
Sie können den Query Builder oder Ihr eigenes Data Warehouse verwenden, sofern es mit Braze verbunden ist, um nach bestimmten Abbruchnachrichten 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 Messages
Die Abbruchlogik wird bei templatebasierten In-App-Nachrichten nur zu dem Zeitpunkt ausgewertet, an dem die In-App-Nachricht ausgelöst wird (z. B. wenn Nutzer:innen das Trigger-Event ausführen oder eine Sitzung starten), und 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 viele eingetretene Nutzer:innen, aber nur wenige Sendungen anzeigt, oder die Zustellungen niedriger als erwartet ausfallen, ist die 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.
- Prüfen Sie, ob sich die 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 für die Zustellung verarbeitet – nicht wenn Nutzer:innen ein Canvas betreten haben oder wenn ein Trigger-Event zuvor ausgelöst wurde.
- Stellen Sie sicher, dass erforderliche angepasste Attribute, Event-Eigenschaften oder Katalogfelder für die Nutzer:innen gesetzt sind, bevor der Nachrichtenschritt ausgeführt wird.
- Fügen Sie explizite nil- oder Leerprü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 Listenzugehörigkeit oder nachgelagerte Daten bereit sind.
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 dieses Nachrichtenschritts aus.
Bei der Diagnose von Canvas-Abbrüchen:
- Vergleichen Sie die eingetretenen Nutzer:innen im Nachrichtenschritt mit den gesendeten Nutzer:innen im selben Schritt.
- 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 sprunghaft ansteigen, prüfen Sie, ob der Nachrichtenschritt ausgeführt wurde, bevor das Update abgeschlossen war.
Mit Vorschau und Testnachrichten validieren
Zeigen Sie im Nachrichten-Editor eine Vorschau als Nutzer:in an, deren Profil dem einer betroffenen Empfängerin bzw. eines betroffenen Empfängers entspricht. Aktivieren Sie bei Testnachrichten die Option 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 Zustellungen noch beim Frequency-Capping berücksichtigt wird.