So fügst du mithilfe des Logik-Builders bedingte Logik zu E-Mail-Vorlagen hinzu

Übersicht

Erfahre, wie du den Logik-Builder verwendest, um dynamische bedingte Logik – wie If/Else-Anweisungen und For-Schleifen – direkt zu Textblöcken in deinen E-Mail-Vorlagen hinzuzufügen. So kannst du verschiedenen Empfänger*innen personalisierte Inhalte basierend auf ihrem Profil oder benutzerdefinierten Eigenschaften anzeigen, ohne Code zu schreiben.

Bevor du anfängst

Der Logik-Builder ist verfügbar in:

• E-Mail-Editor mit Drag-and-drop – Textblöcke, Tabellenblöcke und Split-Blöcke
• Nur-Text-E-Mail-Editor – über ein modales Fenster statt über ein Seitenfenster

Um eine benutzerdefinierte Eigenschaft aus dem Dropdown-Menü auszuwählen, füge sie zuerst mindestens 1 Profil in deinem Konto hinzu. Profile und benutzerdefinierte Eigenschaften können über Anmeldeformularen, CSV-Uploads, E-Commerce-Integrationen und andere Tools für Listenwachstum hinzugefügt werden.

Hinweis: Die Eigenschaften-Dropdownliste enthält Profil- und benutzerdefinierte Eigenschaften, führt aber keine Ereignisdaten auf. Um eine Bedingung mithilfe von Ereignisdaten zu erstellen, kannst du In Code umwandeln verwenden und Django-Tags direkt schreiben. For-Schleifen können eine Ereignisliste direkt in Variable zum Durchlaufen verwenden. Verwende einen Flow, der durch das Ereignis ausgelöst wird, auf dessen Daten du verweisen möchtest.

Füge eine If/else-Anweisung hinzu

Verwende eine if/else-Anweisung, um Empfänger*innen basierend auf einem Profil oder einer benutzerdefinierten Eigenschaft unterschiedliche Inhalte anzuzeigen. Zum Beispiel könntest du einen VIP-Rabattblock nur Kund*innen mit mehr als 500 Treuepunkten anzeigen und allen anderen einen Anreiz zur Registrierung.

Im Drag-and-Drop-Editor

1. Doppelklicke in einen Textblock, Tabellenblock oder Split-Block, um in den Bearbeitungsmodus zu wechseln.
2. Klicke in der Symbolleiste für die Textformatierung auf die Schaltfläche Einfügen.
3. Wähle im Drop-down-Menü die Option If/else condition.
   • Auf der linken Seite wird ein Seitenbereich geöffnet, und das Canvas verschiebt sich nach rechts.
4. Konfiguriere deine if -Anweisung:
   • Verwende das erste Drop-down-Menü, um ein Profil oder eine benutzerdefinierte Eigenschaft auszuwählen, die ausgewertet werden soll.
   • Verwende das zweite Dropdown-Menü, um einen Operator auszuwählen (z. B. entspricht, größer als, ist festgelegt).
   • Gib je nach ausgewähltem Operator einen Wert ein oder wähle einen Wert aus, mit dem verglichen werden soll.
5. Optional kannst du auf Bedingung hinzufügen klicken, um zusätzliche Kriterien zur if-Anweisung hinzuzufügen.
   • Verwende AND oder OR, um Bedingungen zu verknüpfen. AND ist standardmäßig ausgewählt. Bedingungen, die mit AND verknüpft sind, müssen alle übereinstimmen; Bedingungen, die mit OR verknüpft sind, bieten Alternativen.
   • Klicke in einer Bedingung auf die Schaltfläche Bedingung kopieren, um sie als neue UND-Bedingung zu duplizieren.
6. Um einen else if -Zweig hinzuzufügen, klicke auf Sonst-wenn hinzufügen und konfiguriere die Bedingungen auf die gleiche Weise. Empfänger*innen sehen den Inhalt für den ersten Zweig, auf den sie passen. Ein else if-Zweig gilt nur, wenn die if-Anweisung und alle vorherigen else if-Zweige nicht zutreffen.
7. Das Fallback-Kontrollkästchen ist standardmäßig ausgewählt: Andere Inhalte für alle Profile einfügen, die keine Bedingungen erfüllen. Lass es ausgewählt, um Empfänger*innen Inhalte anzuzeigen, auf die keine Bedingungen zutreffen, oder deaktiviere es, um den Else-Zweig zu entfernen.
8. Bearbeite die Inhalte im Canvas für jede Bedingung. Jede Bedingung wird während der Konfiguration als blaues Feld angezeigt.
9. Wenn du fertig bist, klicke auf Speichern oder auf den Zurück-Pfeil, um das Panel zu schließen und deine Logik zu speichern.

