Referens för villkorslogik för mallar

Du kommer att lära dig

Läs om alla tillgängliga villkor som du kan använda för att dynamiskt visa ett block, en sektion eller ett specialkodat innehåll bara för vissa mottagare. Du kan använda samma villkor för varje show/hide-logikvariation. Om du vill läsa mer om hur du använder dessa villkor i dina mallar kan du gå till vår artikel om hur du visar eller döljer mallblock baserat på dynamiska variabler.

Lär dig använda villkorslogik:

• Var du kan använda villkor
• Tips för att lyckas
• Villkorsstrukturer
• Bygg komplexa villkor
• Använd villkor i en konverterad HTML-mall

Var du kan använda villkor

Du kan använda villkor i:

• E-postmeddelanden
  • Skapa logik för att visa/dölja för att dynamiskt visa block eller avsnitt bara för vissa personer.
    • Om du föredrar att inte skriva kod kan du använda verktyget för visa-/dölj-logik i stället.
  • Skapa show/hide-logikvariationer för att visa en annan version av ett block eller avsnitt för varje målgrupp. Varje logikvariation har sitt eget villkor, som du kan bygga med logikverktyget eller skriva som anpassad kod.
  • Skriv if/else-villkor för att skapa anpassade Django-uttryck.
• Klaviyo Customer Hub
  • Skriv if/else-villkor för att skapa anpassade Django-uttryck i innehållsblock

Tips för att lyckas

När du bygger upp villkor för visa/dölj ska du vara uppmärksam på detaljerna. Villkor för visa/dölj är skiftlägeskänsliga, och stavningen måste exakt matcha dina profil- eller händelsedata.

Se också till att du tar hänsyn till alla möjliga tittare. Om du till exempel visar ett specifikt block endast för invånare i en viss delstat, ta med alla möjliga stavningar av delstatens namn (t.ex. Massachusetts, massachusetts, mass, MA). Ta också hänsyn till profiler som kanske inte har egenskapen inställd alls.

Om du använder logiska variationer kan du lägga till ett alternativ så att mottagare som inte matchar någon variation, inklusive de utan egenskapen, fortfarande ser innehåll.

När du har byggt meddelandet och tillämpat dina villkor kan du förhandsgranska det med hjälp av en mängd olika profiler för att bekräfta att meddelandet visas som du tänkt i alla scenarier.

Villkorsstrukturer

Villkor ska innehålla 1–3 element, beroende på ditt mål för blocket och de data du använder. Villkoret måste minst innehålla en variabel (t.ex. person|lookup:'Favorite Color'). Det kan också innehålla en jämförelsefunktion, som == (är lika med) eller > (större än) och ett värde, som anger ett egenskapsvärde att leta efter. Dessutom börjar vissa villkor med not om du vill att blocket bara ska visas för profiler som inte uppfyller ett villkor.

För anpassad show/hide-logik anger du uttrycket för sig, utan taggarna {{ }} eller {% if ... %}. Lägg till mellanslag på båda sidor om jämförelseoperatorer. Använd raka citattecken runt textvärden, till exempel 'green', och lämna siffror utan citattecken, till exempel 20.

Diagrammet nedan innehåller en fullständig lista över möjliga strukturer som ett visa/dölj-villkor kan följa. Samma strukturer gäller för villkoret för varje logisk variation.

Villkor för booleska värden

Om du refererar till datalager som ett booleskt värde behöver du använda 1 och 0 i stället för ”true” och ”false” i din definition av villkoret för att visa/dölja. Sätt inte citattecken runt 1 eller 0. Använd exempelvillkoren nedan som en mall.

Villkor för booleska värden som lagras som text

Om dina true/false-data lagras som text, inte som ett booleskt värde, kan du använda exempelvillkoren för textegenskaper ovan. Om du inte är säker, eller om du refererar till en egenskap som innehåller både booleska värden och text, kan du använda de här strukturerna för att täcka alla scenarier. Ta med alla stavningar och versaliseringar som finns i dina data.

