Doelgroep: E-mailtemplate bouwers
In Ternair Marketing Cloud kan de inhoud van e-mails (en SMS-berichten) worden gepersonaliseerd en aangepast (dynamische content). Verder kunnen variabelen in output blokken gebruikt worden.
De volgende drie opties worden gebruikt:
- Velden: veldnaam
- Operators: operator symbool
- Parameters: waarde
Belangrijke specificaties:
- Velden en operatoren worden ingekort. Dit betekent dat voorloop- en/of naloopspaties automatisch worden verwijderd. Voor parameters wordt deze techniek niet toegepast.
- Waarden zijn NIET hoofdlettergevoelig.
- Het gebruik van newlines (enters) is mogelijk.
- Een veld kan alle tekens bevatten, met uitzondering van [ ] / | \
Voorbeelden
Een waarde tonen
Variabelen worden tussen haakjes geplaatst [<waarde>].
Het is belangrijk om de syntax altijd te openen en te eindigen (sluiten).
Gebruik een backslash (\) om te voorkomen dat de variabele wordt vervangen.
| Voorbeeld | Resultaat |
| Mijn naam is [voornaam] | Mijn naam is John |
| Mijn naam is [voornaam] \[achternaam\] Syntax negeren |
Mijn naam is John [achternaam] |
Een of meerdere waarden vervangen
Bij het vervangen van een of meerdere waarden zijn een ‘if’ en een ‘else’ vereist. Het gebruik van meerdere if-else statements is mogelijk.
In een template wordt dit als volgt gebruikt:
[<veld>|<operator>|<if-case>|<else-case>]
| Voorbeeld | Resultaat |
| Beste [geslacht|=V|mevrouw|meneer], | — Wanneer waarde geslacht is V Beste mevrouw, — Anders Beste meneer, |
| Beste [geslacht|=V|mevrouw|=M|meneer|bezoeker], | — Wanneer waarde geslacht is V Beste mevrouw, — Wanneer waarde geslacht is M Beste meneer, — Anders Beste bezoeker, |
| Beste [geslacht|=V|mevrouw], Spatie in tekst |
— Wanneer waarde geslacht is V Beste mevrouw, — Anders Beste , (inclusief spatie) |
| Beste[geslacht|=V| mevrouw], Spatie in parameter |
— Wanneer waarde geslacht is V Beste mevrouw, — Anders Beste, (zonder spatie) |
| Beste [geslacht|=V| mevrouw| meneer], Gebruik van enters (break) is toegestaan |
— Wanneer waarde geslacht is V Beste mevrouw, |
| Mijn naam is [naam|John [naam|Jonny] Doe]. Twee syntaxen in één variabele |
Mijn naam is John Jonny Doe |
Informatie tonen of vervangen op basis van een leeg veld of een lege waarde
Om een lege waarde te vervangen wordt de NOTNULL syntax gebruikt.
In een template kan dit als volgt worden gebruikt:
[<veld>|=NOTNULL|<tekst wanneer veld een waarde bevat >|<tekst wanneer veld leeg is >]
| Voorbeeld | Resultaat |
| [voornaam|=NOTNULL|[ voornaam], ontvang|Ontvang] een gratis kopje koffie. | — Wanneer waarde voornaam bekend is John, ontvang een gratis kop koffie. — Anders Ontvang een gratis kop koffie. |
| [voornaam|=NULL|Ontvang|[voornaam], ontvang] een gratis kopje koffie. | — Wanneer waarde voornaam bekend is John, ontvang een gratis kop koffie. — Anders Ontvang een gratis kop koffie. |
Een of meer waarden vervangen door HTML
Een waarde kan ook worden vervangen door HTML.
In een template wordt dit als volgt gebruikt:
[<veld>|<operator>|<if-case>|<else-case>]
| Voorbeeld | Resultaat |
| [Geslacht |=V| <div style=”color:#febeff”><strong>Nieuwe schoenen nodig?</strong><br />Kom langs en krijg 10% korting!</div> |=M| <div style=” color:#9ef0ff”><strong>We hebben ook herenkleding</strong><br />Kom langs en krijg 10% korting!</div> | <div style=” color:#085500;”><strong>10% Korting</strong><br />Kom onze nieuwe collectie bekijken!</div>] |
— Wanneer waarde geslacht is V Nieuwe schoenen nodig? Kom langs en krijg 10% korting! — Wanneer waarde geslacht is M We hebben ook herenkleding Kom langs en krijg 10% korting! — Anders 10% Korting Kom onze nieuwe collectie bekijken! |
Getal vervangen door waarde
Bij het vervangen van een getal kan een vergelijkingsoperator worden gebruikt (=, <>, <, <=, >=).
Het vervangen van een getal werkt op dezelfde manier als het vervangen van een waarde:
[<veld>|<operator>|<if-case>|<else-case>]
De if-else constructie is altijd een OR. Het is niet mogelijk om in meerdere groepen voor te komen. Wanneer een record aan de eerste waarde voldoet, wordt het uitgesloten bij de controle voor de tweede waarde.
| Voorbeeld | Resultaat |
| Ik ben [Leeftijd|<18|jong|oud] | — Als de waarde leeftijd jonger is dan 18 Ik ben jong — Anders Ik ben oud |
| Ik ben [Leeftijd|<18|jong|>=67|gepensioneerd|een volwassene] | — Als de waarde leeftijd jonger is dan 18 Ik ben jong — Als de waarde leeftijd 67 of ouder is Ik ben gepensioneerd — Anders Ik ben een volwassene |
| Ik [Leeftijd|<12|zit op de basisschool|<23|studeer|een volwassene] | — Als de waarde leeftijd jonger is dan 12 Ik zit op de basisschool — Als de waarde leeftijd jonger is dan 23, maar niet jonger dan 12 Ik studeer — Anders Ik ben een volwassene |
| [verjaardag|<01011990|Je bent oud genoeg|Je bent te jong] | — Als de waarde verjaardag voor 01-01-1990 is Je bent oud genoeg — Als de waarde verjaardag na 01-01-1990 is Je bent te jong |
Vervangen door lege waarde
Wanneer een waarde NULL of leeg is, kan deze worden vervangen door een standaardwaarde.
In een template wordt dit als volgt gebruikt:
[<veld>|<leeg>]
| Voorbeeld | Resultaat |
| Geachte [voornaam|heer/mevrouw], | — Waarde voornaam is John Geachte John, — Wanneer waarde voornaam is leeg Geachte heer/mevrouw, |
Tekst formattering
Ternair ondersteunt de volgende formatteringen. Namelijk lowercase, wordcase, Valuta en Replace:
Het is ook mogelijk om een variabele in een andere variabele te plaatsen.
| Functie | Voorbeeld | Resultaat |
| Lowercase | [voornaam] [tussenvoegsel|$|lowercase] [achternaam], ontvang een gratis kop koffie. | — Hans DE Boer Hans de Boer, ontvang een gratis kop koffie. |
| Wordcase | [voornaam|$|wordcase], ontvang een gratis kop koffie. | — hans Hans, ontvang een gratis kop koffie. |
| Valuta | Ontvang een gratis kop koffie t.w.v. €[prijs|$|valuta]
Ontvang een gratis koffiemachine t.w.v. €[prijs|$|valuta] |
— 2,5 Ontvang een gratis kop koffie t.w.v. €2,50— 1250 Ontvang een gratis koffiemachine t.w.v. €1.250 |
| Replace | [Aanhef|$|replace|Dhr.|De Heer|Mevr.|Mevrouw] [tussenvoegsel] [achternaam], ontvang een gratis kop koffie. | — dhr de Boer De Heer de Boer, ontvang een gratis kop koffie. |
| Date | [Geboortedatum|$|date|dd – MM – yyyy] | — 28 – 01 – 1987 |
| Formatting – date, EN culture | [GeboortedatumEN|$|date|en|dd – MM – yyyy] | — 28 – 01 – 1987 |
| Formatting – date with text | [Geboortedatum|$|date|dayname, day – month – year] | — Woe, 28 – 01 – 1987 |
| Trim | [voornaam|$|trim], ontvang een gratis kop koffie. | — Hans Hans, ontvang een gratis kop koffie. |
| FirstCharUp | [voornaam|$|FirstCharup], ontvang een gratis kop koffie. | — HANS Hans, ontvang een gratis kop koffie. |
Verwijzen naar andere velden
Binnen een variabele kan een verwijzing of vergelijking met een ander veld worden gemaakt.
Dit gebeurt op dezelfde manier als het vervangen van een getal of waarde door een if en else.
[<veld>|<operator>|<if-case>|<else-case>]
Het is ook mogelijk om een variabele in een andere variabele te plaatsen.
| Voorbeeld | Resultaat |
| Mijn naam is [bijnaam|@voornaam@] | Mijn naam is John |
| Mijn leeftijd is gelijk aan mijn geslacht: [leeftijd|=@geslacht@|dit is correct|dit is incorrect]] Verwijzing naar een ander veld in conditionele-waarde operatie |
— Als leeftijd is 17 en geslacht is M Mijn leeftijd is gelijk aan mijn geslacht: dit is incorrect |
| [leeftijd |<18|je bent @leeftijd@ jaar, helaas is dit te jong|>55|Je bent @leeftijd@ en overschrijdt de maximumleeftijd van 55|Je leeftijd van @leeftijd@ ligt tussen de leeftijdsgrenzen]. | — Als leeftijd is 17 U bent 17, helaas is dit te jong — Als waarde leeftijd is 25 Uw leeftijd van 25 is tussen de leeftijdsgrenzen — Als waarde leeftijd 59 is U bent 59 en overschrijdt de maximumleeftijd van 55 |
| [eventlijst|=TernairMasterClass |<p>Geachte [geslacht|=M|heer|=V|mevrouw|bezoeker],</p><p>Geweldig dat je naar de Ternair MasterClass komt.</p> |<p> Dear [gender|=M|sir|=F|madam|visitor],</p><p>De Ternair MasterClass is in januari, koop je nu je ticket.</p>] |
— Als waarde geslacht is M en actief op eventlijst met waarde TernairMasterClass Geachte heer, Geweldig dat je naar de Ternair MasterClass komt. — Als waarde geslacht is M en niet actief op eventlijst met waarde TernairMasterClass Geachte heer, De Ternair MasterClass is in januari, koop je nu je ticket. |
Lijsten tonen
Er zijn vijf mogelijkheden om een lijst te tonen.
In een template wordt deze als volgt gebruikt:
| [field|@|<between>] | [<field>|@|,] |
| [field|@|<before>|<after>] | [<field>|@|<p>|</p>] |
| [field|@|<before>|<after>|<empty>] | [<field>|@|<p>|</p>|no result] |
| [field|@|<before>|<between>|<betweenlast>|<after>] | [<field>|@||,|&|] [<field>|@|<li>|,|&|</li>] |
| [field|@|<before>|<between>|<betweenlast>|<after>|<empty>] | [<field>|@|<li>|,|&|</li>|<li>none</li>] [<field>|@|<li>|,|&|</li>|none] |
| @ | = Toon alle waarden |
| <before> | = Lijst item begint met |
| <between> | = Waarde tussen lijstitems |
| <betweenlast> | = Toon dit tussen de laatste twee waarden |
| <after> | = Lijst item eindigt met |
| <empty> | = Deze waarde wordt getoond wanneer een lijst geen waarden bevat |
Het is mogelijk om HTML van een variabele terug te sturen.
| Voorbeeld | Resultaat |
| We zijn actief in de branches [branche lijst|@|,] Gebaseerd op: [field|@|<between>] |
— Toon waarden gescheiden met, We zijn actief in de branches Accountancy, Fiscaal Recht, Prudentieel Advies, Kwaliteitsmanagement |
| Deze week zijn er [activiteitenlijst|@| | |geen activiteiten beschikbaar]. Gebaseerd op: [field|@|<before>|<after>|<empty>] |
— Toon wanneer geen waarde beschikbaar zijn Deze week zijn er geen activiteiten beschikbaar. |
| Deze week zijn er [activiteitenlijst|@|de volgende activiteiten:<br/>|,|&|.] Gebaseerd op: [field|@|<before>|<between>|<betweenlast>|<after>] |
–Toon waarden Deze week zijn er de volgende activiteiten: hockey, volleybal & bingo. |
| Onze werkweek bestaat uit werkweek|@|<li>|,<br/>|&|</li>|drukke dagen.] Gebaseerd op: [field|@|<before>|<between>|<betweenlast>|<after>|<empty>] |
— Toon waarde in een lijst Onze werkweek bestaat uit
— Toon wanneer geen waarde beschikbaar zijn |
Lijsten splitsen
Een string, kolom of veld kan meerdere waarden bevatten, gescheiden door een splitsingsteken. Deze kolom kan in het template worden gesplitst.
In een template wordt dit als volgt gebruikt:
[<veld>\<scheidingsteken>|@|<waarde>]
- <scheidingsteken> = veldnaam gevolgd door een \ en een teken.
- Scheidingstekens zijn: \, \; \_ \- \. \tab
- @ = Toon alle waarden
| Voorbeeld | Resultaat |
| Onze bakker verkoopt [voorraad\,|@| en ] | — Toon een lijst gescheiden door, Onze bakker verkoopt witbrood, volkorenbrood, roggebrood en meergranenbrood |
Eén item uit een lijst tonen
Het is mogelijk om één enkele waarde uit een lijst te tonen.
In een template wordt dit als volgt gebruikt:
[<veld>|#|<index>]
- # = Toon één waarde
- <index> = Vertegenwoordigt een item in de lijst
Index 1 is de eerste waarde, index 2 de tweede waarde, index 3 de derde waarde, enzovoort.
| Voorbeeld | Resultaat |
| De voorbereidingen begonnen in [lijst van maanden|#|1] | — Toon eerste waarde van de lijst De voorbereidingen begonnen in januari |
| Het evenement vindt plaats in [lijst van maanden|#|3] | — Toon derde waarde van de lijst Het evenement vindt plaats in maart |
Lijst bevat een waarde
Een tekst kan worden getoond op basis van de waarde van een string of veld.
In een template wordt dit als volgt gebruikt:
[veld|=<waarde>|<if-case>|<else-case>]
Meerdere if-cases kunnen worden gedefinieerd. Dit creëert een else-if effect.
| Voorbeeld | Resultaat |
| Ik heb [GamelijstTab\TAB |=level1|dit spel net pas gekocht |=level2|dit spel voor de helft uitgespeeld |=level3|dit spel bijna uitgespeeld |het spel nog niet gespeeld ]. |
— Als de waarde GamelijstTab niveau 3 is Ik heb dit spel bijna uitgespeeld. — Als geen waarden beschikbaar zijn Ik heb dit spel nog niet gespeeld. |
Waarde komt voor IN (als A of B dan xxx)
Het is mogelijk om een tekst te tonen op basis van meerdere waarden.
In een template wordt dit als volgt gebruikt:
[veld|in@<waarde>\\<scheidingsteken>|<if-case>|<else-case>]
Er kunnen meerdere waarde worden gebruikt, deze waarde worden gescheiden met het scheidingsteken dat achter de \\ wordt geplaatst.
Bijvoorbeeld: [field|in@<value>;<value>;<value>\\;|<if-case>|<else-case>]
| Voorbeeld | Resultaat |
| Beste bezoeker, <br/> [Status|in@besteld;verstuurd;onderweg\\; | Uw bestelling wordt verwerkt | Rond uw bestelling snel af en profiteer van onze speciale aanbiedingen ]. |
— Als waarde status is verstuurd Beste bezoeker, Uw bestelling wordt verwerkt. — Als waarde status is winkelen Beste bezoeker, Rond uw bestelling snel af en profiteer van onze speciale aanbiedingen. |
Operators
Beschikbare operators
Vergelijkingsoperator
| Symbool | Betekenis | Voorbeeld |
| = | Is gelijk aan | A1=B1 |
| > | Is groter dan | A1>B1 |
| < | Is kleiner dan | A1<B1 |
| >= | Is groter dan of gelijk aan | A1>=B1 |
| <= | Is kleiner of gelijk aan | A1<=B1 |
| <> | Is niet gelijk aan | A1<>B1 |
| Is leeg | Is leeg | |
| Is niet leeg | Is niet leeg | |
| In | In |
Niet-beschikbare operators
Rekenkundige operators en referentieoperators zijn niet beschikbaar.
Variabelen
Let op
- Variabelen zijn niet hoofdlettergevoelig
- In een selectie kan een datumveld gebruik maken van (verwijzen naar) de variabele ~rundate
Zie onderstaande tabel een overzicht van de beschikbare variabelen en waar ze gebruikt kunnen worden.
| E-mailblok | Exportblok | Instellingen | Globale instellingen | ||||
| Variabele | E-mail body | Export file name | FTP directory folder name | Template bevestigingsmail |
Tags | Trackers | Landingspagina’s |
| ~BlockDescription~ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| ~BlockNumber~ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| ~CampaignId~ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| ~CampaignCode~ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| ~CampaignDescription~ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| ~CampaignExternalReference~ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| ~EmailSubject~ | ✓ | ✓ | ✓ | ||||
| ~OfferCode~ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| ~SegmentCode~ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| ~SelectionId~ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| ~SelectionCode~ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| ~SelectionDescription~ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| ~SelectionExternalReference~ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| ~TID~ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
- Variabelen kunnen met tekst worden gecombineerd
| Voorbeeld |
| ~campaigncode~1 |
| test_~CampaignDescription~ |
