Templates Liquid et variables disponibles
Personnaliser les e-mails de notification avec Liquid et comprendre quelles variables sont disponibles selon chaque type.
Cette référence explique comment fonctionne Liquid dans les notifications OmniLab, quelles variables sont disponibles selon le type de notification, et à quoi correspondent les erreurs de validation les plus fréquentes.
Les bases de Liquid
Utilisez Liquid pour insérer des valeurs dynamiques dans le contenu des notifications :
Bonjour {{ contact_firstname }},
Vous avez gagné {{ reward_display_name }}.Liquid peut être utilisé dans :
Email Subject LineEmail PreheaderEmail ContentEmail CTA LabelEmail CTA Link
Si une variable documentée n'a pas de valeur pour un destinataire donné, elle s'affiche comme une chaîne vide. Si vous utilisez un nom de variable qu'OmniLab ne connaît pas, la validation le signale avant le lancement.
Familles de variables
Les variables disponibles dépendent du type de notification :
- Variables communes : organisation, expéditeur, réponse, en-tête, pied de page, liens sociaux et données de contact
- Variables liées au point de contact : données de point de contact comme
collectible_title - Variables reward : données de récompense comme
reward_display_name - Variables coupon : codes de réclamation comme
coupon_code - Variables event et booking : détails d'activité comme
event_titleetbooking_slot_start_date
Variables disponibles par type de notification
| Type de notification | Variables disponibles | Exemples typiques |
|---|---|---|
Participation | Communes + contact | contact_firstname, contact_email, enterprise_name |
Point de contact débloqué | Communes + contact + contexte point de contact | collectible_title, collectible_location |
Gagnant | Communes + contact + reward + coupon | reward_display_name, coupon_code |
Perdant | Communes + contact + reward | reward_display_name, reward_title |
Éligible | Communes + contact + reward | reward_display_name, reward_eligible_title |
Récompense réclamée | Communes + contact + reward + coupon | reward_display_name, coupon_code |
Confirmation de réservation | Communes + contact + contexte point de contact + event + booking | event_title, booking_slot_start_date |
Annulation de réservation | Communes + contact + contexte point de contact + event + booking | event_title, booking_id |
Rappel de confirmation de réservation | Communes + contact + contexte point de contact + event + booking | event_title, booking_slot_start_date |
Exemples prêts à adapter
Bonjour {{ contact_firstname }},
Félicitations. Vous avez gagné {{ reward_display_name }}.
Votre code : {{ coupon_code }}Bonjour {{ contact_firstname }},
Votre réservation pour {{ event_title }} est confirmée.
Début du créneau : {{ booking_slot_start_date }}
Lieu : {{ event_location }}https://example.com/rewards/{{ reward_id }}?contact={{ contact_external_id }}Modèles corrects et incorrects
Placez le HTML en dehors des délimiteurs Liquid :
<span>{{ contact_firstname }}</span>Ne placez jamais de HTML à l'intérieur de {{ }} :
{{ <span>contact_firstname</span> }}Gardez des noms de variables simples et documentés. N'inventez pas de nouveaux bindings si votre environnement ne les expose pas déjà.
Messages de validation Liquid fréquents
| Problème | Exemple | Message de validation |
|---|---|---|
| HTML dans Liquid | {{ <span>contact_firstname</span> }} | Le champ {{field}} de la notification {{notification_type}} contient des balises HTML dans le template liquid: {{example}} |
| Syntaxe invalide | Accolades déséquilibrées ou syntaxe de variable mal formée | Le champ {{field}} de la notification {{notification_type}} a une syntaxe liquid invalide: {{error}} |
| Binding non défini | {{ reward_code }} | Variable liquid non définie '{{variable}}' utilisée dans {{notification_type}} {{field}} |
| Binding non autorisé pour ce type | {{ collectible_title }} dans Gagnant | La variable liquid '{{variable}}' (binding {{category}}) ne peut pas être utilisée dans la notification {{notification_type}} {{field}} |
| Erreur au rendu | Le template est accepté mais échoue au moment du rendu | Le template liquid du champ {{field}} de la notification {{notification_type}} a échoué lors du rendu: {{error}} |
Règles de rédaction sûres
- Gardez un message compréhensible même si une variable devient vide.
- Préférez des expressions courtes et directes à une logique trop complexe.
- Utilisez uniquement les variables adaptées au type de notification en cours.
- Re-testez un template copié lorsque vous le déplacez d'un type de notification à un autre.
Pour aller plus loin
Contenu des e-mails, bannières et CTA
Revoir les champs e-mail dans lesquels Liquid peut être utilisé.
Configurer les notifications globalement
Appliquer un template personnalisé partout où un type peut envoyer.
Configurer les notifications par point de contact
Définir des templates Liquid différents selon la récompense ou le point de contact.
Référence des types de notifications
Vérifier quel contexte de déclenchement accompagne chaque type.