Voorwaardelijke logica toevoegen aan e-mailtemplate met de logic builder

Wat je leert

Leer hoe je de logic builder gebruikt om dynamische voorwaardelijke logica, zoals if/else-instructies en for-loops, rechtstreeks toe te voegen aan tekstblokken in je e-mailtemplate. Hiermee kun je gepersonaliseerde content aan verschillende ontvangers weergeven op basis van hun profiel of aangepaste properties, zonder code te schrijven.

Voordat je van start gaat

De logic builder is beschikbaar in:

• E-maileditor met slepen en neerzetten — tekstblokken, tabelblokken en splitsingsblokken
• Editor voor e-mails met alleen tekst — via een modal in plaats van een zijpaneel

Om de logic builder te gebruiken, heb je minimaal één profiel in je account nodig met de property die je wilt evalueren. Profielen en aangepaste eigenschappen kunnen worden toegevoegd via aanmeldingsformulieren, CSV-uploads, e-commerce-integraties en andere tools voor lijstgroei.

Opmerking: De Logic builder ondersteunt profiel- en aangepaste eigenschappen. Het ondersteunt geen gebeurtenisgegevens. Als je gebeurtenisgegevens in je logica wilt gebruiken, gebruik je de optie Converteren naar code en schrijf je Django-tag direct.

Voeg een if/else-instructie toe

Gebruik een if/else-statement om verschillende content weer te geven aan ontvangers op basis van een profiel of aangepaste eigenschap. Je kunt bijvoorbeeld een VIP-kortingsblok alleen tonen aan klanten met meer dan 500 loyaliteitspunten, en een aanmeldingsincentive aan alle anderen.

In de editor op basis van slepen en neerzetten

1. Dubbelklik in een tekstblok, tabelblok of splitsingsblok om de bewerkingsmodus te openen.
2. Klik op de knop Invoegen in de werkbalk bovenaan de pagina.
3. Selecteer If/else in het dropdownmenu.
   • Er wordt links een zijpaneel geopend en het canvas schuift naar rechts.
4. Configureer je if -instructie:
   • Gebruik de eerste dropdown om een profiel of aangepaste eigenschap te kiezen om te evalueren.
   • Gebruik de tweede dropdown om een operator te selecteren (bijv. is gelijk aan, is groter dan, is ingesteld).
   • Voer een waarde in of selecteer een waarde om mee te vergelijken, afhankelijk van de gekozen operator.
5. Je kunt ook op Voorwaarde toevoegen klikken om extra criteria toe te voegen aan het if-statement.
   • Gebruik AND of OR om voorwaarden te koppelen. OR is standaard geselecteerd.
   • Klik op de knop klonen bij een voorwaarde om deze te dupliceren als een nieuwe OF-voorwaarde.
6. Als je een else if -vertakking wilt toevoegen, klik je op Else if toevoegen en configureer je de voorwaarden op dezelfde manier. Ontvangers die aan deze voorwaarden voldoen, maar niet aan de if-instructie, zien deze content.
7. Als je een else -tak wilt toevoegen, vink je het selectievakje Else aan (standaard aangevinkt). Bewerk de content in het canvas om te bepalen wat ontvangers te zien krijgen die niet aan een voorwaarde voldoen. Schakel het selectievakje uit om de else-tak volledig te verwijderen.
8. Bewerk de content in het canvas voor elke voorwaarde. Elke voorwaarde wordt tijdens het configureren weergegeven als een blauw vak.
9. Als je klaar bent, klik je op de terugpijl om het paneel te sluiten en je logica op te slaan.

Tip: Als je alle geconfigureerde logica uit een blok wilt verwijderen, klik je in het zijpaneel op Logica verwijderen.

Let op: Als je in de eerste if-instructie op Verwijderen klikt, worden de waarden ervan gereset in plaats van dat de instructie volledig wordt verwijderd. Als je in een else if- of else-tak op Verwijderen klikt, wordt die tak verwijderd.

In de alleen-teksteditor

Volg dezelfde stappen hierboven, maar selecteer Invoegen in de werkbalk voor tekstbewerking. De logic builder wordt geopend in een modaal venster in plaats van in een zijpaneel. Allezelfde configuratieopties zijn beschikbaar.

Voeg een for-loop toe

Gebruik een for-lus om door een lijst met items te itereren en herhaalde content voor elk item weer te geven. Je kunt bijvoorbeeld door de onlangs bekeken producten van een klant loopen om elk product in de e-mail te tonen.

In de editor op basis van slepen en neerzetten

