Come utilizzare i filtri per personalizzare le variabili

Imparerai

Scopra come funzionano i filtri e come utilizzarli per personalizzare le variabili. I filtri le consentono di personalizzare il formato e il contenuto delle variabili (cioè i tag di personalizzazione) nei messaggi che invia. Per un elenco di filtri disponibili da utilizzare nell'editor di modelli, faccia riferimento al glossario dei filtri variabili di Klaviyo. 

Prima di iniziare

Prima di iniziare, familiarizzi con il funzionamento della personalizzazione dei messaggi in Klaviyo. Per utilizzare i filtri, deve essere in grado di identificare le variabili di base corrette e aggiungerle al suo modello. 

Come funzionano i filtri

I filtri vengono applicati ai tag di personalizzazione per regolare l'output che viene visualizzato. Alcuni casi d'uso possibili sono:

• Applica una capitalizzazione coerente a un pezzo di testo (ad esempio, può utilizzare il filtro maiuscolo per prendere qualsiasi variabile e renderla tutta maiuscola).
• Mostra il prezzo di un articolo dopo l'applicazione di una promozione utilizzando il filtro moltiplica. 
• Imposta il numero di cifre decimali da visualizzare per una variabile numerica utilizzando il filtro floatatform.

Per un elenco dei filtri supportati, faccia riferimento al nostro glossario sui filtri variabili. 

Applica un filtro a una variabile

Per applicare un filtro a una variabile:

1. Identifica il suo tag di personalizzazione (ad esempio, {{ item.price }}).
2. Aggiunga un simbolo di pipe ( | ) dopo il nome della variabile. 
3. Aggiunga un nome di filtro, come floatformat, per specificare il numero di decimali da visualizzare.
4. Se il filtro riceve degli argomenti (cioè dei parametri o degli input aggiuntivi), aggiunga i due punti, seguiti dall'argomento o dagli argomenti. 

Non aggiunga altri spazi. Ecco un esempio di una variabile con un filtro applicato:

{{ item.price|floatformat:2 }}

In questo esempio, item.price è il nome della variabile, floatformat è il filtro e 2 è l'argomento richiesto dal filtro. 

Se l'argomento è un testo, deve essere circondato da virgolette singole (cioè, ', non '). Le virgolette non sono necessarie se l'argomento è un numero. Per gli esempi, faccia riferimento al glossario dei filtri variabili di Klaviyo. 

Suggerimenti per l'utilizzo dei filtri

Se copia i filtri e li incolla nel suo modello, si assicuri di incollare come testo normale per evitare di incollare la formattazione insieme al filtro stesso. Utilizzi la scorciatoia da tastiera Incolla come testo normale (Ctrl+Shift+V o Cmd+Shift+V). 

È importante assicurarsi che i dati a cui fa riferimento nelle sue variabili siano appropriati per il filtro utilizzato. Alcuni filtri possono essere applicati solo a tipi di dati testuali, mentre altri funzionano solo su elenchi o numeri. Se il filtro non funziona come previsto, riveda i dati dell'evento o del profilo che sta utilizzando per assicurarsi che siano del tipo corretto. 

Applicazione di filtri multipli

Se necessario, può applicare più filtri a una singola variabile. Per farlo, colleghi ogni filtro con il simbolo del tubo ( | ) e consideri che i filtri saranno generalmente applicati in ordine (dal primo all'ultimo). Ecco alcuni esempi di variabili con filtri multipli applicati: 

{{ first_name|title|default:'there' }}

Il primo filtro applica l'involucro del titolo al nome del destinatario, mentre il secondo filtro fornisce una parola predefinita da utilizzare se non è stato fornito alcun nome. 

{{ item.price|multiply:.8|floatformat:2 }}

Il primo filtro moltiplica il prezzo dell'articolo base per .8. (per mostrare il prezzo se è stato applicato un buono sconto del 20%), e il secondo filtro specifica che devono apparire due cifre decimali. 

Risorse aggiuntive

• Glossario dei filtri variabili
• Variabili di data nei modelli di riferimento
• Riferimento alla personalizzazione del messaggio