Référence des variables Liquid
Chaque champ dynamique qu'un email de notification peut utiliser, les types d'email qui y ont droit, et les règles vérifiées à la publication.
Cette page liste les champs dynamiques des emails de notification et les règles qu'ils suivent. Pour une courte introduction, voir Personnaliser les emails avec des champs dynamiques.
Un champ s'écrit {{ nom }} et fonctionne dans les champs Objet du courriel, Pré-en-tête du courriel, Contenu du courriel, Étiquette CTA du courriel et Lien CTA du courriel. Quand un participant n'a pas de valeur pour un champ, celui-ci reste vide.
Les champs
| Famille | Champs | Contient |
|---|---|---|
| Organisation | enterprise_name, group_name, group_display_name, sender_from_name, sender_from_email, reply_from_email, facebook_link, instagram_link, tiktok_link, twitter_link | Votre organisation, son expéditeur et ses liens vers les réseaux sociaux |
| Participant | contact_fullname, contact_firstname, contact_lastname, contact_email, contact_phone_number, contact_external_id | La personne qui reçoit l'email |
| Point de contact | collectible_title, collectible_subtitle, collectible_description, collectible_location, collectible_image_url | Le point de contact dont parle l'email |
| Récompense | reward_display_name, reward_title, reward_description, reward_image_uri, reward_winner_title, reward_eligible_title | Le lot |
| Coupon | coupon_code, coupon_name, coupon_url, coupon_content_type | Le code ou le lien du lot. coupon_content_type indique lequel des deux : CONTENT_TYPE_TEXT_CODE ou CONTENT_TYPE_URL |
| Activité | event_title, event_subtitle, event_location | L'activité réservée |
| Réservation | booking_id, booking_slot_start_date, booking_attendees_count, booking_ticket_type_display_name | La réservation elle-même |
| Liste d'attente | waitlist_entry_id, waitlist_ticket_type_id, waitlist_host_id, waitlist_attendee_count, waitlist_slot_start_date, waitlist_slot_end_date, waitlist_offered_at_date, waitlist_expires_at_date, waitlist_confirmation_url, waitlist_decline_url | La place en liste d'attente : son créneau et, dans une invitation, la date de l'offre, sa date d'expiration et les liens pour la confirmer ou la refuser |
Chaque date de liste d'attente existe aussi en morceaux : remplacez _date par _date_utc, _year, _month, _day, _hour ou _minute, comme dans waitlist_expires_at_hour. Les champs _date suivent le fuseau horaire et la langue de la campagne.
Les variables personnalisées définies pour votre organisation fonctionnent sous leur propre nom, comme {{ country }}.
Saluer un participant
Utilisez {{ contact_fullname }}. Il affiche le nom complet, ou le prénom et le nom ensemble, selon ce que le participant a renseigné. contact_firstname et contact_lastname sont vides pour les participants inscrits avec un seul champ de nom complet : « Bonjour {{ contact_firstname }}, » peut donc donner « Bonjour , ». Les textes de vos emails ne sont pas mis à jour automatiquement quand une campagne passe à un champ de nom complet.
Quel email peut utiliser quoi
| Organisation, Participant | Point de contact | Récompense | Coupon | Activité, Réservation | Liste d'attente | |
|---|---|---|---|---|---|---|
| Participation | Oui | Non | Non | Non | Non | Non |
| Point de contact débloqué | Oui | Oui | Non | Non | Non | Non |
| Gagnant, Récompense réclamée | Oui | Non | Oui | Oui | Non | Non |
| Perdant, Éligible | Oui | Non | Oui | Non | Non | Non |
| Confirmation de réservation, Annulation de réservation, Rappel de confirmation de réservation | Oui | Oui | Non | Non | Oui | Non |
| Inscription en liste d'attente | Oui | Oui | Non | Non | Non | Oui, sauf les dates de l'offre et les deux liens |
| Invitation depuis la liste d'attente | Oui | Oui | Non | Non | Non | Oui, sauf waitlist_host_id et waitlist_attendee_count |
Exemples
You've won {{ reward_display_name }}!Hi {{ contact_fullname }},
You've won {{ reward_display_name }}. Your code: {{ coupon_code }}Hi {{ contact_fullname }},
Your place at {{ event_title }} is booked for {{ booking_slot_start_date }}, at {{ event_location }}.Hi {{ contact_fullname }},
A place has opened at {{ collectible_title }} on {{ waitlist_slot_start_date }}. Confirm it before {{ waitlist_expires_at_date }}.Règles
- Écrivez chaque champ exactement comme dans la liste. Un champ inconnu bloque la publication.
- N'utilisez un champ que dans les emails qui y ont droit : un code coupon dans un email Perdant bloque la publication.
- Fermez chaque
{{avec}}. - Gardez la mise en forme hors des accolades :
<b>{{ contact_fullname }}</b>, jamais{{ <b>contact_fullname</b> }}. - Dans le champ Lien CTA du courriel, un champ dynamique utilisé seul doit contenir une adresse :
coupon_url,reward_image_uri,collectible_image_url,collectible_image_link,waitlist_confirmation_url,waitlist_decline_urlou un lien vers un réseau social. À l'intérieur d'une adresse plus longue, n'importe quel champ fonctionne, tant que le reste est une adresse valide. - Rédigez chaque phrase pour qu'elle se lise encore quand un champ est vide.
Ce que signale la publication
| Problème | Message | Correction |
|---|---|---|
| Champ inconnu | Variable liquid non définie '…' utilisée dans … | Utilisez un champ de cette page |
| Champ non autorisé dans cet email | La variable liquid '…' (binding …) ne peut pas être utilisée dans la notification … | Utilisez un champ autorisé pour ce type d'email |
| Accolades non fermées | Le champ … de la notification … a une syntaxe liquid invalide: … | Fermez chaque {{ avec }} |
| Mise en forme dans les accolades | Le champ … de la notification … contient des balises HTML dans le template liquid: … | Sortez la mise en forme des accolades |
| Le lien du bouton n'est pas une adresse | La notification … utilise '…' comme lien CTA, mais cette variable ne contient pas d'URL | Utilisez un champ d'adresse, ou une adresse complète |
Étapes suivantes
- Référence des types de notifications
- À propos des webhooks, quand un autre système a besoin des mêmes événements
Personnaliser les emails avec des champs dynamiques
Ajoutez à un email de notification le nom du participant, son lot ou sa réservation, avec la valeur propre à chaque personne.
Un participant n'a pas reçu d'email
Vérifiez si OmniLab a envoyé une notification, puis trouvez pourquoi elle n'est pas arrivée ou n'est pas partie.