Personalização de datas em modelos de referência

O que você vai aprender

Saiba como preencher e formatar datas dinamicamente em seus modelos do Klaviyo. O senhor pode inserir datas de propriedades de perfil (por exemplo, aniversário) em qualquer mensagem ou metadados de eventos (por exemplo, data do pedido feito) em mensagens de fluxo acionadas por esse evento. 

Preencher o dia, a semana, o mês ou o ano atuais

As tags de data oferecem ao senhor uma maneira rápida de inserir a hora de uma campanha em uma mensagem. A data está no fuso horário de sua conta. 

• Dia atual do mês: O dia atual do mês é {% current_day %}.
  O dia atual do mês é 5.
  
• Dia atual da semana: O dia atual da semana é {% current_weekday %}.
  O dia atual da semana é sexta-feira.
  
• Mês atual: O mês atual é {% current_month_name %}.
  O mês atual é setembro.
  
• Ano atual: O ano atual é {% current_year %}.
  O ano atual é 2021.

Atualmente, só oferecemos suporte a nomes em inglês para meses e dias da semana.

Para adicionar uma data dinâmica a uma mensagem: 

1. Em qualquer campo de texto (por exemplo, bloco de texto em um e-mail, editor SMS, editor de mensagens push), clique no ícone de personalização.
   
2. No menu Todos os tipos, selecione Data. 
3. Escolha uma tag de data (por exemplo, data atual, ano atual, etc.). 

Preencher uma data dinâmica como variável de evento no e-mail de fluxo

Digamos que o senhor esteja enviando um e-mail de agradecimento por meio de um fluxo que é acionado sempre que um cliente faz um pedido. O senhor pode adicionar uma frase que diga: "Obrigado pelo seu pedido em _____" e especifique a data do pedido feito.

Se o senhor observar os dados que o Klaviyo recebe junto com um evento, como o evento Placed Order, deverá encontrar uma variável que representa a data do pedido. Procure uma propriedade chamada "order date" ou algo semelhante, pois o nome da propriedade varia de acordo com a fonte de dados.

Depois de encontrar essa variável, o senhor provavelmente perceberá que o formato dessa data não é ideal para ser usado em um modelo: é um carimbo de data e hora UTC que não fica bem em um e-mail, por exemplo:

Se quiser preencher essa data em um formato mais amigável para o cliente, o senhor precisará aplicar alguns filtros. O Klaviyo suporta a maioria dos filtros usados pela linguagem de modelo do Django. Para esse caso de uso, o senhor precisará usar os seguintes filtros:

• Format_date_string 
  Esse filtro analisa e converte a cadeia de caracteres cortada do carimbo de data/hora UTC completo em uma data real; isso é necessário para que o senhor possa usar o filtro de data para formatá-la.
• Date
  É aqui que o senhor escolhe como quer que a data seja formatada; o Django tem um gráfico que descreve como abordar isso.

Para aplicar esses filtros, separe-os com um pipe (|) e sem espaços entre eles:

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

O acima exposto transformaria isso:

2016-02-11T16:46:08-05:00

para isso: 

11 de fevereiro de 2016

Abaixo estão alguns outros formatos comuns de data e hora, juntamente com a formatação usada para exibi-los. 

Para obter uma lista completa das opções de formato de data, consulte a documentação de formato de data do Django. 

Usando a variável "today

A variável today permite que o senhor exiba a data de hoje no momento em que uma mensagem é enviada. Para exibir a data de hoje, use este código: 

{% today "%Y-%m-%d" as today %} {{ today }}

A data será exibida no seguinte formato: 2021-03-18

Para aplicar uma formatação diferente, aplique os filtros da seção acima à variável {{ today }}. Por exemplo, {% today '%Y-%m-%d' as today %} {{ today|format_date_string|date:'m/d/Y' }} seria renderizado usando o formato MM/DD/YYYY. 

Cálculo de uma data futura

Se o senhor quiser exibir uma data futura relativa ao dia em que uma mensagem é enviada, aplique o filtro days_later à variável today descrita acima, da seguinte forma: 

{% today "%Y-%m-%d" as today %} {{ today|days_later:5 }}

Essa variável exibirá a data 5 dias após o envio de uma mensagem. Portanto, se a mensagem foi enviada em 18 de março, a data exibida seria 2021-03-23. 

Esse filtro pode ser combinado com os filtros de formatação descritos acima para usar um formato de data diferente. Veja este código como exemplo: 

{% today '%Y-%m-%d' as today %} {{ today|days_later:5|format_date_string|date:'M d' }}

Se a mensagem foi enviada em 18 de março, isso seria renderizado como 23 de março. 

Recursos adicionais

• Referência de personalização de mensagens
• Como formatar datas para arquivos CSV
• Como usar o painel de visualização para personalização de mensagens