Documentazione sulla personalizzazione dei messaggi

Cosa imparerai

Scopri come utilizzare le variabili di personalizzazione (o tag) di Klaviyo nei messaggi di marketing per offrire un'esperienza personalizzata ai tuoi iscritti.

I tag di personalizzazione possono essere utilizzati nelle e-mail (compresa la riga dell'oggetto), nei messaggi SMS o MMS e nelle notifiche push. Questo articolo illustra alcuni tag disponibili, le loro strutture e forme, oltre alle indicazioni per personalizzarli. Se vuoi aggiungere la personalizzazione, consulta il nostro articolo su come aggiungere la personalizzazione ai messaggi. 

Come funzionano i tag di personalizzazione

Quando inserisci i tag nel campo di testo di un messaggio, il risultato è simile alla frase a sinistra nella tabella qui sotto. Una volta inviato il messaggio, i tag vengono sostituiti dalle informazioni del profilo del destinatario o dai dettagli dell'evento e appaiono come la frase a destra.

La personalizzazione del profilo generalmente inizia con person, ad eccezione di alcuni tag speciali come first_name e last_name. Le variabili evento, che possono essere utilizzate nel flusso attivato dalla metrica, iniziano con event. I tag dell'organizzazione (come il nome e l'indirizzo della tua azienda) iniziano con organization. 

Personalizzazione del profilo

La personalizzazione del profilo ti consente di visualizzare le proprietà speciali di Klaviyo nei tuoi messaggi. L'elenco qui di seguito indica tutte le personalizzazioni del profilo (cioè le proprietà integrate di Klaviyo). I tag di personalizzazione del profilo sono disponibili dal menu Personalizzazione nell'editor di e-mail o dalla finestra modale di anteprima per gli SMS e i messaggi push. 

Se desideri aggiungere delle proprietà personalizzate ai tuoi messaggi, passa alla sezione relativa alla personalizzazione su misura. 

Tag dell'organizzazione

I tag dell'organizzazione consentono di includere nei messaggi le informazioni sulla tua organizzazione o azienda. Puoi gestire queste informazioni accedendo a Account > Informazioni di contatto > Organizzazione. Tutti i tag dell'organizzazione iniziano con organization. Consulta la tabella seguente per l'elenco dei tag dell'organizzazione.

Tag del link e dell'anteprima

I tag del link e dell'anteprima consentono ai destinatari di gestire le preferenze di abbonamento e di visualizzare il messaggio nel browser. Ciò include le seguenti azioni: 

• Annullare l'iscrizione
• Gestire le preferenze
• Visualizzare sul web
• Vedere l'anteprima del testo 

Questi tag sono supportati esclusivamente per i modelli di e-mail, non per SMS/MMS. Se fai clic su uno di questi link da un'e-mail di anteprima, sarai indirizzato a una pagina segnaposto, anziché a una pagina di consenso o a un'anteprima in tempo reale. 

Annullare l'iscrizione

Klaviyo richiede un link di annullamento dell'iscrizione in tutte le e-mail. Utilizza un semplice tag di annullamento dell'iscrizione con un link indicante la classica formula "Annulla iscrizione" oppure aggiungi il testo personalizzato tra virgolette. 

In alternativa, puoi utilizzare il tag {% unsubscribe_link %} per generare un URL di annullamento dell'iscrizione. Invece di generare una parola o una frase con un link completo, questo tag crea solo l'URL di annullamento dell'iscrizione. Utilizza questo tag se desideri evidenziare il link di annullamento dell'iscrizione con un colore diverso rispetto al colore del link impostato negli stili del tuo modello; puoi anche usare un pulsante o un'immagine linkata anziché un link testuale. 

Quando un destinatario clicca sul link di annullamento dell'iscrizione, viene indirizzato a una pagina di conferma personalizzabile.

Gestire le preferenze

Le pagine delle preferenze consentono ai destinatari di aggiornare le loro preferenze, consentendoti di segmentare e targettizzare i messaggi in modo più efficace. Per includere un link a questa pagina per ciascun destinatario, utilizza il tag di gestione delle preferenze.

Puoi creare delle pagine di gestione delle preferenze specifiche per un elenco e generali. Le pagine specifiche per un elenco vengono inviate quando spedisci un messaggio a un solo elenco. La pagina di gestione delle preferenze generali viene utilizzata quando invii a un segmento, una combinazione di elenchi e nei flussi che non sono attivati da un elenco. Scopri di più sulle pagine di gestione delle preferenze. 

Utilizza un semplice tag di gestione delle preferenze con un link indicante "Gestisci preferenze" oppure aggiungi il testo tra virgolette. 

