Guide de personnalisation des dates dans les modèles

Objectif de cet article

Découvrez comment remplir et formater dynamiquement des dates dans vos modèles Klaviyo. Vous pouvez saisir les dates des propriétés d’un profil (par exemple, son anniversaire) dans n’importe quel message, ou les métadonnées d’un événement (par exemple, la date d’une commande passée) dans les messages de flux déclenchés par cet événement.

Renseigner le jour, la semaine, le mois ou l’année en cours

Les tags de date vous permettent d’insérer rapidement l’heure d’une campagne dans un message. La date utilise le fuseau horaire de votre compte.

• Jour du mois actuel : le jour du mois actuel est {% current_day %}.
  Le jour du mois actuel est le 5.
  
• Jour de la semaine actuelle : le jour de la semaine actuelle est {% current_weekday %}.
  Le jour de la semaine actuelle est le vendredi.
  
• Mois actuel : le mois actuel est {% current_month_name %}.
  Le mois actuel est septembre.
  
• Année actuelle : l’année actuelle est {% current_year %}.
  L’année actuelle est 2021.

Actuellement, nous ne prenons en charge que les noms anglais des mois et des jours de la semaine.

Pour ajouter une date dynamique à un message :

1. Dans n’importe quel champ de texte (par exemple, le bloc de texte d’un e-mail, l’éditeur de SMS, l’éditeur de notifications push), cliquez sur Personnalisation.
2. Dans le menu Tous les types, sélectionnez Date.
3. Choisissez un tag de date (par exemple, Date actuelle, Année actuelle, etc.).

Renseigner une date dynamique en tant que variable d’événement dans un e-mail de flux

Supposons que vous envoyiez un e-mail de remerciement via un flux qui se déclenche chaque fois qu’un client passe une commande. Vous pouvez ajouter une phrase du type : « Merci de votre commande du _____ » et préciser la date de la commande.

Si vous passez en revue les données que Klaviyo reçoit lors d’un événement, par exemple Commande passée, vous devriez trouver une variable correspondant à la date de la commande. Recherchez la propriété « Date de la commande » ou un libellé approchant, car le nom de la propriété varie en fonction de la source de données.

Une fois cette variable trouvée, vous remarquerez probablement que son format de date ne convient pas à un modèle. Il s’agit d’un horodatage UTC qui n’a pas sa place dans un e-mail, par exemple :

Si vous souhaitez afficher cette date dans un format mieux adapté au client, vous devez appliquer quelques filtres. Klaviyo prend en charge la plupart des filtres utilisés par le langage de modèle de Django. Pour ce cas d’utilisation, vous devrez utiliser les filtres suivants :

• Format_date_string 
  Ce filtre analyse et convertit la chaine de caractères découpée de l’horodatage UTC complet en une date réelle. Cette opération est nécessaire pour que vous puissiez la formater avec le filtre de date.
• Date
  Ce filtre vous permet de sélectionner le format de votre date. Django propose un graphique qui explique comment procéder.

Pour appliquer ces filtres, séparez-les par une ligne verticale (|) sans espace :

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

L’exemple permet de transformer cette formulation :

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

en cette formulation : 

Février 11, 2016

Vous trouverez ci-dessous d’autres formats de date et d’heure courants, ainsi que le formatage utilisé pour les afficher.

Pour obtenir la liste complète des options de format de date, consultez la documentation de Django sur le format de date.

Utilisation de la variable « today »

La variable « today » (aujourd’hui) permet d’afficher la date du jour au moment de l’envoi d’un message. Pour afficher la date du jour, utilisez ce code :

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

La date s’affiche dans ce format : 2021-03-18

Pour utiliser un formatage différent, appliquez les filtres de la section ci-dessus à la variable {{ today }}. Par exemple, {% today '%Y-%m-%d' as today %} {{ today|format_date_string|date:'m/d/Y' }} se présentera au format MM/JJ/AAAA. 

Calculer une date ultérieure

Si vous souhaitez afficher une date ultérieure au jour d’envoi du message, appliquez le filtre « days_later » à la variable « today » décrite ci-dessus, comme suit :

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

Cette variable affichera une date 5 jours après l’envoi du message. Ainsi, si le message a été envoyé le 18 mars, la date affichée sera le 2021-03-23.

Ce filtre peut être combiné avec les filtres de formatage décrits ci-dessus pour utiliser un format de date différent. Prenons l’exemple de ce code :

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

Si le message a été envoyé le 18 mars, la date affichée sera le 23 mars.

Ressources complémentaires

• Guide de personnalisation des messages
• Comment formater les dates dans les fichiers CSV
• Comment utiliser le panneau de prévisualisation pour la personnalisation des messages