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.

Nel linguaggio per modelli Brevo, 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.

Il linguaggio per modelli Brevo supporta diversi tipi di variabili:

👤 Variabili di contatto

Le variabili di contatto ti consentono di visualizzare i dati dei tuoi attributi di contatto, ad esempio il nome di un contatto, nei tuoi messaggi. Queste variabili sono formattate come {{ contact.ATTRIBUTE }}, dove dovresti sostituire ATTRIBUTE con il nome esatto del tuo attributo di contatto, come visualizzato nella pagina Contact attributes (Attributi dei contatti) nel tuo account Brevo. Puoi utilizzare sia gli attributi predefiniti di Brevo sia gli attributi personalizzati.

Ecco alcuni esempi di variabili di contatto con tre attributi predefiniti di Brevo e un attributo personalizzato:

➡️ Per ulteriori informazioni sui diversi tipi di attributi dei contatti disponibili e su come crearne di personalizzati, consulta i nostri articoli dedicati:

• Informazioni sugli attributi dei contatti
• Creazione e gestione degli attributi dei contatti

🔗 Variabili di link e anteprima dell'email

Le variabili di link e anteprima dell'email consentono ai destinatari di visualizzare la tua email nel proprio browser, disiscriversi dalle tue comunicazioni e gestire le proprie preferenze. Queste variabili devono essere inserite all'interno di un tag HTML <a>, racchiudendo il testo che verrà visualizzato nell'email.

Sono disponibili le seguenti variabili di link e anteprima dell'email:

➡️ 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

📅 Variabili di data

Le variabili di data ti consentono di inserire un timbro della data e dell'ora esatte in cui è stata inviata un'email. La data si basa sul fuso orario del tuo account Brevo. Se nel tuo account non è impostato alcun fuso orario, la variabile utilizzerà per impostazione predefinita il timbro data/ora corrente in UTC. 

È disponibile la seguente variabile di data:

➡️ Per ulteriori informazioni sulla modifica della formattazione delle date, consulta il nostro articolo dedicato Modifica della formattazione dei segnaposto con i filtri.

⚡ Variabili di evento

Le variabili di evento ti consentono di visualizzare i dati di eventi specifici attivati dalle azioni di un contatto, ad esempio il prezzo dell'ultimo articolo acquistato o il nome dell'appuntamento prenotato.

Per identificare le variabili di evento per il tuo messaggio, controlla la tua chiamata API o il log di eventi in Brevo. Di seguito è riportato un esempio di una tipica struttura JSON, in cui:

data è l'oggetto radice contenente le seguenti proprietà: id → ID del carrello total → Importo totale del carrello currency → Tipo di valuta url → Link al carrello items è un array di prodotti nel carrello, ciascuno contenente le seguenti proprietà: name → Nome del prodotto price → Prezzo del prodotto url → URL della pagina del prodotto image → URL dell'immagine del prodotto

Le variabili di evento sono formattate utilizzando doppie parentesi graffe. Ciascun dato nella struttura JSON può essere incluso in una variabile di evento per personalizzare i messaggi:

{% for item in params.items %}
{{ item.name }}
{% endfor %}

🛢️ Variabili di feed di dati

Le variabili di feed di dati di Brevo ti consentono di personalizzare le tue comunicazioni di marketing inviate tramite Brevo con le informazioni più recenti su prodotti, clienti, eventi o qualsiasi altro dato rilevante dalla tua origine dati esterna o API. Utilizzale per automatizzare e personalizzare i tuoi messaggi con dati in tempo reale. 

Per identificare le variabili di feed di dati per il tuo messaggio, clicca sul menu a discesa dell'account e seleziona Settings (Impostazioni) > Data management (Gestione dati) > Data feeds (Feed di dati) per verificare la struttura del tuo file di origine su Brevo:

Le variabili di feed di dati sono formattate utilizzando doppie parentesi graffe. A seconda della complessità della struttura del feed di dati, il formato delle variabili di feed di dati varia: 

{% for item in feed.yoga_classes.following_classes %}
{{ item.class_name }}
{% endfor %}

🛒 Variabili di feed di prodotto

Le variabili di feed di prodotto ti consentono di visualizzare una lista dinamica di prodotti del tuo negozio online, facilitando la creazione di consigli personalizzati. Contengono i dettagli del prodotto, ad esempio nome, descrizione, prezzi, immagini e disponibilità. Utilizzale per presentare gli articoli più popolari, personalizzare i consigli o mantenere una visualizzazione coerente dei prodotti nelle tue campagne di marketing.

Le variabili di feed di prodotto sono formattate utilizzando doppie parentesi graffe:

{{ feed.feedalias.products.variable }}

Quindi, devi sostituire:

• 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 è il nome del campo nell'API che contiene i dati che desideri recuperare.

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}}	Link al prodotto	https://thegreenyoga.com/non-slip/black-mat.html

Visualizzazione di tutti gli elementi utilizzando un ciclo for

Utilizza un ciclo for per visualizzare in modo dinamico tutti gli elementi di un array. Anziché fare riferimento manualmente a ciascun indice, il ciclo esegue un'iterazione nell'array e visualizza automaticamente ogni elemento. 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.

Ad esempio, se vogliamo mostrare il nome di tutti gli articoli nel feed di prodotto mats_bestseller, il ciclo for corrispondente sarebbe:

{% for item in feed.mats_bestseller.products %}
{{ item.name }}
{% endfor %}

➡️ Per ulteriori informazioni sui cicli for, consulta il nostro articolo dedicato [Manuale] Ripetizione di un blocco di elementi nelle email utilizzando i cicli for.

📢 Istruzioni condizionali

👀 Visualizzazione condizionale (istruzioni if)

Utilizza un'istruzione if per mostrare o nascondere parti della tua email in base ai dati di ciascun destinatario. Questa ti consente di inviare un'unica email che si adatta in modo dinamico ai diversi contatti in base a condizioni specifiche.

➡️ 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 (cicli for)

Utilizza un ciclo for per visualizzare in modo dinamico tutti gli elementi di un array. Anziché fare riferimento manualmente a ciascun indice, il ciclo esegue un'iterazione nell'array e visualizza automaticamente ogni elemento. 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.

➡️ Per ulteriori informazioni sui cicli for, consulta il nostro articolo dedicato [Manuale] Ripetizione di un blocco di elementi nelle email utilizzando i cicli for.

🪄 Filtri

I filtri modificano l'output di una variabile trasformandone il valore. Si trovano all'interno delle doppie parentesi della variabile e sono separati da una barra verticale |, ad esempio {{ contact.FIRSTNAME|upper }}. Puoi anche concatenare più filtri insieme, con ogni filtro che applica la propria trasformazione al risultato del precedente.

Ecco alcuni esempi di variabili utilizzate con i filtri per modificarne l'output:

➡️ 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.