Tagsyntax: een tag zelf schrijven en een fallback geven

Een tag is een placeholder in een e-mail die bij het versturen wordt gevuld met de eigen gegevens van dat contact. Meestal typ je er geen zelf: je kopieert hem uit het paneel Tags in de editor en plakt hem in je tekst.

Dit artikel is voor de keren dat je er wel een typt, en om uit te zoeken waarom een tag leeg bleef of zichzelf liet zien in plaats van gevuld te worden.

Hoe een tag eruitziet

Een tag is een attribuutsleutel tussen dubbele accolades:

{{contact.firstname}}

De sleutel bestaat uit 2 delen, gescheiden door een punt: eerst de groep waar het attribuut bij hoort, dan het attribuut zelf. contact.firstname, contact.loyalty_balance, voucher.code, email_recipient.unsubscribe_url. Het paneel Tags is op dezelfde manier ingedeeld, dus de kop waaronder je kiest is het eerste deel van de sleutel.

Spaties binnen de accolades maken niet uit. {{contact.firstname}} en {{ contact.firstname }} zijn dezelfde tag. Het paneel voegt de versie zonder spaties in.

Een tag een fallback geven

Heeft een contact geen voornaam, dan wordt {{contact.firstname}} met niets gevuld en gaat er "Hi ," de deur uit. Een fallback is de tekst die we in plaats daarvan gebruiken als het attribuut voor dat contact leeg is:

Hi {{contact.firstname | fallback: there}},

Een contact met een voornaam krijgt "Hi Sarah,". Een contact zonder voornaam krijgt "Hi there,".

De fallback komt na een verticale streep (pipe), en alles na fallback: is de tekst, zonder de spaties eromheen. Er is geen knop voor. Je plakt de tag uit het paneel en typt de pipe en de fallback er zelf achter.

Wat er gebeurt als een tag niet wordt gevuld

Er kunnen drie dingen gebeuren, en door ze uit elkaar te houden vind je uit wat er misging.

De tag wordt gevuld. We herkennen de sleutel en dit contact heeft er een waarde voor.
De tag blijft leeg. We herkennen de sleutel, maar dit contact heeft er geen waarde voor en de tag heeft geen fallback. Daar is een fallback voor.
De tag laat zichzelf zien. De ontvanger ziet {{contact.frstname}}, met accolades en al. Dat betekent dat we de sleutel helemaal niet herkenden. Meestal is het een typfout, of een tag die niet werkt op de plek waar je hem hebt geplakt.

Dat laatste is bewust. We laten je liever de tag zien dan dat we hem stilletjes door niets vervangen, want niets is precies wat een contact zonder voornaam zou krijgen, en dan kun je de 2 niet meer van elkaar onderscheiden.

Een tag met een fallback toont de fallback in beide gevallen waarin het misgaat, dus een fallback vangt zowel een typfout als een lege waarde op. Dat is handig, maar het betekent ook dat een kapotte tag eruit kan zien alsof hij werkt. Test een tag een keer zonder fallback als je zeker wilt weten dat de sleutel klopt.

Tags voor je eigen aangepaste attributen

Aangepaste contactattributen krijgen ook tags, onder contact., opgebouwd uit de naam van het attribuut en niet uit het label dat je op het contactprofiel ziet. Die 2 zijn vaak verschillend, dus kopieer de tag uit het paneel Tags in plaats van hem samen te stellen uit wat je op je scherm ziet.

Is het attribuut een dropdown, dan wordt de tag gevuld met het label van de gekozen optie, niet met de waarde die erachter is opgeslagen. Attributen met een geüpload bestand of media krijgen geen tag.

De uitschrijflink is ook een tag

{{email_recipient.unsubscribe_url}} is de link waarmee een contact zich uitschrijft. Je vindt hem in het paneel Tags onder E-mail ontvanger, als Uitschrijflink.

Tenzij het abonnementstype van de e-mail functioneel is, heeft de e-mail de uitschrijflink of de link Abonnementsvoorkeuren nodig, en zonder een van de twee houden we het versturen tegen. Plak de tag zoals hij uit het paneel komt: een tag waar je een fallback aan hebt toegevoegd, telt voor deze controle niet mee.