Referenz zur bedingten Logik für Vorlagen
Übersicht
Erfahre mehr über alle verfügbaren Bedingungen, die du verwenden kannst, um einen Block, einen Abschnitt oder ein benutzerdefiniertes codiertes Inhaltselement dynamisch nur für bestimmte Empfänger*innen anzuzeigen. Du kannst dieselben Bedingungen für jede Show/Hide-Logik-Variante verwenden. Um zu erfahren, wie du diese Bedingungen in deinen Vorlagen verwendest, lies unseren Artikel zum Anzeigen oder Ausblenden von Vorlagenblöcken basierend auf dynamischen Variablen.
Erfahre, wie du bedingte Logik verwendest:
- Wo du Bedingungen verwenden kannst
- Tipps für den Erfolg
- Bedingungsstrukturen
- Erstelle komplexe Bedingungen
- Bedingungen in einer konvertierten HTML-Vorlage verwenden
Wo du Bedingungen verwenden kannst
Du kannst Bedingungen verwenden in:
- E-Mails
- Erstelle Logik zum Ein- und Ausblenden, um Blöcke oder Abschnitte nur bestimmten Personen anzuzeigen.
- Wenn du lieber keinen Code schreiben möchtest, verwende stattdessen den Logik-Builder zum Ein-/Ausblenden.
- Erstelle Varianten für die Logik „Anzeigen/Ausblenden“, um jeder Zielgruppe eine andere Version eines Blocks oder Abschnitts anzuzeigen. Jede Logikvariante hat eine eigene Bedingung, die du mit dem Logik-Builder erstellen oder als benutzerdefinierten Code schreiben kannst.
- Schreibe if/else-Bedingungen, um benutzerdefinierte Django-Anweisungen zu erstellen.
- Erstelle Logik zum Ein- und Ausblenden, um Blöcke oder Abschnitte nur bestimmten Personen anzuzeigen.
- Customer Hub
- Schreibe if/else-Bedingungen, um in Inhaltsblöcken benutzerdefinierte Django-Anweisungen zu erstellen
Tipps für den Erfolg
Wenn du Bedingungen zum Ein- oder Ausblenden erstellst, achte auf die Details. Bedingungen zum Ein-/Ausblenden berücksichtigen die Groß- und Kleinschreibung, und die Schreibweise muss exakt mit deinen Profil- oder Ereignisdaten übereinstimmen.
Achte außerdem darauf, alle potenziellen Viewer*innen zu berücksichtigen. Wenn du zum Beispiel einen bestimmten Block nur Einwohner*innen eines bestimmten Bundesstaats zeigst, decke alle möglichen Schreibweisen des Bundesstaatsnamens ab (z. B. Massachusetts, massachusetts, mass, MA). Berücksichtige außerdem Profile, bei denen die Eigenschaft möglicherweise gar nicht festgelegt ist.
Wenn du Logik-Varianten verwendest, füge eine Fallback-Option hinzu, damit Empfänger*innen, die zu keiner Variante passen (auch diejenigen ohne die Eigenschaft), weiterhin Inhalte sehen.
Nachdem du die Nachricht erstellt und deine Bedingungen angewendet hast, sieh dir über Vorschau mithilfe verschiedener Profile eine Vorschau an, um zu bestätigen, dass die Nachricht in allen Szenarien wie beabsichtigt angezeigt wird.
Bedingungsstrukturen
Bedingungen sollten je nach Ziel des Blocks und den verwendeten Daten 1–3 Elemente enthalten. Die Bedingung muss mindestens eine Variable enthalten (z. B. person|lookup:'Favorite Color'). Sie kann auch eine Vergleichsfunktion wie == (gleich) oder > (größer als) sowie einen Wert enthalten, der einen Eigenschaftswert angibt, nach dem gesucht werden soll. Außerdem beginnen bestimmte Bedingungen mit not, wenn du möchtest, dass der Block nur für Profile erscheint, die eine Bedingung nicht erfüllen.
Für benutzerdefinierte, benutzerdefiniert codierte Ein-/Ausblende-Logik gib den Ausdruck allein ein, ohne {{ }} - oder {% if ... %} -Tags. Füge auf beiden Seiten von Vergleichsoperatoren Leerzeichen hinzu. Verwende gerade Anführungszeichen um Textwerte, z. B. 'green', und setze Zahlen nicht in Anführungszeichen, z. B. 20.
Das Diagramm unten enthält eine vollständige Liste möglicher Strukturen, denen eine Einblenden-/Ausblenden-Bedingung folgen kann. Dieselben Strukturen gelten für die Bedingung jeder Logikvariante.
Beispielbedingung | Block anzeigen, wenn ... | Zulässige Datentypen |
person|lookup:'Lieblingsfarbe' | Die Eigenschaft | Beliebig |
nicht Person|lookup:'Lieblingsfarbe' | Die Eigenschaft | Beliebig |
person|lookup:'Favorite Color' == 'green' | Die Eigenschaft | Text, Nummer |
person|lookup:'Lieblingsfarbe' != 'grün' | Die Eigenschaft | Text, Nummer |
person|lookup:'Alter' > 20 | Die Eigenschaft | Zahl |
person|lookup:'Alter' >= 20 | Die Eigenschaft | Zahl |
person|lookup:'Alter' < 20 | Die Eigenschaft | Zahl |
person|lookup:'Alter' <= 20 | Die Eigenschaft | Zahl |
‚green‘ in Person|lookup:‚Favorite Colors‘ | Die Eigenschaft Die Eigenschaft | Liste, Text |
nicht „grün“ persönlich|lookup:'Lieblingsfarben' | Die Eigenschaft Die Eigenschaft | Liste, Text |
Bedingungen für Boolesche Werte
Wenn du auf Daten verweist, die als Boolean im Datenspeicher gespeichert sind, musst du in der Definition deiner Ein-/Ausblenden-Bedingung 1 und 0 statt „true“ und „false“ verwenden. Setze 1 oder 0 nicht in Anführungszeichen. Verwende die untenstehenden Beispielbedingungen als Vorlage.
Beispielbedingung | Block anzeigen, wenn ... |
person|lookup:'VIP' == 1 | Die Eigenschaft |
person|lookup:'VIP' == 0 | Die Eigenschaft |
Bedingungen für Booleans, die als Text gespeichert sind
Wenn deine Wahr/Falsch-Daten als Text und nicht als Boolean gespeichert sind, verwende die Beispielbedingungen für Texteigenschaften oben. Wenn du dir nicht sicher bist oder wenn du dich auf eine Eigenschaft beziehst, die sowohl Booleans als auch Text enthält, kannst du diese Strukturen verwenden, um alle Szenarien abzudecken. Schließe alle Schreibweisen und Groß-/Kleinschreibungen ein, die in deinen Daten vorhanden sind.
Beispielbedingung | Block anzeigen, wenn ... |
person|lookup:'VIP' == 1 or person|lookup:'VIP' == 'true' or person|lookup:'VIP' == 'True' | Die Eigenschaft |
person|lookup:'VIP' == 0 or person|lookup:'VIP' == 'false' or person|lookup:'VIP' == 'False' | Die Eigenschaft |
Erstelle komplexe Bedingungen
Wenn du möchtest, dass dein Block Personen angezeigt wird, die mehrere Kriterien erfüllen, oder wenn du einen komplexen Anwendungsfall hast, kannst du für einen Block mehrere Ein-/Ausblendbedingungen verwenden. Verbinde dazu die Bedingungen mit kleingeschriebenem and oder or. Verwende and, wenn beide Bedingungen wahr sein müssen, und or, wenn eine von beiden wahr sein kann. Wenn du sie kombinierst, wird and vor or ausgewertet. Wenn du zum Beispiel einen Block allen Personen in Massachusetts anzeigen möchtest, „Massachusetts“ aber in einigen Profilen unterschiedlich geschrieben ist, kannst du eine Bedingung wie diese verwenden:
person.location.region == 'Massachusetts' or person.location.region == 'massachusetts' or person.location.region == 'mass' or person.location.region == 'MA'
Wenn du einen Block nur Personen anzeigen möchtest, deren Lieblingsfarbe Grün ist und die außerdem VIPs sind, kannst du eine Bedingung wie diese verwenden:
person|lookup:'Favorite Color' == 'green' and person|lookup:'VIP' == 1
Bedingungen über alle Logikvarianten hinweg
Wenn ein Block oder Abschnitt Show-/Hide-Logikvarianten hat, hat jede Variante ihre eigene Bedingung. Varianten werden von oben nach unten geprüft, und jede*r Empfänger*in sieht nur die erste Variante, auf die sie*er zutrifft. Daher muss die Bedingung einer späteren Variante keine Zielgruppen ausschließen, die eine frühere Variante bereits abdeckt.
Ein Block könnte zum Beispiel diese 2 Varianten haben:
- Variante 1: person|lookup:'VIP' == 1
- Variante 2: person|lookup:'Favorite Color' == 'green'
Ein VIP, dessen Lieblingsfarbe Grün ist, sieht nur Variante 1. Damit du ihnen stattdessen Variante 2 anzeigst, ziehe Variante 2 über Variante 1 oder mache die Bedingung von Variante 1 spezifischer.
Damit allen Content angezeigt wird, die nicht zu einer Variante passen, füge stattdessen einen Fallback hinzu, statt eine „Catch-all“-Bedingung zu schreiben wie person|lookup:'Favorite Color' != 'green' and person|lookup:'VIP' != 1. Der Fallback hat keine Bedingung und deckt auch Empfänger*innen ab, bei denen die Eigenschaft nicht festgelegt ist.
Bedingte Anweisungen und der Inline-Texteditor
Unterstützte Django-Anweisungen in Textblöcken werden im Inline-Texteditor als Logikblöcke angezeigt. Ihre Tags bleiben Teil der Vorlage. So bearbeitest du eine Bedingung:
- Doppelklicke auf den Textblock.
- Wenn Dieser Block verwendet nicht unterstützte Formatierungen angezeigt wird, überprüfe die Formatierungsoptionen. Wähle Im aktualisierten Textblock bearbeiten aus, um mit angepasstem Styling fortzufahren. Um die bestehende Formatierung beizubehalten, wähle In HTML-Block konvertieren aus und bearbeite stattdessen den Code im Tab Inhalt, anstatt die verbleibenden Schritte auszuführen.
- Klicke auf den Bearbeiten -Stift des Logikblocks, um Logikblock bearbeiten zu öffnen.
- Aktualisiere die Bedingung und klicke auf Speichern. Klicke außerhalb des Textblocks, um die Bearbeitung abzuschließen.
Du kannst Django-Anweisungen auch direkt im HTML -Block auf dem Tab Inhalt bearbeiten.
Die folgenden Tags werden in Logikblöcken dargestellt:
- {% for ... %}
- {% endfor %}
- {% if ... %}
- {% elif ... %}
- {% else %}
- {% endif %}
- {% with ... %}
- {% endwith %}
Bedingungen in einer konvertierten HTML-Vorlage verwenden
Um den Drag-and-Drop-Editor mit einer gespeicherten HTML-Vorlage zu verwenden, erstelle eine konvertierte Kopie. Du benötigst die Berechtigung, Vorlagen zu bearbeiten. Die ursprüngliche HTML-Vorlage bleibt unverändert.
- Navigiere zu Inhalt > Vorlagen und wähle E-Mail: gespeichert aus.
- Öffne das 3-Punkte-Menü der HTML-Vorlage und wähle In Drag-and-Drop klonen aus.
- Wähle Konvertierte Vorlagen aus. Wenn der Status der Kopie Einsatzbereit ist, klicke auf ihren Namen, um sie im Editor zu öffnen.
Prüfe die bedingten Inhalte des Texts und nimm alle erforderlichen Änderungen vor. Klicke auf Vorschau und prüfe Profile, die deine Bedingungen erfüllen, Profile, die sie nicht erfüllen, und Profile ohne die referenzierte Eigenschaft, bevor du die Vorlage verwendest.
Weitere Ressourcen
- So zeigst oder blendest du Vorlagenblöcke und -abschnitte basierend auf dynamischen Variablen ein oder aus
Erfahre, wie du mithilfe des Show/Hide-Logik-Builders der Vorlagenbearbeitung einen bestimmten Block oder Abschnitt in einer E-Mail bestimmten Empfänger*innen anzeigen kannst.
- Leitfaden zur Personalisierung von Nachrichten
Erfahre wie du die Vorlagen-Tags von Klaviyo verwendest, um deinen Kund*innen ein individuelles Erlebnis zu bieten.
- Grundlegendes zu Profilen in Klaviyo
Erfahre mehr über Profile, einschließlich wie du sie findest und welche Daten auf der Profilseite verfügbar sind. Profile werden verwendet, um alle Informationen nachzuverfolgen, die du über deine Kund*innen und potenzielle Kund*innen hast.
- Glossary of variable filters