[Manuale] Personalizzazione dei messaggi con contenuti dinamici (linguaggio per modelli Brevo)

Questo articolo illustra il metodo manuale per inserire le variabili. Se preferisci utilizzare il metodo Add variable (Aggiungi variabile) nella barra degli strumenti, consulta il nostro articolo dedicato Personalizzazione dei messaggi con contenuti dinamici (linguaggio per modelli Brevo).

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: ✅ Email ✅ SMS ✅ WhatsApp ✅ 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:

email_event-variables_json-example_en-us.png

data è l'oggetto radice contenente le seguenti proprietà:

  • id → ID del carrello
  • total → importo totale del carrello
  • valuta → tipo di valuta
  • url → URL del carrello
  • elementi è un array di prodotti nel carrello, ciascuno contenente le seguenti proprietà:
    • nome → nome del prodotto
    • prezzo → prezzo del prodotto
    • url → URL della pagina del prodotto
    • immagine → URL dell'immagine del prodotto
💡 Buono a sapersi

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: 

⏫ Dati memorizzati direttamente sotto l'oggetto radice

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
↪️ Dati accessibili da un array sotto l'oggetto radice

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

💡 Buono a sapersi
Ciò risulta particolarmente utile quando il numero di elementi nell'array è sconosciuto, ad esempio una lista di post settimanali del blog o una ricevuta per i prodotti acquistati.

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: ✅ Email ✅ SMS ✖️ WhatsApp ✖️ 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:

datafeed_valid-manually_en-us.png

A seconda della complessità della struttura del feed di dati, il formato varia:

⏫ Dati memorizzati direttamente sotto l'oggetto radice

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
↪️ Dati accessibili da un array sotto l'oggetto radice

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

💡 Buono a sapersi
Ciò risulta particolarmente utile quando il numero di elementi nell'array è sconosciuto, ad esempio una lista di post settimanali del blog o una ricevuta per i prodotti acquistati.

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: ✅ Email ✅ SMS ✖️ WhatsApp ✖️ 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à.

product-feed-example.png

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 black-yoga-mat.png
{{ 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

💡 Buono a sapersi
Ciò risulta particolarmente utile quando il numero di elementi nell'array è sconosciuto, ad esempio una lista di post settimanali del blog o una ricevuta per i prodotti acquistati.

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)
✖️ WhatsApp ✖️ 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:

Dati dell'oggetto

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
Dati dell'oggetto associato

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

💡 Buono a sapersi
Ciò risulta particolarmente utile quando il numero di elementi nell'array è sconosciuto, ad esempio una lista di post settimanali del blog o una ricevuta per i prodotti acquistati.

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: ✅ Email ✅ SMS ✖️ WhatsApp ✖️ 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: ✅ Email ✖️ SMS ✖️ WhatsApp ✖️ 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:

📢 Istruzioni condizionali

Disponibili per: ✅ Email ✖️ SMS ✖️ WhatsApp ✖️ 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: ✅ Email ✅ SMS ✖️ WhatsApp ✖️ 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.

💬 Questo articolo ti è stato utile?

Utenti che ritengono sia utile: 25 su 162