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 ti offrono un modo rapido per inserire la data corrente nei messaggi delle campagne e dei flussi. 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:

1. 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.
   

2. Dal menu Tutti i tipi, scegli Data.
3. Scegli un tag della data, come Data corrente o Anno corrente.
4. Se hai scelto Data attuale, seleziona un Formato data e fai clic su Inserisci. Gli altri tag data vengono inseriti quando li selezioni.

Popola una data dinamica da un evento in un'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.

Le date degli eventi possono includere un orario e un offset del fuso orario. Un timestamp potrebbe apparire così:

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 converte una stringa di data supportata in un valore di data, in modo che tu possa usare il filtro data per formattarla. Non devi prima sezionare il timestamp.
• data
  Qui puoi scegliere il formato della data; Django ha una tabella che spiega come affrontare questa impostazione.

Nell'esempio qui sotto, sostituisci your_variable con la parte del tuo tag data all'interno di {{ }}. Separa i filtri con una barra verticale (|) e senza spazi in mezzo:

{{ your_variable|format_date_string|date:'F d, Y' }}

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.

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

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. Mantieni days_later prima dei filtri di formattazione, come mostrato di seguito:

{% 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.

Risorse aggiuntive