Tipp: Um die ausgewählte Logik zu entfernen, klicke im Seitenbereich auf Logik entfernen. Der Inhalt bleibt in der E-Mail, also sieh ihn dir nach dem Entfernen der Bedingungen noch einmal an.

Hinweis: Klicke auf Bedingung löschen, um eine Bedingung zu entfernen. Wenn du die letzte Bedingung in der ursprünglichen if-Anweisung löschst, werden ihre Werte gelöscht, aber die Anweisung bleibt bestehen. Wenn du die letzte Bedingung in einem else-if-Zweig löschst, wird dieser Zweig entfernt. Um den else-Zweig zu entfernen, deaktiviere das Kontrollkästchen „Fallback-Content“.

Im Nur-Text-Editor

Wähle im Nur-Text-Editor in der Textbearbeitungs-Symbolleiste Einfügen > Wenn-/Sonst-Bedingung aus. Konfiguriere die Bedingungen im Dialog mithilfe der obigen Optionen und klicke dann auf Speichern. Bearbeite den Inhalt für jeden Zweig in der E-Mail, nachdem sich das Dialogfeld geschlossen hat.

Füge eine For-Schleife hinzu

Verwende eine for-Schleife, um eine Liste von Elementen zu durchlaufen und für jedes Element wiederholte Inhalte anzuzeigen. Beispielsweise könntest du eine Schleife durch die zuletzt angesehenen Produkte einer Kund*in ausführen, um jedes einzelne in der E-Mail anzuzeigen.

Im Drag-and-Drop-Editor

1. Doppelklicke in einen Textblock, Tabellenblock oder Split-Block.
2. Klicke in der Symbolleiste auf die Schaltfläche Einfügen.
3. Wähle For loop aus dem Drop-down-Menü aus.
   • Ein Seitenbereich wird links geöffnet.
4. Gib im Feld Variable zum Durchlaufen die Liste ein, die du durchlaufen möchtest (z. B. event.items, wenn das die Listenvariable im Auslöseereignis deines Flows ist). Verwende den exakten Variablennamen aus deinen Daten.
5. Gib im Feld Item alias einen Namen ein, um jedes einzelne Element innerhalb der Schleife zu referenzieren (z. B. item).
6. Bearbeite den Inhalt im Canvas, um festzulegen, was für jedes Element angezeigt wird. Verwende den Elementalias in Personalisierungs-Tags: für einen Alias von item verwende {{ item }} für einen einfachen Listenwert oder ein Feld wie {{ item.name }}, wenn jedes Element eine name-Eigenschaft hat.
7. Klicke auf Speichern oder den Zurückpfeil, um das Panel zu schließen und deine Logik zu speichern.

Tipp: Um die Schleife zu entfernen, klicke im Seitenbereich auf Logik entfernen. Der Inhalt bleibt bestehen, entferne oder ersetze also alle Tags, die vom Elementalias abhängen.

Einen konfigurierbaren Tag hinzufügen

Verwende einen konfigurierbaren Tag, um Django-Tags einzufügen, die nicht durch die if/else- oder For-loop-Builder abgedeckt sind – z. B. with-Anweisungen oder Katalog-Tags.

1. Doppelklicke in einen Textblock, Tabellenblock oder Split-Block.
2. Klicke in der Symbolleiste auf die Schaltfläche Einfügen.
3. Wähle Konfigurierbarer Tag aus dem Drop-down-Menü aus.
   • Ein Seitenbereich wird links geöffnet.
4. Gib im Feld Tag-Name das Tag ein, das den Block öffnet und schließt (z. B. with).
5. Gib in Tag-Argumente nur die Argumente für den Tag ein. Gib zum Beispiel für einen with -Tag first_name as name ein. Gib weder den Tag-Namen noch die öffnenden und schließenden Tag-Begrenzungszeichen ein.
6. Bearbeite den Inhalt im Canvas, der innerhalb des Tags enthalten ist. Verwende für das Beispiel with oben {{ name }} an der Stelle, an der der Vorname der Empfänger*innen erscheinen soll.
7. Klicke auf Speichern oder den Zurückpfeil, um das Panel zu schließen und deine Logik zu speichern.