In alternativa, puoi utilizzare il tag {% manage_preferences_link %} per generare un URL di gestione delle preferenze. Invece di generare una parola o una frase con un link completo, questo tag crea solo l'URL della pagina delle preferenze del destinatario. Utilizza questo tag se desideri evidenziare il link con un colore diverso rispetto al colore del link impostato negli stili del tuo modello; puoi anche usare un pulsante o un'immagine linkata anziché un collegamento testuale. 

Visualizzare sul web

Per dare ai destinatari la possibilità di visualizzare un'e-mail nel loro browser, puoi utilizzare il tag di visualizzazione web. 

Vedere l'anteprima del testo

In alcuni casi potresti ritenere opportuno visualizzare il testo di anteprima all'interno del corpo del tuo modello. È possibile fare riferimento a qualsiasi testo di anteprima impostato nella schermata di anteprima/configurazione dell'e-mail utilizzando il tag {% render_variable preview_text %}.

Se aggiorni il testo di anteprima nella schermata di anteprima dell'e-mail, questo tag visualizza il testo di anteprima aggiornato.

Tag eventi e personalizzazione su misura

I tag personalizzati fanno riferimento alle proprietà del profilo personalizzate, ovvero tutti i dati che raccogli sui tuoi contatti che sono diversi dalle proprietà e dagli eventi speciali Klaviyo (come il compleanno di un utente o le preferenze del contatto). I tag evento fanno riferimento ai dati di un evento specifico (ad esempio per un evento di ordine effettuato) e possono essere utilizzati solo nei flussi attivati da quell'evento. 

Per aggiungere un tag personalizzato, clicca su Personalizzazione in un campo di testo dell'e-mail e individua il tag. Per aggiungere un tag evento, visualizza l'anteprima del messaggio e copia il tag della variabile evento dai dati di anteprima. In alternativa, utilizza i formati descritti qui di seguito per aggiungere manualmente i tag personalizzati al tuo modello. 

Utilizza la notazione punto (.) per i tag senza spazi o caratteri speciali. Se i nomi delle proprietà contengono spazi o caratteri speciali (ad esempio $), utilizza la notazione di ricerca. 

Come personalizzare i tag con i filtri

Per personalizzare il modo in cui viene visualizzato il tag, applica i filtri del modello. I filtri possono essere utilizzati per applicare le maiuscole al titolo, impostare il numero di cifre decimali e molto altro ancora. Due dei filtri più comuni sono quello predefinito e per titolo. 

Il filtro predefinito imposta un valore predefinito da visualizzare se per il destinatario del messaggio non è impostata tale proprietà. Nell'esempio qui di seguito, "amico" e "prelibatezze" sono impostati come valori predefiniti nel caso in cui il nome del destinatario o il suo cibo preferito non siano impostati nel profilo Klaviyo. 

Il filtro titolo consente di applicare maiuscole e minuscole a qualsiasi tag di testo, per garantire che venga visualizzato in modo coerente una volta inviato il messaggio. Ad esempio, alcuni iscritti potrebbero utilizzare tutte le lettere maiuscole o tutte le minuscole quando compilano il modulo d'iscrizione. Senza un filtro, il nome utilizzerebbe le maiuscole e le minuscole utilizzate inizialmente durante la compilazione del modulo. Al contrario, il filtro del titolo corregge maiuscole e minuscole in modo che il nome venga visualizzato correttamente. 

Esistono molti altri filtri disponibili per i messaggi. Scopri ulteriori informazioni sull'utilizzo dei filtri per personalizzare i tag. 

Tag della data 

I tag della data offrono un modo rapido per inserire informazioni sulla data in un'e-mail. La data viene impostata nel fuso orario del tuo account e indica il giorno o l'ora in cui è stato inviato un messaggio. 

Il tag {{ today }} (oggi) è uno dei tag della data più comuni e indica la data e l'ora nel momento in cui il messaggio viene inviato. Per utilizzare il tag "today", incolla la seguente riga di codice nel tuo modello: 

{% today "%Y-%m-%d" as today %} {{ today }}

Tieni presente che l'utilizzo del tag {{ today }} senza il codice precedente non indicherà nulla; è necessaria l'intera riga di codice. 

Per sapere come utilizzare o personalizzare il tag della data, leggi il nostro articolo sui tag della data nei modelli. 

Tag della valuta 

I dati degli eventi, come Placed order, Added to cart e altri, hanno spesso un valore monetario associato (ad esempio il prezzo di un prodotto o il valore del carrello di un cliente). Usa il tag {% currency_format … %} per applicare la formattazione della valuta del tuo Paese a quel valore.

Per esempio, considera il campo $value nella metrica Started checkout qui di seguito: 

Utilizzando solo la variabile {{ event|lookup:"$value" }}, questa proprietà verrà resa con un solo decimale e nessun simbolo di valuta nell'e-mail: 

