Documentazione sulla personalizzazione dei messaggi
Scopri come utilizzare le variabili di personalizzazione (o tag) di Klaviyo per personalizzare l'esperienza dei clienti.
I tag di personalizzazione possono essere utilizzati nelle e-mail (compresa la riga dell'oggetto), nei messaggi SMS o MMS, nelle notifiche push e nel Customer Hub. 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.
Precedentemente, i tag di personalizzazione erano chiamati tag modello e sintassi variabile.
Come funzionano i tag di personalizzazione
Quando inserisci i tag nel campo di testo, il risultato è simile alla frase a sinistra nella tabella qui sotto. Una volta visualizzato il messaggio, i tag vengono sostituiti dalle informazioni del profilo del destinatario o dai dettagli dell'evento e appaiono come la frase a destra.
Gentile | Gentile George Washington, il tuo colore preferito è il verde |
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.
Tutti i tag di personalizzazione fanno distinzione tra maiuscole e minuscole; inoltre, devono corrispondere esattamente ai nomi delle proprietà a cui fanno riferimento. Assicurati che il tag sia scritto correttamente e utilizza le stesse maiuscole/minuscole che appaiono sul tuo profilo.
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 | Proprietà del profilo |
| E-mail |
| Nome |
| Cognome |
| Organizzazione destinataria |
| Indirizzo 1 |
| ID univoco ($id/ID esterno) |
| Latitudine |
| Longitudine |
| ID Klaviyo |
| Nome completo |
| Titolo |
| Numero di telefono |
| Indirizzo 2 |
| Città |
| Provincia |
| Paese |
| Codice postale |
| Fonte |
| Consenso |
| $consent_form_id |
| $consent_form_version |
| $consent_method |
| Fuso orario del destinatario |
| $consent_timestamp |
| $phone_number_region |
| Articoli visti di recente |
| Data prevista per il prossimo ordine |
Tag degli oggetti personalizzati
I tag degli oggetti personalizzati ti permettono di utilizzare i dati degli oggetti negli invii dei flussi e delle campagne.
Consulta i riferimenti dei tag per vedere esempi specifici su come utilizzare i tag per ottenere l'ID di un oggetto o per restituire un conteggio.
Devi creare un oggetto prima di poter utilizzare i dati dell'oggetto personalizzato nel modello. Il tag di {{ object }} è disponibile solo quando un oggetto ha attivato un flusso.
Tag | Risultato |
| Restituisce l'oggetto che ha attivato un flusso |
| |
| Restituisce un singolo oggetto da un filtro di oggetti |
| |
| Restituisce un conteggio da un filtro di oggetti |
| Recupera un oggetto in base all'ID |
| Recupera tutti i record di un oggetto da un profilo |
Tag dell'organizzazione
I tag dell'organizzazione consentono di includere nei messaggi delle informazioni sulla tua organizzazione o azienda. Puoi gestire queste informazioni cliccando sul nome della tua organizzazione nell'angolo in basso a sinistra, quindi selezionando Impostazioni > Organizzazione > Informazioni di contatto. Tutti i tag dell'organizzazione iniziano con organizzazione. Consulta la tabella seguente per l'elenco dei tag dell'organizzazione.
Tag dell'organizzazione | Descrizione |
| Il nome dell'organizzazione |
| Il sito web dell'organizzazione |
| L'indirizzo completo dell'organizzazione, inclusi città, provincia e CAP |
| L'indirizzo dell'organizzazione |
| La seconda parte dell'indirizzo dell'organizzazione (ad esempio il numero dell'appartamento o dell'interno) |
| La città dell'organizzazione |
| Lo stato, la provincia o la regione dell'organizzazione |
| Il codice postale 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. Cliccando su uno di questi link da un'e-mail di anteprima si viene indirizzati 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.
Tag | Risultato |
| Annullare l'iscrizione |
Se non desideri più ricevere e-mail, | Se non desideri più ricevere e-mail, clicca qui. |
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.
Tag | Risultato |
| Questo link di annullamento dell'iscrizione è di fantasia. |
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 targetizzare 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.
Tag | Risultato |
| Gestisci le preferenze |
Vuoi aggiornare le tue preferenze? | Vuoi aggiornare le tue preferenze? Fai clic qui. |
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.
Tag | Risultato |
| Questo è un link di gestione delle preferenze di fantasia. |
Visualizzare sul web
Per dare ai destinatari la possibilità di visualizzare un'e-mail nel loro browser, puoi utilizzare il tag di visualizzazione web.
Tag | Risultato |
| Visualizzare nel browser |
Non riesci a vedere questa e-mail? | Non riesci a vedere questa e-mail? Aprila nel tuo browser. |
| Questo è un link di visualizzazione web di fantasia. |
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.
Formato del tag | Descrizione | Esempio |
| Un semplice tag per la personalizzazione del profilo |
|
| Un tag per la personalizzazione del profilo, se il nome della proprietà contiene spazi o caratteri speciali |
|
| Un semplice tag della variabile evento |
|
| Un tag della variabile evento, se il nome della variabile contiene spazi o caratteri speciali |
|
| Un tag della variabile evento, se la variabile evento è annidata nei dati dell'evento |
|
| Un tag della variabile evento, se la variabile evento è annidata in un'altra variabile con un nome contenente uno spazio o un carattere speciale |
|
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.
Tieni presente che, con le proprietà nidificate, se un nome di proprietà utilizza la notazione di ricerca, anche tutte le proprietà successive devono utilizzare la notazione di ricerca. Ciò significa che event|lookup:'Collection Names'|lookup:'0' è corretto, ma event|lookup:'Collection Names'.0 non lo è.
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.
Testo con tag di personalizzazione | Risultato |
Ciao | Ciao, ti interessa qualche prelibatezza? |
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.
Testo con tag di personalizzazione | Risultato |
Ciao | Ciao Elisa, hai visto il nostro ultimo articolo? |
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.
Ad 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 l'intero account
Vai su Impostazioni > Organizzazione > Lingua e formato regionale dell'organizzazione e 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! Spedizione e resi sono sempre 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 delle ricompense.
{% 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:
| Telo da spiaggia oversize × 1 Sedie da spiaggia × 4 Protezione solare SPF × 2 Refrigeratore in plastica × 1 |
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 della raccolta di righe, sostituisci l'inizio del nome della variabile (raccolta di righe più il numero che segue la raccolta di righe) con l'alias di riga. Ad esempio, la variabile {{ event.shopping_cart_items.0.name }} diventerebbe {{ item.name }}.
Istruzioni condizionali ed 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
Scopri i concetti base delle campagne e-mail, cosa sono e come inviarle con Klaviyo.
- Come utilizzare il pannello di anteprima per la personalizzazione dei messaggi
Scopra come utilizzare il pannello di anteprima per comprendere i dati di personalizzazione disponibili per i suoi messaggi e come accedere al modello di tag. Utilizzi l'anteprima modale come fonte di verità per le opzioni di personalizzazione.
- Come costruire blocchi dinamici in un flusso e-mail
Scopra come utilizzare i blocchi di tabelle dinamiche per aggiungere informazioni sui prodotti e su altri eventi ai suoi flussi metrici. In questo articolo, imparerà a creare un blocco dinamico utilizzando l'esempio di un promemoria per il carrello abbandonato che mostra i prodotti che sono stati lasciati.
- Risoluzione dei messaggi di errore dei modelli e-mail
Se riscontra errori o avvertimenti in un modello di e-mail, potrebbe essere necessario risolverli prima di inviare il messaggio. Cerchi in questa risorsa il messaggio di errore o l'avviso che sta incontrando per trovare suggerimenti per risolvere il problema.
- Come creare un blocco di contenuti per Klaviyo Customer Hub
Scopri come creare blocchi di contenuti per il tuo Customer Hub Klaviyo. I blocchi di contenuto sono blocchi altamente personalizzabili e personalizzabili che hanno accesso a Klaviyo dati del profilo che ti permettono di visualizzare integrazioni (ad es. punti fedeltà), offerte personalizzate e molto altro ancora.