MailingCore
DocumentazioneVariabili nei template

Variabili nei template

Sintassi {{var}}, unsubscribeUrl e variabili dichiarate.

Usa segnaposto in HTML e oggetto. All'invio, MailingCore li sostituisce con valori dal payload o URL generati dal sistema.

Sintassi

Doppie parentesi graffe, case-sensitive:

<p>Ciao {{firstName}},</p>
<p>Il tuo ordine {{orderId}} parte il {{shipDate}}.</p>

Dichiara variabili sulla versione (array variables) per editor e validazione:

{
  "name": "firstName",
  "type": "string",
  "fallback": "amico"
}

Tipi supportati: string, number, boolean, url, email, image, color.

Variabile di sistema: {{unsubscribeUrl}}

Per email newsletter e campagne, includi link di disiscrizione con un clic:

<a href="{{unsubscribeUrl}}">Annulla iscrizione</a>

MailingCore genera un URL firmato per destinatario (/u/:token). La pagina ospitata supporta ?lang= per testi localizzati (unsubscribeLang su invio o campagna).

Passare valori all'invio

Negli invii transazionali con templateVersionId, passa variabili in metadata o campi supportati. Nelle campagne, mappa campi contatto (es. firstName dagli attributi) nella configurazione campagna.

Pattern comuni:

PatternEsempio
Saluto{{firstName}} con fallback "amico"
Deep link{{ctaUrl}} tipo url
Footer disiscrizione{{unsubscribeUrl}} in ogni template marketing
Colore brand{{brandColor}} tipo color

Buone pratiche

  1. Dichiara tutte le variabili custom con fallback sensati.
  2. Includi sempre {{unsubscribeUrl}} nei template marketing (requisito legale in molte giurisdizioni).
  3. Evita JavaScript o logica nei template — calcola valori nell'app prima dell'invio.
  4. Nomi alfanumerici (firstName, order_id).

Correlati