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 een aangepaste eigenschap te selecteren in de vervolgkeuzelijst, voeg je deze eerst toe aan minstens 1 profiel in je account. Profielen en aangepaste eigenschappen kunnen worden toegevoegd via aanmeldingsformulieren, CSV-uploads, e-commerce-integraties en andere tools voor lijstgroei.
Opmerking: De vervolgkeuzelijst voor eigenschappen bevat profiel- en aangepaste eigenschappen, maar vermeldt geen eventgegevens. Om een voorwaarde te schrijven met eventgegevens, kun je Converteren naar code gebruiken en Django-tags direct schrijven. For-loops kunnen een eventlijst direct gebruiken bij Variabele om over te loopen. Gebruik een flow die wordt getriggerd door het event waarvan je de gegevens wilt refereren.
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
- Dubbelklik in een tekstblok, tabelblok of splitsingsblok om de bewerkingsmodus te openen.
- Klik op de knop Invoegen in de werkbalk voor tekstopmaak.
- Selecteer If/else-voorwaarde uit het dropdownmenu.
- Er wordt links een zijpaneel geopend en het canvas schuift naar rechts.
- Configureer je if -instructie:
- Gebruik de eerste dropdown om een profiel of aangepaste eigenschap te kiezen om te evalueren.
- Gebruik de tweede vervolgkeuzelijst om een operator te selecteren (bijv. gelijk aan, groter dan, is ingesteld).
- Voer een waarde in of selecteer een waarde om mee te vergelijken, afhankelijk van de gekozen operator.
- Je kunt ook op Voorwaarde toevoegen klikken om extra criteria toe te voegen aan het if-statement.
- Gebruik AND of OR om voorwaarden met elkaar te verbinden. AND is standaard geselecteerd. Voorwaarden die met AND zijn verbonden, moeten allemaal overeenkomen; voorwaarden die met OR zijn verbonden, bieden alternatieven.
- Klik op de knop Voorwaarde kopiëren bij een voorwaarde om deze te dupliceren als een nieuwe EN-voorwaarde.
- Om een else if -vertakking toe te voegen, klik je op Else if toevoegen en configureer je de voorwaarden op dezelfde manier. Ontvangers zien de content voor de eerste vertakking waaraan ze voldoen. Een else if-vertakking is alleen van toepassing wanneer de if-instructie en alle eerdere else if-vertakkingen niet overeenkomen.
- Het fallback-selectievakje is standaard geselecteerd: Neem anders content op voor alle profielen die niet voldoen aan de voorwaarden. Laat het geselecteerd om content te tonen aan ontvangers die niet aan voorwaarden voldoen, of maak de selectie ongedaan om de anders-vertakking te verwijderen.
- Bewerk de content in het canvas voor elke voorwaarde. Elke voorwaarde wordt tijdens het configureren weergegeven als een blauw vak.
- Wanneer je klaar bent, klik je op Opslaan of op de pijl-terug om het paneel te sluiten en je logica op te slaan.
Tip: Als je de geselecteerde logica wilt verwijderen, klik je in het zijpaneel op Logica verwijderen. De content blijft in de e-mail staan, dus controleer die nadat je de voorwaarden hebt verwijderd.
Let op: Klik op Voorwaarde verwijderen om een voorwaarde te verwijderen. Als je de laatste voorwaarde in de eerste if-instructie verwijdert, worden de waarden gewist, maar blijft de instructie bestaan. Als je de laatste voorwaarde in een else-if-vertakking verwijdert, wordt die vertakking verwijderd. Als je de else-vertakking wilt verwijderen, schakel je het selectievakje voor fallback-content uit.
In de alleen-teksteditor
Selecteer in de teksteditor zonder opmaak Invoegen > Als/anders-voorwaarde op de werkbalk voor tekstbewerking. Configureer de voorwaarden in het dialoogvenster met de bovenstaande opties en klik vervolgens op Opslaan. Bewerk de content voor elke vertakking in de e-mail nadat het dialoogvenster is gesloten.
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
- Dubbelklik in een tekstblok, tabelblok of splitsingsblok.
- Klik op de knop Invoegen in de werkbalk.
- Selecteer For loop in het dropdownmenu.
- Er wordt links een zijpaneel geopend.
- Voer in het veld Variabele om over te loopen de lijst in die je wilt doorlopen (bijv. event.items, als dat de lijstvariabele is in de triggergebeurtenis van je flow). Gebruik de exacte variabelenaam uit je data.
- Voer in het veld Itemalias een naam in om elk afzonderlijk item in de lus te refereren (bijv. item).
- Bewerk de content in het canvas om te bepalen wat er voor elk item wordt weergegeven. Gebruik de itemalias in personalisatietags: voor een alias van
itemgebruik je{{ item }}voor een eenvoudige lijstwaarde, of een veld zoals{{ item.name }}als elk item een naameigenschap heeft. - Klik op Opslaan of op de pijl-terug om het paneel te sluiten en je logica op te slaan.
Tip: Om de lus te verwijderen, klik je op Logica verwijderen in het zijpaneel. De content blijft staan, dus verwijder of vervang tags die afhankelijk zijn van de itemalias.
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.
- Dubbelklik in een tekstblok, tabelblok of splitsingsblok.
- Klik op de knop Invoegen in de werkbalk.
- Selecteer Configureerbare tag in het dropdownmenu.
- Er wordt links een zijpaneel geopend.
- Voer in het veld Tagnaam de tag in die het blok opent en sluit (bijv. with).
- Voer in Tag-argumenten alleen de argumenten voor de tag in. Bijvoorbeeld: voer voor een
with-tagfirst_name as namein. Neem de tagnaam of de openings- en sluitingsscheidingstekens van de tag niet op. - Bewerk de content in de canvas die binnen de tag hoort. Voor het
with-voorbeeld hierboven gebruik je{{ name }}op de plek waar je wilt dat de voornaam van de ontvanger verschijnt. - Klik op Opslaan of 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 3 logic-niveaus zijn genest, verschijnt er een +[number] -indicator om de extra nestdiepte aan te geven.
Logica omzetten naar code
Als je meer controle nodig hebt over een voorwaarde of loop, kun je deze omzetten naar Django-code. Je kunt bijvoorbeeld eventgebaseerde voorwaarden of datumvergelijkingen schrijven met behulp van code.
Waarschuwing: Nadat je een conversie opslaat, kun je die voorwaarde niet meer wijzigen of teruggaan naar de visuele builder. Je moet het verder bewerken als code. Andere voorwaarden kunnen de visuele builder nog steeds gebruiken.
Om te converteren:
- Klik op Bewerken bij de logische instructie die je wilt bijwerken om het zijpaneel te openen of, in de editor met alleen tekst, het dialoogvenster.
- 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.
- Voor for-lussen klik je op de enkele knop Omzetten naar code voor de hele lus.
- Klik in het waarschuwingsvenster op Converteren om door te gaan.
- Bewerk de geconverteerde voorwaarde of loopargumenten in de code-editor en klik vervolgens op Opslaan om je wijzigingen toe te passen en het zijpaneel of dialoogvenster te sluiten.
De opgeslagen conversie blijft behouden wanneer je het paneel of dialoogvenster sluit en de template opnieuw opent.
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 je logica hebt geconfigureerd in de editor met alleen tekst, klik je op Opslaan om het dialoogvenster te sluiten en bewerk je daarna de content in de e-mail. Klik op Bewerken bij een geconfigureerde statement om het dialoogvenster opnieuw te openen. Wanneer je klaar bent met het bewerken van de e-mail, gebruik je Opslaan in de e-maileditor om de template op te slaan. Als je in plaats daarvan Controleren en opslaan ziet, controleer dan de content en sla deze op.
Een voorbeeld van je e-mail bekijken
Bekijk vóór het verzenden een voorbeeld van de e-mail met profielen die overeenkomen met elke vertakking en met een profiel dat aan geen van de voorwaarden voldoet. Bekijk voor op events gebaseerde logica ook een voorbeeld met de relevante eventgegevens. Controleer of de verwachte content wordt weergegeven en of loops de juiste items tonen.