Approfondissement des templates Liquid et des variables
Comprendre quelles variables Liquid sont disponibles dans les notifications OmniLab et comment les écrire correctement.
OmniLab utilise Liquid pour personnaliser plusieurs contenus de notification, comme l'objet d'email, le preheader, le contenu, ou certains appels à l'action. Cet article aide les équipes techniques et CRM à comprendre quelles familles de variables sont disponibles selon le type de notification.
Où Liquid est généralement utilisé
Selon la notification, vous pouvez retrouver du Liquid dans :
- l'objet d'email
- le preheader
- le contenu principal
- le label de CTA
- le lien du CTA
Règle de base d'écriture
Utilisez la syntaxe standard Liquid :
{{ contact.first_name }}Vous pouvez aussi appliquer des filtres standards Liquid lorsque le contexte le permet :
{{ contact.first_name | default: "there" }}Grandes familles de variables
| Famille | Exemples | Disponible quand |
|---|---|---|
| Common | group.name, touchpoint.name | Dans une grande partie des notifications liées à un parcours ou à une organisation |
| Contact | contact.first_name, contact.last_name, contact.email | Quand un contact identifié est disponible dans le contexte |
| Reward | reward.name, reward.description | Notifications liées à un gain ou à un reward |
| Coupon | coupon.code, coupon.expiry_date | Notifications liées à un coupon ou code promo |
| Event | event.name, event.start_at | Notifications liées à un événement |
| Booking | booking.activity_name, booking.slot_starting_at | Notifications liées à la réservation |
Comment raisonner par type de notification
- une notification de reward peut utiliser des variables Common, Contact, Reward, et parfois Coupon
- une notification de booking peut utiliser des variables Common, Contact, Event, et Booking
- une notification de parcours plus générique n'a pas forcément accès aux familles Reward, Coupon, ou Booking
Toutes les variables ne sont pas disponibles partout
Une variable valide dans une notification de booking ne l'est pas forcément dans une notification de reward. Si vous réutilisez un template, revérifiez toujours les bindings disponibles pour le type ciblé.
Erreurs fréquentes
- faute de frappe dans le nom d'une variable
- utilisation d'une famille non disponible pour la notification ciblée
- HTML ou syntaxe cassée à l'intérieur des délimiteurs Liquid
- hypothèse qu'une valeur est toujours présente alors qu'elle peut être vide
Exemples pratiques
Exemple 1 : email de reward
Congratulations {{ contact.first_name | default: "there" }}, you won {{ reward.name }}Exemple 2 : rappel de booking
Hello {{ contact.first_name | default: "there" }}, your booking for {{ booking.activity_name }} starts at {{ booking.slot_starting_at }}.Exemple 3 : CTA avec coupon
Use code {{ coupon.code }} before {{ coupon.expiry_date }}Bonnes pratiques de rédaction
- prévoyez une valeur par défaut lorsque le prénom ou une donnée optionnelle peut manquer
- gardez un template par type de notification quand les jeux de variables diffèrent trop
- testez les cas avec et sans données facultatives
- évitez les phrases qui deviennent bancales si une valeur est vide
Pour aller plus loin
Variables Liquid et bindings
Voir le guide plateforme associé aux notifications et à la personnalisation.
Référence des types de notifications
Comprendre quelles notifications existent côté plateforme.
Configurer les webhooks
Voir comment Liquid peut aussi intervenir dans certaines transformations de livraison.
Écrire des scripts d'organisation
Ajouter du JavaScript custom dans l'expérience OmniLab en comprenant le contexte d'exécution, les déclencheurs, et les données disponibles.
Intégration borne (approfondissement technique)
Embarquer OmniLab dans une borne, une WebView, ou un wrapper applicatif en comprenant les signaux front disponibles.