Naar de hoofdinhoud

Variabelen gebruiken

Gebruik de beschikbare e-mailvariabelen met de exacte syntaxis en het juiste gegevenstype.

Geschreven door Lars Hurkmans

Wat variabelen doen

Een variabele, ook wel merge-tag genoemd, is een vaste tag die MarktMentor bij het verwerken van een e-mail vervangt door beschikbare gegevens. Gebruik de tag exact zoals deze in dit artikel staat.

Iedere tag heeft twee openingsaccolades en twee sluitingsaccolades, zonder spaties binnen de accolades. Wijzig ook hoofdletters, underscores en punten niet.

Goed: {{customer.firstName}}

Fout: {{ customer.firstName }}

Fout: {{customer.firstname}}

Zet geen hekje voor een tag. Neem iedere tag exact over zoals die in de tabel staat.

De kiezer en handmatig typen

De variabelenkiezer in de e-maileditor toont niet alle tags uit de lijst hieronder. Ontbreekt een tag in de kiezer, dan kun je deze exact en zonder extra spaties handmatig typen.

Let bij de groep Klant extra op E-mail. Deze keuze kan momenteel {{company.email}} invoegen. Wil je het e-mailadres van de klant gebruiken, typ dan handmatig {{customer.email}}. Controleer de ingevoegde tag voordat je de template opslaat.

Beschikbare variabelen

Bedrijfsgegevens

Variabele

Type

Betekenis

{{company.name}}

Tekst

Bedrijfsnaam

{{company.address}}

Tekst

Bedrijfsadres

{{company.zipCode}}

Tekst

Postcode

{{company.city}}

Tekst

Stad

{{company.country}}

Tekst

Land

{{company.email}}

Tekst

E-mailadres van het bedrijf

{{company.vatNumber}}

Tekst

Btw-nummer

{{company.companyNumber}}

Tekst

Bedrijfs- of registratienummer

Klantgegevens

Variabele

Type

Betekenis

{{customer.firstName}}

Tekst

Voornaam

{{customer.lastName}}

Tekst

Achternaam

{{customer.email}}

Tekst

E-mailadres van de klant

Factuur- en bestelgegevens

Variabele

Type

Betekenis

{{date}}

Tekst

Huidige datum

{{order.date}}

Tekst

Besteldatum

{{order.order_id}}

Tekst

Ordernummer

{{invoice.total_excl_tax}}

Tekst

Factuurtotaal exclusief btw

{{invoice.total_incl_tax}}

Tekst

Factuurtotaal inclusief btw

Factuuradres van de klant

Variabele

Type

Betekenis

{{customer.billing_details.address}}

Tekst

Factuuradres

{{customer.billing_details.zipCode}}

Tekst

Postcode van het factuuradres

{{customer.billing_details.city}}

Tekst

Stad van het factuuradres

{{customer.billing_details.country}}

Tekst

Land van het factuuradres

Verzendadres van de klant

Variabele

Type

Betekenis

{{customer.shipping_details.address}}

Tekst

Verzendadres

{{customer.shipping_details.zipCode}}

Tekst

Postcode van het verzendadres

{{customer.shipping_details.city}}

Tekst

Stad van het verzendadres

{{customer.shipping_details.country}}

Tekst

Land van het verzendadres

Productgegevens

Variabele

Type

Betekenis en gebruik

{{product.title}}

Tekst

Producttitel; gebruik zonder extra #.

{{product.ean}}

Tekst

EAN van het product

{{product.review_url}}

URL

Link naar de reviewpagina; gebruik als linkdoel.

{{product.image}}

Afbeeldings-URL

URL van de productafbeelding; gebruik alleen als src van een afbeeldingselement.

{{product.image}} is dus geen afbeeldingselement en toont niet zelfstandig een afbeelding. Een tekstueel HTML-voorbeeld is: <img src="{{product.image}}" alt="{{product.title}}">.

Een variabele in de e-mailtekst invoegen

  1. Open de gewenste e-mailtemplate.

  2. Klik in de editor op het tekstblok waarin de variabele moet komen.

  3. Zet de cursor op de juiste plaats.

  4. Open de variabelenkiezer van het tekstblok.

  5. Kies de gewenste groep en daarna de variabele. Ontbreekt de gewenste tag, typ deze dan exact handmatig.

  6. Controleer of de ingevoegde tag exact overeenkomt met de tabel hierboven.

  7. Sla de template op en stuur een testmail om de opmaak te controleren.

Ontbrekende brongegevens kunnen een lege of vervangende waarde geven. Een testmail kan bovendien voorbeeldgegevens gebruiken. Controleer daarom niet alleen de tag, maar ook of de benodigde gegevens voor de gekozen bestelling beschikbaar zijn.

Een variabele in het onderwerp gebruiken

Het onderwerpveld heeft geen variabelenkiezer. Typ de tag daar handmatig en exact. Bijvoorbeeld:

Bestelling {{order.order_id}} van {{company.name}} via bol.com

Gebruik ook in het onderwerp geen extra spaties binnen de accolades. Een fout gespelde of anders gespatieerde tag wordt niet automatisch genormaliseerd.

URL's correct gebruiken

  • Gebruik {{product.review_url}} als linkdoel van gekoppelde tekst of een knop.

  • Gebruik {{product.image}} alleen als bron-URL van een afbeeldingselement.

  • Gebruik {{product.title}} als gewone tekst of als alternatieve tekst; voeg geen # toe.

Sla de template na iedere wijziging op en controleer de uitvoer met een testmail. Een testmail is een controle van de template en geen garantie voor de gegevens van een latere live e-mail.

Was dit een antwoord op uw vraag?