1. Dubbelklik in een tekstblok, tabelblok of splitsingsblok.
2. Klik op de knop Invoegen in de werkbalk.
3. Selecteer For loop in het dropdownmenu.
   • Er wordt links een zijpaneel geopend.
4. Voer in het veld Variabele de lijst in waar je doorheen wilt loopen (bijv. event.items).
5. Voer in het veld Itemalias een naam in om elk afzonderlijk item in de lus te refereren (bijv. item).
6. Bewerk de content op het canvas om te definiëren wat er voor elk item wordt weergegeven.
7. Klik op de pijl terug om het paneel te sluiten en je logica op te slaan.

Tip: Klik in het zijpaneel op Logica verwijderen om de loop helemaal te verwijderen.

Een configureerbare tag toevoegen

Gebruik een configureerbare tag om Django-tags in te voegen die niet worden afgedekt door de if/else- of for-loop-builders—zoals with-statements of catalog-tags.

1. Dubbelklik in een tekstblok, tabelblok of splitsingsblok.
2. Klik op de knop Invoegen in de werkbalk.
3. Selecteer Configureerbare tag in het dropdownmenu.
   • Er wordt links een zijpaneel geopend.
4. Voer in het veld Tagnaam de tag in die het blok opent en sluit (bijv. with).
5. Voeg in het tekstgebied Code je aangepaste Django-tagcode toe.
6. Klik op Vertakking toevoegen om een vertakking toe te voegen. Hiermee wordt een extra sectie gemaakt waarin je nog een tagnaam en codeblok kunt configureren.
7. Klik op de pijl terug om het paneel te sluiten en je logica op te slaan.

Werken met geneste logica

Je kunt logica-instructies in elkaar nesten, bijvoorbeeld een if/else-instructie in een for loop. Zo kun je zeer gerichte contentreeksen opbouwen.

Wanneer logica is genest:

• Pictogrammen met verticale lijnen geven het insluitingsniveau van elke logic statement aan.
• Als je met de muis over een bovenliggende statement beweegt, wordt het volledige geneste blok gemarkeerd.
• Als je met de muis over een onderliggende statement beweegt, wordt alleen die onderliggende gemarkeerd.
• Je kunt onderliggende instructies samenvouwen en uitvouwen, onafhankelijk van de bovenliggende instructie.
• Als er meer dan drie logicaniveaus zijn genest, verschijnt er een indicator +[number] om de extra nested depth weer te geven.

Logica omzetten naar code

Als je meer controle nodig hebt over je logica, of niet-ondersteunde functies wilt gebruiken zoals gebeurtenisgegevens of datumvergelijkingen, kun je de configuratie van je logicabouwer omzetten naar onbewerkte Django-code.

Waarschuwing: logica omzetten naar code is een eenmalige actie en kan niet ongedaan worden gemaakt. Je kunt na het omzetten niet meer terugschakelen naar de logic builder.

Om te converteren:

1. Open het zijpaneel van de logica-builder voor het blok dat je wilt bijwerken.
2. Bij if/else-statements heeft elk afzonderlijk segment (if, else if) een eigen knop Converteren naar code. Klik op de knop voor het segment dat je wilt converteren.
3. Voor for-lussen klik je op de enkele knop Omzetten naar code voor de hele lus.
4. Er verschijnt een waarschuwingsmodaal venster. Bevestig dat je wilt doorgaan.
5. Na de conversie verschijnt de omgezette code in een code-editor in het zijpaneel. Je kunt het daar direct bewerken.

Deze geconverteerde status is permanent: deze blijft bestaan, zelfs nadat je het paneel sluit of weg navigeert van de template.

Verschillen in de alleen-teksteditor

De logic builder in de editor met alleen tekst werkt hetzelfde als in de editor voor slepen en neerzetten, met één belangrijk verschil: logica wordt geconfigureerd in een modal in plaats van een zijpaneel. Allezelfde opties voor if/else, for-loops, configureerbare tags, nesten en omzetten naar code zijn beschikbaar.

Nadat de logica is geconfigureerd, wordt deze op dezelfde manier op het canvas weergegeven als in de editor voor slepen en neerzetten. Als je op Bewerken klikt bij een geconfigureerde voorwaarde, wordt het modale venster geopend zodat je verdere bewerkingen kunt doen.

Extra hulpbronnen

• Referentie voor voorwaardelijke logica
• Templateblokken en -secties weergeven of verbergen op basis van dynamische variabelen
• Gids voor personalisatie van berichten
• Over aangepaste eigenschappen
• Cursus: Pas programmeerlogica-concepten toe om meer gepersonaliseerde berichten te maken