Riferimento alla personalizzazione della data nei modelli
Cosa imparerai
Scopri come compilare e formattare dinamicamente le date nei tuoi modelli Klaviyo. Puoi inserire le date dalle Proprietà del profilo (ad es. data di nascita) in qualsiasi messaggio oppure i metadati degli eventi (ad es. data dell'ordine effettuato) nei messaggi del flusso attivati da quell'evento.
Compila giorno, settimana, mese o anno correnti
I tag della data offrono un modo rapido per inserire l'orario di una campagna in un messaggio. La data è nel fuso orario del tuo account.
- Giorno corrente del mese: il giorno corrente del mese è {% current_day %}.
Il giorno corrente del mese è 5. - Giorno della settimana corrente: Il giorno della settimana corrente è {% current_weekday %}.
Il giorno della settimana corrente è venerdì. - Mese corrente: Il mese corrente è {% current_month_name %}.
Il mese corrente è settembre. - Anno corrente: l'anno corrente è {% current_year %}.
L'anno corrente è il 2021.
Al momento supportiamo solo i nomi in inglese dei mesi e dei giorni della settimana.
Per aggiungere una data dinamica a un messaggio:
- Da qualsiasi campo di testo (ad esempio, un blocco di testo in un'e-mail, l'editor SMS, l'editor di messaggi push), clicca sull'icona di personalizzazione.
- Dal menu Tutti i tipi, scegli Data.
- Scegli un tag della data (ad esempio data corrente, anno corrente e così via).
Cerchi una proprietà del profilo di tipo data, come la data di nascita? Scegli Personalizzato dal menu Tutti i tipi, quindi cerca o scorri per trovare la proprietà. Le proprietà data degli eventi sono disponibili nella finestra di anteprima di un messaggio in qualsiasi flusso basato su eventi.
Popola una data dinamica come variabile evento nell'e-mail del flusso
Mettiamo che tu stia inviando una e-mail di ringraziamento tramite un flusso che si attiva ogni volta che un cliente effettua un ordine. Potresti voler aggiungere una frase che dice: "Grazie per il tuo ordine del _____" e specificare la data dell’ordine effettuato.
Se guardi i dati che Klaviyo riceve insieme a un evento, come un evento Placed Order, dovresti riuscire a trovare una variabile che rappresenta la data dell’ordine. Cerca una proprietà chiamata "order date" o qualcosa di simile, perché il nome della proprietà varia a seconda della fonte dati.
Una volta trovata questa variabile, probabilmente noterai che il formato di questa data non è ideale da usare in un modello: ad esempio, è un timestamp UTC che non ha un bell'aspetto in un'e-mail:
Se vuoi compilare questa data in un formato più intuitivo per i clienti, devi applicare alcuni filtri. Klaviyo supporta la maggior parte dei filtri usati dal linguaggio di modelli Django. Per questo caso d'uso, devi utilizzare i seguenti filtri:
- Format_date_string
Questo filtro analizza e converte la stringa di caratteri estratta dal timestamp UTC completo in una data reale; questo è necessario per poter utilizzare il filtro data per formattarla. - Data
Qui puoi scegliere come formattare la data; Django ha una tabella che descrive come procedere.
Per applicare questi filtri, separali con una barra verticale (|) e senza spazi intermedi:
{{ your_variable|format_date_string|date:'F d, o' }}
Quanto sopra trasformerebbe questo:
2016-02-11T16:46:08-05:00
in questo:
11 febbraio 2016
Di seguito trovi alcuni formati aggiuntivi comuni di data e ora, insieme alla formattazione usata per visualizzarli.
26 febbraio 2016 | {{ your_variable|format_date_string|date:'F d, o' }} |
il 26 febbraio 2016 | {{ your_variable|format_date_string|date:'d F o' }} |
26/02/2016 | {{ your_variable|format_date_string|date:'m-d-Y' }} |
26-02-2016 | {{ your_variable|format_date_string|date:'d-m-Y' }} |
26/2/16 (senza 0 iniziali) | {{ your_variable|format_date_string|date:'n/j/y' }} |
26/2/16 (senza 0 iniziali) | {{ your_variable|format_date_string|date:'j/n/y' }} |
11 feb | {{ your_variable|format_date_string|date:'M d' }} |
11 feb | {{ your_variable|format_date_string|date:'d M' }} |
02-26-2016 4:46:08 | {{ your_variable|format_date_string|date:'m-d-Y g:i:s' }} |
26-02-2016 16:46 | {{ your_variable|format_date_string|date:'m-d-Y g:i a' }} |
26/02/2016 16:46 | {{ your_variable|format_date_string|date:'m-d-Y g:i A' }} |
Per un elenco completo delle opzioni di formato data, fai riferimento alla documentazione sul formato data di Django.
Utilizzo della variabile “today”
La variabile today ti consente di mostrare la data odierna nel momento in cui viene inviato un messaggio. Per mostrare la data odierna, usa questo codice:
{% today "%Y-%m-%d" as today %} {{ today }}
La data verrà visualizzata in questo formato: 2021-03-18
Assicurati di usare l’intera riga di codice qui sopra. La variabile della data non verrà visualizzata se includi un tag ma non l’altro (ad es. non puoi usare il solo tag {{ today }} senza il tag precedente {% today ... %}).
Per applicare una formattazione diversa, applica i filtri dalla sezione sopra alla variabile {{ today }}. Ad esempio, {% today '%Y-%m-%d' as today %} {{ today|format_date_string|date:'m/d/Y' }} verrebbe visualizzato usando il formato MM/DD/YYYY.
Calcolo di una data futura
Se desideri mostrare una data futura relativa al giorno in cui viene inviato un messaggio, applica il filtro days_later alla variabile today descritta sopra, in questo modo:
{% today "%Y-%m-%d" as today %} {{ today|days_later:5 }}
Questa variabile mostrerà la data 5 giorni dopo l'invio di un messaggio. Quindi, se il messaggio è stato inviato il 18 marzo, la data visualizzata sarebbe 2021-03-23.
Questo filtro può essere combinato con i filtri di formattazione descritti sopra per usare un formato data diverso. Prendi questo codice come esempio:
{% today '%Y-%m-%d' as today %} {{ today|days_later:5|format_date_string|date:'M d' }}
Se il messaggio è stato inviato il 18 marzo, verrà visualizzato come 23 mar.