Mit verschachtelter Logik arbeiten

Du kannst Logikanweisungen ineinander verschachteln – zum Beispiel eine if/else-Anweisung innerhalb einer for-Schleife. So kannst du hochgradig zielgerichtete Content-Sequenzen erstellen.

Wenn Logik verschachtelt ist:

• Symbole mit vertikalen Linien zeigen die Verschachtelungsebene jeder Logikanweisung an.
• Wenn du den Mauszeiger über eine übergeordnete Anweisung bewegst, wird der gesamte verschachtelte Block hervorgehoben.
• Wenn du den Mauszeiger über eine untergeordnete Anweisung bewegst, wird nur diese untergeordnete Anweisung hervorgehoben.
• Du kannst untergeordnete Anweisungen unabhängig vom übergeordneten Element einklappen und ausklappen.
• Wenn mehr als 3 Logikebenen verschachtelt sind, wird eine Anzeige +[number] eingeblendet, um die zusätzliche Verschachtelungstiefe anzuzeigen.

Logik in Code umwandeln

Wenn du mehr Kontrolle über eine Bedingung oder Schleife brauchst, kannst du sie in Django-Code umwandeln. Du kannst zum Beispiel ereignisbasierte Bedingungen oder Datumsvergleiche mit Code schreiben.

Warnung: Nachdem du eine Conversion gespeichert hast, kannst du diese Bedingung nicht mehr wechseln oder zum visuellen Builder zurückkehren. Du musst sie als Code weiter bearbeiten. Andere Bedingungen können weiterhin den visuellen Builder verwenden.

Zum Konvertieren:

1. Klicke bei der Logik-Anweisung, die du aktualisieren möchtest, auf Bearbeiten, um das Seitenfenster zu öffnen – oder im Nur-Text-Editor den Dialog.
   • Für if/else-Anweisungen hat jedes einzelne Segment (if, else if) eine eigene Schaltfläche In Code konvertieren. Klicke auf die Schaltfläche für das Segment, das du konvertieren möchtest.
   • Klicke für for-Schleifen auf die einzelne Schaltfläche In Code konvertieren für die gesamte Schleife.
2. Klicke im Warnhinweisdialog auf Konvertieren, um fortzufahren.
3. Bearbeite die konvertierte Bedingung oder die Schleifenargumente im Code-Editor, und klicke dann auf Speichern, um deine Änderungen anzuwenden und das Seitenpanel oder den Dialog zu schließen.

Die gespeicherte Conversion bleibt erhalten, wenn du das Panel oder den Dialog schließt und die Vorlage erneut öffnest.

Unterschiede im reinen Text-Editor

Der Logik-Builder im Nur-Text-Editor funktioniert genauso wie im Drag-and-drop-Editor, mit einem wichtigen Unterschied: Logik wird in einem Modal statt in einem Seitenbereich konfiguriert. Alle gleichen Optionen für If/Else, For-Schleifen, konfigurierbare Tags, Verschachtelung und das Konvertieren in Code sind verfügbar.

Nachdem du die Logik im Nur-Text-Editor konfiguriert hast, klicke auf Speichern, um das Dialogfeld zu schließen, und bearbeite dann den Inhalt in der E-Mail. Klicke bei einer konfigurierten Anweisung auf Bearbeiten, um das Dialogfeld erneut zu öffnen. Wenn du die Bearbeitung der E-Mail abgeschlossen hast, verwende im E-Mail-Editor Speichern, um die Vorlage zu speichern. Wenn du stattdessen Überprüfen und speichern siehst, überprüfe den Inhalt und speichere ihn.

Vorschau der E-Mail anzeigen

Sieh dir vor dem Senden eine Vorschau der E-Mail mit Profilen an, die zu jedem Zweig passen, sowie mit einem Profil, das keine der Bedingungen erfüllt. Für ereignisbasierte Logik sieh dir außerdem eine Vorschau mit den relevanten Ereignisdaten an. Prüfe, dass der erwartete Inhalt angezeigt wird und dass Schleifen die richtigen Elemente anzeigen.

Weitere Ressourcen

• Referenz für bedingte Logik
• So zeigst oder blendest du Vorlagenblöcke und -abschnitte basierend auf dynamischen Variablen ein oder aus
• Leitfaden zur Personalisierung von Nachrichten
• Über benutzerdefinierte Eigenschaften
• Kurs: Programmierlogik-Konzepte anwenden, um personalisiertere Nachrichten zu erstellen