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.

4 min de lecture

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

FamilleChampsContient
Organisationenterprise_name, group_name, group_display_name, sender_from_name, sender_from_email, reply_from_email, facebook_link, instagram_link, tiktok_link, twitter_linkVotre organisation, son expéditeur et ses liens vers les réseaux sociaux
Participantcontact_fullname, contact_firstname, contact_lastname, contact_email, contact_phone_number, contact_external_idLa personne qui reçoit l'email
Point de contactcollectible_title, collectible_subtitle, collectible_description, collectible_location, collectible_image_urlLe point de contact dont parle l'email
Récompensereward_display_name, reward_title, reward_description, reward_image_uri, reward_winner_title, reward_eligible_titleLe lot
Couponcoupon_code, coupon_name, coupon_url, coupon_content_typeLe 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_locationL'activité réservée
Réservationbooking_id, booking_slot_start_date, booking_attendees_count, booking_ticket_type_display_nameLa réservation elle-même
Liste d'attentewaitlist_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_urlLa 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

EmailOrganisation, ParticipantPoint de contactRécompenseCouponActivité, RéservationListe d'attente
ParticipationOuiNonNonNonNonNon
Point de contact débloquéOuiOuiNonNonNonNon
Gagnant, Récompense réclaméeOuiNonOuiOuiNonNon
Perdant, ÉligibleOuiNonOuiNonNonNon
Confirmation de réservation, Annulation de réservation, Rappel de confirmation de réservationOuiOuiNonNonOuiNon
Inscription en liste d'attenteOuiOuiNonNonNonOui, sauf les dates de l'offre et les deux liens
Invitation depuis la liste d'attenteOuiOuiNonNonNonOui, sauf waitlist_host_id et waitlist_attendee_count

Exemples

Objet de l'email Gagnant
You've won {{ reward_display_name }}!
Contenu de l'email Gagnant
Hi {{ contact_fullname }},
You've won {{ reward_display_name }}. Your code: {{ coupon_code }}
Contenu de la confirmation de réservation
Hi {{ contact_fullname }},
Your place at {{ event_title }} is booked for {{ booking_slot_start_date }}, at {{ event_location }}.
Contenu de l'invitation depuis la liste d'attente
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_url ou 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èmeMessageCorrection
Champ inconnuVariable liquid non définie '…' utilisée dans …Utilisez un champ de cette page
Champ non autorisé dans cet emailLa variable liquid '…' (binding …) ne peut pas être utilisée dans la notification …Utilisez un champ autorisé pour ce type d'email
Accolades non ferméesLe champ … de la notification … a une syntaxe liquid invalide: …Fermez chaque {{ avec }}
Mise en forme dans les accoladesLe 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 adresseLa notification … utilise '…' comme lien CTA, mais cette variable ne contient pas d'URLUtilisez un champ d'adresse, ou une adresse complète

Étapes suivantes

Sur cette page