Dynamic content opzetten met if-structuren

If-structuren zijn een tekstgebaseerde manier om dynamische content toe te voegen aan je berichten. Ze laten je verschillende tekst, afbeeldingen of links tonen aan verschillende contacten in dezelfde e-mail, op basis van de informatie die je over hen hebt in je eigen velden.

Gebruik if-structuren wanneer het dynamische contentpaneel op structuurniveau niet specifiek genoeg is — bijvoorbeeld wanneer je een enkele zin binnen een alinea wilt personaliseren, of slechts een paar woorden van een begroeting wilt aanpassen. If-structuren werken in de E-mail Builder, de Wizard-template en de HTML-editor.

Vereisten

• Je kent de plaatshouderrnaam van het eigen veld dat je wilt gebruiken. Je kunt plaatshouderrnamen vinden via Instellingen > Eigen velden beheren.
• Je testprofiel in Instellingen is ingevuld met representatieve waarden, zodat je de uitvoer kunt bekijken.

Basissyntaxis

Een if-structuur bestaat uit drie delen: een opening {if ...} , een optionele {else}  en een sluiting {/if} . Daartussen plaats je de inhoud die je wilt tonen.

Inhoud alleen tonen wanneer de voorwaarde waar is:

{if ::firstname::!=""} 

Één stuk inhoud tonen wanneer de voorwaarde waar is, en een terugval wanneer dat niet het geval is:

{if ::firstname::!=""}Hallo #firstname#,{else}Hallo,{/if} 

Het deel tussen {if  en }  is de voorwaarde — hier beschrijf je wat je wilt controleren. Al het andere is gewoon inhoud.

Verwijzen naar een eigen veld

Binnen een if-structuur verwijs je naar een eigen veld door de plaatshouder te omgeven met dubbele dubbele punten: ::placeholder:: . Om bijvoorbeeld het voornaamveld te controleren, schrijf je ::firstname:: .

Dit is anders dan de #placeholder# -syntaxis die wordt gebruikt voor gewone personalisatie. Gebruik binnen if-structuren altijd de vorm ::placeholder:: .

Beschikbare functies

De waarde van een contactveld controleren

Het meest voorkomende gebruik van een if-structuur is het controleren wat er is opgeslagen in een contactveld en inhoud dienovereenkomstig tonen.

{if ::language::=="fr"}Bonjour{else}Hello{/if} 

Contacten wiens contacttaal Frans is, zien "Bonjour". Alle anderen zien "Hello".

Hoofdletters, kleine letters, uppercaseFirst

Waarde controles zijn hoofdlettergevoelig bij if-structuren. "Waarde" en "waarde" zijn niet hetzelfde, dus sommige contacten vallen mogelijk buiten je voorwaarde simpelweg omdat hun veld met een andere schrijfwijze is opgeslagen. Omgeef het veld met uppercase(...)  of lowercase(...)  voor een veilige vergelijking:

{if uppercase(::placeholder::)=="WAARDE"}...{/if} 

{if lowercase(::placeholder::)=="waarde"}...{/if} 

Fallback

Gebruik {fallback(...)}  wanneer je de veldwaarde van een contact wilt tonen, met een standaard voor contacten waarbij het veld leeg is. Het is eenvoudiger dan een volledige if-else-structuur voor dit veelvoorkomende geval.

Beste {fallback(::firstname::,"klant")} 

Contacten met een voornaam zien "Beste Sarah". Contacten zonder voornaam zien "Beste klant". Let op dat {fallback(...)}  zelfstandig wordt gebruikt binnen accolades — het heeft geen omringende {if} -tags nodig.

Contains

Gebruik contains()  wanneer je slechts een deel van een veldwaarde wilt controleren, niet een exacte overeenkomst.

{if contains(::haystack::,"Needle")} … {else} … {/if} 

Length

Gebruik length(...)  wanneer het aantal tekens in een veld de inhoud moet bepalen. Stel je voor dat je gepersonaliseerde sleutelhangers verkoopt, maar er slechts 7 tekens op het product passen:

{if length(::firstname::)<7} Artikel over gepersonaliseerde sleutelhangers {else} … {/if} 

Waar je if-structuren plaatst

Je kunt if-structuren plaatsen overal waar je tekst kunt typen: in een tekstelement in de E-mail Builder, in de tekstgebieden van de Wizard-template of in de HTML-editor. Ze werken hetzelfde in alle drie de tools.

Nesten

Je kunt if-structuren in elkaar plaatsen voor specifiekere combinaties:

{if ::language::=="NL"}
    {if ::country::=="BE"}Welkom in België
    {else}Welkom{/if} 
{else}Welcome{/if}

Houd nesten tot een minimum. Twee niveaus diep is doorgaans voldoende — meer dan dat wordt moeilijk leesbaar en gemakkelijk te breken.

Veelgemaakte fouten om te vermijden

• Vergeten de if-structuur te sluiten met {/if} . Een niet-gesloten structuur breekt het bericht en kan onverwachte uitvoer produceren.
• #placeholder#  gebruiken in plaats van ::placeholder:: . Binnen een if-structuur werkt alleen de vorm ::placeholder:: .
• Een plaatshouderrnaam gebruiken die niet overeenkomt met wat er in Instellingen staat. Plaatshouderrnamen moeten exact overeenkomen. Controleer Instellingen > Eigen velden beheren als je het niet zeker weet.
• Waarden vergelijken met een verschillende schrijfwijze. "FR"  en "fr"  zijn niet gelijk. Omgeef het veld met uppercase(...)  of lowercase(...)  om de vergelijking hoofdletterongevoelig te maken.
• Proberen een interesse of segment te controleren. If-structuren werken alleen met eigen velden. Gebruik voor interesses of segmenten het dynamische contentpaneel op structuurniveau in de E-mail Builder.

Volgende stappen

• Zie "Dynamische content in de E-mail Builder" voor het alternatief op structuurniveau waarvoor geen syntaxis nodig is.
• Zie "Een bericht personaliseren met plaatshouders" voor het rechtstreeks invoegen van contactveldwaarden in je tekst.
• Vind je plaatshouderrnamen via Instellingen > Eigen velden beheren.