Tuttavia, con il tag relativo al formato della valuta, {% currency_format event|lookup:"$value" %}, il numero viene visualizzato con un simbolo di valuta e il numero corretto di cifre decimali: 

Per usare il tag relativo al formato della valuta, sostituisci il testo segnaposto in {% currency_format PLACEHOLDER %} con la tua variabile.

Ad esempio, se la tua variabile è {{ event.item.price }}, il tag completo relativo al formato della valuta sarà {% currency_format event.item.price %}. Se il tuo tag comprende dei filtri (ad esempio un valore predefinito, nel caso in cui la proprietà sia vuota), includili nel tag: {% currency_format event.item.price|default:”0” %}. 

Come selezionare un Paese 

Puoi impostare il formato della valuta per i messaggi in due punti: 

• Per tutto l'account
  Vai su Impostazioni > Organizzazione > Lingua dell'organizzazione e formato locale, quindi seleziona la Lingua dell'organizzazione. 
• Per un messaggio specifico
  Seleziona un formato della valuta diverso per un unico messaggio dalla scheda Stili del modello nella sezione Valuta. 

Risoluzione dei problemi del tag currency_format

Il tag è supportato solo per le variabili numeriche (ad esempio 10 oppure 24,56). Le proprietà con il simbolo della valuta incluso (ad esempio 40 € oppure 76,30 €) sono stringhe e il tag currency_format non può modificarle. 

Istruzioni condizionali

I tag condizionali consentono di includere contenuti nei tuoi messaggi per i destinatari che soddisfano determinati criteri e di non includerli per altri. Sono importanti perché ti permettono di personalizzare i messaggi per ogni destinatario.

Istruzioni "se"

Le istruzioni "se" consentono di controllare il contenuto che qualcuno riceve in base al profilo o ai dati dell'evento. 

Nell'esempio seguente, a una persona viene mostrata la prima riga di testo solo se dispone di oltre 150 punti fedeltà. Se dispone di meno 150 punti, ma più di 0, visualizza la seconda riga. E, se non dispone di punti fedeltà, visualizza il terzo messaggio. 

{% if person|lookup:'Loyalty Points' > 150 %}
Ciao VIP! Hai sempre spedizione e resi gratuiti
{% elif person|lookup:'Loyalty Points' > 0 %}
Hai raggiunto {{ person|lookup:'Loyalty Points' }} punti e ne bastano solo 150 per diventare VIP! 
{% else %}
Hai sentito parlare del nostro programma VIP? Iscriviti subito sul nostro sito web per iniziare a ottenere premi.
{% endif %}

All'interno di un'istruzione "se", viene richiesta una condizione iniziale {% if … %}, nonché il tag di chiusura {% endif %} . Tutti gli altri elementi (cioè i tag {% elif %} e {% else %} ) sono opzionali. Puoi utilizzare un numero illimitato di tag {% elif %}, seguiti da massimo un tag {% else %}. Ogni destinatario e-mail visualizza solo il messaggio per il quale è idoneo. 

Istruzioni "per"

I blocchi "per" permettono la ripetizione su ogni elemento di una variabile che contiene un elenco e di renderli in modo singolo. Di seguito viene riportato un esempio di istruzione: 

Ogni istruzione di tipo per deve contenere quanto segue: 

• Un tag di apertura {% for … %} contenente un alias di riga (item nell'esempio sopra) e una raccolta di righe (event.shopping_cart_items nell'esempio sopra)
• Un tag {% endfor %} di chiusura

Tra i due tag richiesti puoi includere qualsiasi testo desideri. Per includere le variabili nidificate all'interno dell'insieme di righe, sostituisci l'inizio del nome della variabile (l'insieme di righe più il numero che segue l'insieme di righe) con l'alias di riga. Ad esempio, la variabile {{ event.shopping_cart_items.0.name }} diventerebbe {{ item.name }}. 

Istruzioni condizionali e editor di testo in linea

Quando aggiungi alcune istruzioni condizionali a un blocco di testo, queste possono scomparire dall'editor di testo in linea. Il codice è ancora presente, ma è solo nascosto. Per visualizzare e modificare le istruzioni condizionali, apri il campo Codice sorgente del blocco di testo. 

I seguenti tag sono visibili solo nel campo Codice sorgente di un blocco di testo: 

• {% for ... %}
• {% endfor %}
• {% if ... %}
• {% elif ... %}
• {% else %}
• {% endif %}
• {% with ... %}
• {% endwith %}

Risorse aggiuntive

• Come creare e inviare una campagna e-mail
• Come utilizzare il pannello di anteprima per la personalizzazione dei messaggi
• Come costruire blocchi dinamici in un flusso e-mail
• Risoluzione dei problemi relativi ai messaggi di errore dei modelli di e-mail