Come usare i filtri per personalizzare le variabili

Cosa imparerai

Scopri come funzionano i filtri e come usarli per personalizzare le variabili. I filtri ti consentono di personalizzare il formato e il contenuto delle variabili (ovvero i tag di personalizzazione) nei tuoi messaggi. Per un elenco dei filtri disponibili nell'editor dei modelli, consulta il glossario dei filtri delle variabili di Klaviyo.

Prima di iniziare

Prima di iniziare, acquisisci familiarità con come funziona la personalizzazione in Klaviyo. Per usare i filtri, devi essere in grado di identificare le variabili di base corrette e aggiungerle al tuo modello.

Come funzionano i filtri

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

• Applica una capitalizzazione coerente a un testo (ad esempio, puoi usare il filtro upper per prendere una variabile e renderla completamente in maiuscolo).
• Mostra il prezzo di un articolo dopo l'applicazione di una promozione usando il filtro multiply.
• Imposta il numero di cifre decimali da visualizzare per una variabile numerica utilizzando il filtro floatformat.

Per un elenco di filtri supportati, consulta il nostro glossario dei filtri delle variabili.

Applica un filtro a una variabile

Per applicare un filtro a una variabile:

1. Identifica il tuo tag di personalizzazione (ad es. {{ item.price }}).
2. Aggiungi un simbolo pipe ( | ) dopo il nome della variabile.
3. Aggiungi un nome filtro, ad esempio floatformat, per specificare il numero di decimali da visualizzare.
4. Se il filtro accetta argomenti (ovvero parametri o input aggiuntivi), aggiungi i due punti, seguiti dall'argomento o dagli argomenti.

Non aggiungere spazi aggiuntivi. 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 è una porzione di testo, deve essere racchiuso tra virgolette singole dritte (ad es. ', non ‘). Le virgolette non sono necessarie se l'argomento è un numero. Consulta il glossario dei filtri di variabile di Klaviyo per esempi.

Suggerimenti per usare i filtri

Se stai copiando i filtri e li stai incollando nel tuo modello, assicurati di incollarli come testo normale per evitare di incollare la formattazione insieme al filtro stesso. Usa la scorciatoia da tastiera per incollare come testo normale (Ctrl+Maiusc+V o Cmd+Maiusc+V).

È importante assicurarsi che i dati a cui fanno riferimento le variabili siano appropriati per il filtro utilizzato. Alcuni filtri possono essere applicati solo ai tipi di dati di testo, mentre altri funzionano solo su elenchi o numeri. Se il filtro non funziona come previsto, controlla i dati di evento o del profilo che stai utilizzando per assicurarti che siano del tipo corretto.

Applicazione di più filtri

Se necessario, puoi applicare più filtri a una singola variabile. Per farlo, collega ogni filtro usando il simbolo pipe ( | ) e tieni presente che in genere i filtri verranno applicati in ordine (dal primo all’ultimo). Ecco alcuni esempi di variabili con più filtri applicati:

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

Il primo filtro applica la maiuscola al nome del destinatario e il secondo filtro fornisce una parola predefinita da usare se non è stato fornito alcun nome.

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

Il primo filtro moltiplica il prezzo base dell'articolo per 0,8 (per mostrare il prezzo se è stato applicato un coupon del 20% di sconto), mentre il secondo filtro specifica che devono essere visualizzate due cifre decimali.

Risorse aggiuntive