Bygg komplexa villkor

Om du vill att ditt block ska visas för personer som uppfyller flera kriterier, eller om du har ett komplext användningsfall, kan du använda flera show/hide-villkor för ett block. För att göra det kopplar du ihop villkoren med and eller or i gemener. Använd and när båda villkoren måste vara sanna och or när något av dem kan vara sant. När du kombinerar dem utvärderas and före or. Om du till exempel vill visa ett block för alla i Massachusetts, men Massachusetts stavas på olika sätt på vissa profiler, kan du använda ett villkor som detta:

person.location.region == 'Massachusetts' or person.location.region == 'massachusetts' or person.location.region == 'mass' or person.location.region == 'MA'

Om du bara vill visa ett block för personer vars favoritfärg är grön och som också är VIP:ar kan du använda ett villkor som detta:

person|lookup:'Favorite Color' == 'green' and person|lookup:'VIP' == 1

Villkor för alla logikvariationer

När ett block eller en sektion har visa-/dölj-logikvariationer har varje variation sitt eget villkor. Variationerna kontrolleras uppifrån och ned och varje mottagare ser bara den första variationen som de matchar. Därför behöver villkoret för en senare variation inte utesluta målgrupper som en tidigare variation redan täcker.

Till exempel kan ett block ha dessa 2 variationer:

1. Variation 1: person|lookup:'VIP' == 1
2. Variation 2: person|lookup:'Favorite Color' == 'green'

En VIP vars favoritfärg är grön ser bara variation 1. För att visa dem variation 2 i stället drar du variation 2 ovanför variation 1 eller gör villkoret för variation 1 mer specifikt.

För att visa innehåll för alla som inte matchar en variation kan du lägga till en reserv i stället för att skriva ett villkor som ska fånga upp alla, till exempel person|lookup:'Favorite Color' != 'green' and person|lookup:'VIP' != 1. Reserven har inget villkor och täcker även mottagare som inte har egenskapen inställd.

Villkorssatser och inline-textredigeraren

Django-instruktioner som stöds i textblock visas som logikblock i den inbyggda textredigeraren. Deras etiketter fortsätter att vara en del av mallen. Så här redigerar du ett villkor:

1. Dubbelklicka på textblocket.
2. Om Det här blocket använder formatering som inte stöds visas kan du gå igenom formateringsalternativen. Välj Redigera i uppdaterat textblock om du vill fortsätta med justerad formatering. Om du vill behålla den befintliga formateringen väljer du Konvertera till HTML-block och redigerar koden på fliken Innehåll i stället för att följa de återstående stegen.
3. Klicka på logikblockets Redigera -penna för att öppna Redigera logikblock.
4. Uppdatera villkoret och klicka på Spara. Klicka utanför textblocket för att avsluta redigeringen.

Du kan också redigera Django-uttryck direkt på fliken Innehåll i ett HTML -blocks.

Följande etiketter representeras i logikblock:

• {% for ... %}
• {% endfor %}
• {% if ... %}
• {% elif ... %}
• {% else %}
• {% endif %}
• {% with ... %}
• {% endwith %}

Använd villkor i en konverterad HTML-mall

Om du vill använda dra-och-släpp-redigeraren med en sparad HTML-mall skapar du en konverterad kopia. Du behöver behörighet för att redigera mallar. Den ursprungliga HTML-mallen förblir oförändrad.

1. Navigera till Innehåll > Mallar och välj E-post: sparade.
2. Öppna HTML-mallens meny med tre punkter och välj Klona till dra och släpp.
3. Välj Konverterade mallar. När kopians status är Redo att använda klickar du på dess namn för att öppna den i redigeraren.

Granska textens villkorsstyrda innehåll och gör nödvändiga ändringar. Klicka på Förhandsgranska och kontrollera profiler som uppfyller dina villkor, profiler som inte gör det och profiler utan den refererade egenskapen innan du använder mallen.

Ytterligare resurser