Utilizza il linguaggio per modelli Brevo per personalizzare i tuoi messaggi con dati specifici del contatto o dell'evento, nascondere o mostrare il contenuto a destinatari specifici e modificare la formattazione dei valori nei tuoi messaggi.
💬 Variabili
Le variabili, note anche come segnaposto o merge tag, sono tag che puoi inserire nei tuoi messaggi per personalizzarli. Quando invii un messaggio, ogni variabile viene sostituita automaticamente con le informazioni del contatto corrispondente.
Le variabili devono essere racchiuse tra doppie parentesi graffe, come {{ ... }} o {{...}}. Possono essere utilizzate per inserimenti semplici o combinate con istruzioni condizionali e filtri per la personalizzazione avanzata.
| Tipo di variabile | Caso d'uso |
|---|---|
| 👤 Variabili di contatto | Attributi statici del contatto (nome, email…) |
| ⚡ Variabili di evento | Dati da un’azione trigger |
| 🛢️ Variabili di feed di dati | Dati in tempo reale da una fonte esterna |
| 🛒 Variabili di feed di prodotto | Elenchi dinamici di prodotti |
| 📦 Variabili oggetto | Attributi degli oggetti personalizzati |
| 📅 Variabili di data | Timestamp inviato |
| 🔗 Variabili di link e anteprima dell'email | Link a versione speculare, annullamento dell'iscrizione, aggiornamento del profilo e double opt-in |
👤 Variabili di contatto
| Disponibili per: | ✅ SMS | ✅ Push |
La sintassi è {{ contact.ATTRIBUTE }}, dove dovresti sostituire ATTRIBUTE (attributo) con il nome esatto dell'attributo del contatto, come appare nella pagina Attributi del contatto. Sono supportati sia gli attributi predefiniti sia gli attributi personalizzati.
Ad esempio:
| Input | Descrizione | Output |
|---|---|---|
| {{ contact.EMAIL }} | Indirizzo email (predefinito) | abby@the-green-yoga.com |
| {{ contact.FIRSTNAME }} | Nome (predefinito) | Abby |
| {{ contact.SMS }} | Numero di telefono (predefinito) | +12152688872 |
| {{ contact.LANGUAGE }} | Lingua (personalizzata) | Inglese |
➡️ Per ulteriori informazioni, consulta i nostri articoli dedicati:
⚡ Variabili di evento
| Disponibili per: | ✅ Email (solo se attivato) |
✅ SMS (solo se attivato) |
✅ WhatsApp (solo se attivato) |
✖️ Push |
Le variabili di evento consentono di visualizzare i dati relativi a eventi specifici generati dalle azioni di un contatto, come il prezzo dell'ultimo articolo acquistato o il nome della riunione che ha prenotato.
Per identificare le variabili disponibili, controlla la tua chiamata API o i log di eventi in Brevo. Gli esempi qui sotto si basano sulla seguente struttura JSON:
|
data è l'oggetto radice contenente le seguenti proprietà:
|
L'oggetto radice (data sopra) è obbligatorio. Tutte le altre proprietà sono opzionali e possono essere denominate secondo necessità.
A seconda di dove sono archiviati i tuoi dati nella struttura JSON, la sintassi varia:
I dati archiviati direttamente sotto l'oggetto radice contengono in genere i dettagli chiave dell'evento, ad esempio le informazioni sul carrello, e possono essere recuperati senza dover scorrere gli array.
La sintassi è {{ params.property }}, dove dovresti sostituire proprietà con il nome esatto della proprietà sotto l'oggetto radice nella tua struttura JSON.
Data la struttura JSON sopra:
| Input | Descrizione | Output |
|---|---|---|
| {{ params.id }} | ID del carrello | carrello:1234 |
| {{ params.total }} | Totale del carrello | 280 |
| {{ params.currency }} | Valuta del carrello | USD |
| {{ params.url }} | URL del carrello | http://www.example.com |
Gli array archiviati sotto l'oggetto radice, come l'array items sopra, possono contenere più elementi, ciascuno con le proprie proprietà. Usa l’indicizzazione per fare riferimento a elementi specifici oppure un ciclo for per iterare su tutti.
Usa l'indicizzazione per fare riferimento a elementi specifici
La sintassi per l’indicizzazione è {{ params.array.index.property }}, dove devi sostituire ogni segnaposto come segue:
- array con il nome esatto dell'array sotto l'oggetto radice nella tua struttura JSON.
- indice con la posizione dell'elemento che vuoi fare riferimento, partendo da 0 per il primo elemento.
- proprietà con il nome esatto della proprietà all'interno dell'elemento dell'array nella tua struttura JSON.
Data la struttura JSON sopra:
| Input | Descrizione | Output |
|---|---|---|
| {{ params.items.0.name }} | Nome del primo elemento | Scarpe nere |
| {{ params.items.1.name }} | Nome del secondo elemento | Camicia bianca |
Utilizza un ciclo for per scorrere tutti gli elementi
La sintassi con un ciclo for è {% for item in params.array %} {{ item.property }} {% endfor %}, dove devi sostituire ogni segnaposto come segue:
- array con il nome esatto dell'array sotto l'oggetto radice nella tua struttura JSON.
- proprietà con il nome esatto della proprietà all'interno dell'elemento dell'array nella tua struttura JSON.
Data la struttura JSON sopra:
| Input | Descrizione | Output |
|---|---|---|
|
{% for item in params.items %} {{ item.name }} {% endfor %} |
Tutti i nomi degli elementi |
Scarpe nere Camicia bianca |
➡️ Per ulteriori informazioni sui cicli for, consulta il nostro articolo dedicato [Manuale] Ripetizione di un blocco di elementi nelle email utilizzando i cicli for.
🛢️ Variabili di feed di dati
| Disponibili per: | ✅ SMS | ✖️ Push |
Le variabili feed di dati ti permettono di inserire dati in tempo reale da una fonte esterna o da un’API direttamente nei tuoi messaggi. Per identificare le variabili disponibili, vai su Settings (Impostazioni) > Data management (Gestione dati) > Data feeds (feed di dati) e verifica la struttura del tuo file di origine:
A seconda della complessità della struttura del feed di dati, il formato varia:
I dati archiviati direttamente sotto l’oggetto radice di solito contengono l’entità più rilevante e immediata nel tuo feed, ad esempio il prossimo evento in arrivo o il prodotto più recente, e possono essere recuperati senza dover scorrere gli array.
La sintassi è {{ feed.feedalias.variable }}, dove devi sostituire ciascun segnaposto come segue:
- feedalias con il nome esatto dell'alias del tuo feed di dati, rispettando l'ortografia e le maiuscole/minuscole così come appaiono nella pagina Feed di dati.
- variable con la variabile specifica o il nome del campo che desideri visualizzare.
Dato il feed di dati sopra:
| Input | Descrizione | Output |
|---|---|---|
| {{ feed.next_yoga_class.class_name }} | Nome della classe | Sunrise Vinyasa |
| {{ feed.next_yoga_class.studio_location }} | Sede dello studio | Downtown Studio |
| {{ feed.next_yoga_class.date }} | Data del corso | 2025-03-07 |
| {{ feed.next_yoga_class.time }} | Orario della lezione | 06:30 |
Gli array archiviati sotto l'oggetto radice possono contenere più elementi, ciascuno con le proprie proprietà. Usa l'indicizzazione per fare riferimento a elementi specifici o un ciclo for per iterare su tutti.
Usa l'indicizzazione per fare riferimento a elementi specifici
La sintassi per l’indicizzazione è {{ feed.feedalias.array.index.variable }}, dove devi sostituire ogni segnaposto come segue:
- feedalias con il nome esatto dell'alias del tuo feed di dati, rispettando l'ortografia e le maiuscole/minuscole così come appaiono nella pagina Feed di dati.
- array con il nome dell'array che contiene i valori per ciascun elemento.
- indice con la posizione dell'elemento specifico che desideri visualizzare, partendo da 0 per il primo elemento.
- variabile con il nome specifico della variabile o del campo che vuoi visualizzare, ad esempio nome, prezzo o data.
Dato il feed di dati sopra:
| Input | Descrizione | Output |
|---|---|---|
| {{ feed.yoga_classes.following_classes.0.class_name }} | Nome della prima lezione | Power Flow Yoga |
| {{ feed.yoga_classes.following_classes.1.class_name }} | Nome della seconda lezione | Serata rivitalizzante |
Utilizza un ciclo for per scorrere tutti gli elementi
La sintassi con un ciclo for è {% for item in feed.feedalias.array %} {{ item.variable }} {% endfor %}, dove devi sostituire ogni segnaposto come segue:
- feedalias con il nome esatto dell'alias del tuo feed di dati, rispettando l'ortografia e le maiuscole/minuscole così come appaiono nella pagina Feed di dati.
- array con il nome dell'array che contiene i valori per ciascun elemento.
- variabile con il nome specifico della variabile o del campo che vuoi visualizzare, ad esempio nome, prezzo o data.
Dato il feed di dati sopra:
| Input | Descrizione | Output |
|---|---|---|
|
{% for item in feed.yoga_classes.following_classes %} {{ item.class_name }} {% endfor %} |
Tutti i nomi delle lezioni |
Power Flow Yoga Serata rivitalizzante Hatha Yoga base Yin Yoga e meditazione ... |
➡️ Per ulteriori informazioni sui cicli for, consulta il nostro articolo dedicato [Manuale] Ripetizione di un blocco di elementi nelle email utilizzando i cicli for.
🛒 Variabili di feed di prodotto
| Disponibili per: | ✅ SMS | ✖️ Push |
Le variabili di feed di prodotto ti consentono di visualizzare una lista dinamica di prodotti del tuo negozio online, inclusi dettagli come nome, descrizione, prezzi, immagini e disponibilità.
La sintassi è {{ feed.feedalias.products.variable }}, dove devi sostituire ciascun segnaposto come segue:
- feedalias è il nome alias esatto del tuo feed di prodotto in modo che l'ortografia e le lettere maiuscole/minuscole corrispondano a ciò che appare nella pagina Product feeds (Feed di prodotto).
- variable con il nome del campo che vuoi visualizzare.
Dato il feed di prodotto sopra:
| Input | Descrizione | Output |
|---|---|---|
| {{ feed.mats_bestseller.products.imageUrl }} | Immagine del prodotto | |
| {{ feed.mats_bestseller.products.name }} | Nome del prodotto | Tappetino da yoga antiscivolo - 6 mm |
| {{ feed.mats_bestseller.products.url }} | URL del prodotto | https://thegreenyoga.com/non-slip/black-mat.html |
Utilizza un ciclo for per scorrere tutti gli elementi
La sintassi con un ciclo for è {% for item in feed.feedalias.products %} {{ item.variable }} {% endfor %}, dove devi sostituire ogni segnaposto come segue:
- feedalias con il nome esatto dell'alias del tuo feed di dati, rispettando l'ortografia e le maiuscole/minuscole così come appaiono nella pagina Feed di dati.
- variabile con il nome specifico della variabile o del campo che vuoi visualizzare, ad esempio nome, prezzo o data.
Dato il feed di prodotto sopra:
| Input | Descrizione | Output |
|---|---|---|
|
{% for item in feed.mats_bestseller.products %} {{ item.name }} {% endfor %} |
Tutti i nomi dei prodotti |
Tappetino da yoga antiscivolo - 6 mm Blocco yoga - 4 pollici Pantaloni da yoga a gamba larga e vita alta |
➡️ Per ulteriori informazioni sui cicli for, consulta il nostro articolo dedicato [Manuale] Ripetizione di un blocco di elementi nelle email utilizzando i cicli for.
📦 Variabili oggetto
| Disponibili per: | ✅ Email (solo automazione) |
✅ SMS (solo automazione) |
✖️ Push |
Le variabili degli oggetti ti permettono di includere nei tuoi messaggi i dettagli sui tuoi oggetti personalizzati o sugli oggetti associati. Possono essere utilizzati solo nelle automazioni, poiché si basano su un record oggetto specifico come trigger dell’automazione.
Per creare variabili oggetto, ti serviranno il nome dell'oggetto e gli ID degli attributi dalla pagina Impostazioni oggetti personalizzati. A seconda dei dati che vuoi visualizzare, la sintassi varia:
Le variabili dei dati degli oggetti ti permettono di visualizzare gli attributi del record dell’oggetto personalizzato che ha usato il trigger l’automazione, come l’importo di un preventivo o la data di creazione.
La sintassi è {{ feed.object.attributes.variable }}, dove devi sostituire ciascun segnaposto come segue:
- oggetto con il nome singolare del tuo oggetto personalizzato come definito quando lo hai creato.
- variabile con l' ID attributo che vuoi visualizzare, ad es. nome, importo o data. Puoi trovare gli ID degli attributi cliccando sul nome dell'oggetto dalla pagina Custom objects settings (Impostazioni oggetti personalizzati).
Dato un oggetto quota con gli attributi importo, data, id_preventivo e pagato:
| Input | Descrizione | Output |
|---|---|---|
| {{ feed.quote.attributes.amount }} | Importo del preventivo | 350 |
| {{ feed.quote.attributes.date }} | Data di creazione del preventivo | 2025-03-29T00:04:11+00:00 |
| {{ feed.quote.attributes.paid }} | Stato del pagamento | vero |
| {{ feed.quote.attributes.id_quote }} | ID preventivo | OQPPBDCSSZQ9 |
Le variabili di dati dell'oggetto associato ti consentono di visualizzare gli attributi degli oggetti collegati all'oggetto personalizzato che ha attivato l'automazione. Usa l’indicizzazione per fare riferimento a record specifici oppure un ciclo for per iterare su tutti.
Usa l'indicizzazione per fare riferimento a elementi specifici
La sintassi per l’indicizzazione è {{ feed.object.associations.associatedobject.index.variable }}, in cui devi sostituire ogni segnaposto come segue:
- oggetto con il nome singolare del tuo oggetto personalizzato come definito quando lo hai creato.
- associatedobject con il nome singolare del tuo oggetto associato che trovi nella scheda Associations (Associazioni) quando selezioni un oggetto personalizzato dalla pagina Impostazione degli oggetti personalizzati.
- indice con la posizione del record oggetto associato che vuoi visualizzare, partendo da 0 per il primo record.
- variabile con l' ID attributo che vuoi mostrare, che trovi nella scheda Associations (Associazioni) quando selezioni un oggetto personalizzato dalla pagina Impostazioni oggetti personalizzati.
Dato un oggetto preventivo associato ai record veicolo contenenti un attributo marca:
| Input | Descrizione | Output |
|---|---|---|
| {{ feed.quote.associations.vehicle.0.brand }} | Marca del primo veicolo | Renault |
| {{ feed.quote.associations.vehicle.1.brand }} | Seconda marca del veicolo | Toyota |
Utilizza un ciclo for per scorrere tutti gli elementi
La sintassi con un ciclo for è {% for item in feed.object.associations.associatedobject %} {{ item.variable }} {% endfor %}, dove devi sostituire ogni segnaposto come segue:
- oggetto con il nome singolare del tuo oggetto personalizzato come definito quando lo hai creato.
- associatedobject con il nome singolare del tuo oggetto associato che trovi nella scheda Associations (Associazioni) quando selezioni un oggetto personalizzato dalla pagina Impostazione degli oggetti personalizzati.
- variabile con l' ID attributo che vuoi mostrare, che trovi nella scheda Associations (Associazioni) quando selezioni un oggetto personalizzato dalla pagina Impostazioni oggetti personalizzati.
Dato un oggetto preventivo associato ai record veicolo contenenti un attributo marca:
| Input | Descrizione | Output |
|---|---|---|
|
{% for item in feed.quote.associations.vehicle %} {{ item.brand }} {% endfor %} |
Marca di tutti i record dei veicoli associati |
Renault Toyota Audi ... |
➡️ Per ulteriori informazioni sui cicli for, consulta il nostro articolo dedicato [Manuale] Ripetizione di un blocco di elementi nelle email utilizzando i cicli for.
📅 Variabili di data
| Disponibili per: | ✅ SMS | ✖️ Push |
Inserisce un timestamp con la data e l’ora esatte in cui il messaggio è stato inviato, in base al fuso orario del tuo account Brevo. Per impostazione predefinita usa UTC se non è impostato alcun fuso orario.
La sintassi è {{ time_now }}.
Ad esempio:
| Input | Descrizione | Output |
|---|---|---|
| Oggi è {{ time_now }} | Timestamp completo | Oggi è 2025-03-11 15:10:20.823713502 +0100 CET |
| Oggi è {{ time_now |date:"Monday, Jan 2, 2006" }} | Data formattata utilizzando il filtro date | Oggi è martedì, 11 mar 2025 |
➡️ Per ulteriori informazioni sulla modifica della formattazione delle date, consulta il nostro articolo dedicato Modifica della formattazione dei segnaposto con i filtri.
🔗 Variabili di link e anteprima dell'email
| Disponibili per: | ✖️ SMS | ✖️ Push |
Inserisci queste variabili all'interno di un tag HTML <a> per consentire al destinatario di visualizzare la tua email in un browser, annullare l'iscrizione o gestire le preferenze.
Sono disponibili le seguenti variabili di link e anteprima dell'email:
| Input | Descrizione | Output |
|---|---|---|
| <a href="{{ mirror }}">Visualizza nel browser</a> | Mirror link | Visualizza nel browser |
| Se non vuoi più <a href="{{ unsubscribe }}">Disiscriverti</a> | Link di disiscrizione | Disiscriviti |
| <a href="{{ update_profile }}">Aggiorna le tue preferenze</a> | Link per l’aggiornamento del profilo | Aggiorna le tue preferenze |
| <a href="{{ doubleoptin }}">Confermo la mia iscrizione</a> | Link per il double opt-in | Confermo la mia iscrizione |
➡️ Per ulteriori informazioni, consulta i nostri articoli dedicati:
- Inserimento di un link "Visualizza nel browser" nelle campagne
- Inserimento di un link di disiscrizione nelle campagne
- Aggiornamento dei dettagli e delle preferenze dei contatti (modulo di aggiornamento del profilo)
- Creazione di un modello di email a doppio opt-in (DOI) personalizzato per un modulo di iscrizione creato in Brevo
📢 Istruzioni condizionali
| Disponibili per: | ✖️ SMS | ✖️ Push |
Visualizzazione condizionale (istruzioni if)
Utilizza un'istruzione if per mostrare o nascondere parti della tua email in base ai dati di ciascun destinatario.
➡️ Per ulteriori informazioni sulle istruzioni if, consulta il nostro articolo dedicato [Manuale] Come mostrare o nascondere il contenuto nelle email utilizzando le istruzioni if.
Sezioni ripetibili (per cicli)
Utilizza un ciclo per visualizzare in modo dinamico tutti gli elementi di un array, senza fare riferimento manualmente a ogni indice.
➡️ Per ulteriori informazioni sui cicli for, consulta il nostro articolo dedicato [Manuale] Ripetizione di un blocco di elementi nelle email utilizzando i cicli.
🪄 Filtri
| Disponibili per: | ✅ SMS | ✖️ Push |
I filtri modificano l’output di una variabile e vengono inseriti tra le doppie parentesi, separati da una barra verticale |. È possibile concatenare più filtri.
Ad esempio:
| Input | Descrizione | Output |
|---|---|---|
| {% for item in feed.yoga_classes.following_classes|slice:'0:3' %} | Limita il numero di elementi da visualizzare in un ciclo for |
Power Flow Yoga Serata rivitalizzante Hatha Yoga base |
| {{ contact.FIRSTNAME|upper }} | Converte il nome del destinatario in maiuscolo (in origine: Abby). | ABBY |
| {{ params.TOTAL|floatformat:2 }} | Mostra il totale del carrello con due cifre decimali (in origine: 49,995). | 49,99 |
| {{ time_now|date:"02/01/2006" }} | Formatta la data corrente come dd/MM/yyyy (in origine: 2025-03-11 15:10:20.823713502 +0100 CET). | 11/03/2025 |
➡️ Per ulteriori informazioni, consulta il nostro articolo dedicato Modifica della formattazione dei segnaposto con i filtri.
🤔 Domande?
In caso di domande, non esitare a contattare il team dell’assistenza creando un ticket dal tuo account. Se ancora non hai un account, puoi contattarci qui.
Se stai cercando aiuto per un progetto che prevede l'utilizzo di Brevo, possiamo metterti in contatto con l'agenzia partner di Brevo giusta per te.