Skip to content

Référence Liquid

Liquid est un langage de modèles open source créé par Shopify et utilisé par Braze pour alimenter la personnalisation dynamique. Au lieu d’envoyer un message statique à tout le monde, Liquid vous permet de créer des modèles dont le contenu s’adapte en fonction des données de profil, du comportement ou de la langue de chaque destinataire. Utilisez les articles de cette section pour découvrir les étiquettes prises en charge, les filtres, la logique conditionnelle, les valeurs par défaut et les modèles de personnalisation courants.

Articles de la section

    À propos de Liquid

    Liquid sert de pont entre votre message et les données de vos utilisateurs. Lorsque vous envoyez un message, Braze analyse le texte à la recherche de la syntaxe Liquid. Lorsqu’il en détecte, il récupère les données pertinentes pour cet utilisateur spécifique et remplace le code par la valeur réelle avant l’envoi du message.

    Par exemple, vous pouvez récupérer un attribut personnalisé d’un profil utilisateur qui est un type de données entier et arrondir cette valeur à l’entier le plus proche. Pour en savoir plus sur la syntaxe et l’utilisation de Liquid, consultez Étiquettes de personnalisation prises en charge.

    Le langage de modèles Liquid prend en charge l’utilisation d’objets, d’étiquettes et de filtres.

    • Les objets vous permettent d’insérer des attributs personnalisés dans vos messages.
    • Les étiquettes vous permettent d’insérer des données dans vos communications et d’utiliser une logique conditionnelle pour envoyer des messages lorsque certaines conditions sont remplies. Par exemple, vous pouvez utiliser des étiquettes pour inclure une logique intelligente, comme des instructions « if », dans vos Campaigns.
    • Les filtres vous permettent de reformater les attributs personnalisés et le contenu dynamique. Par exemple, vous pourriez utiliser le filtre date pour convertir un horodatage, tel que 2016-09-07 08:43:50 UTC, en une date, telle que 7 septembre 2016.

    Prise en charge de Liquid 5

    Braze prend en charge Liquid jusqu’à la version Liquid 5 de Shopify incluse. L’implémentation de Liquid prend en charge les types d’étiquettes de personnalisation de syntaxe et le contrôle des espaces. Pour plus d’informations sur les étiquettes spécifiques, consultez Étiquettes de syntaxe.

    Les nouveaux filtres de tableaux et filtres mathématiques suivants sont disponibles pour être utilisés dans votre Liquid lors de la création de vos communications.

    • at_least
    • at_most
    • compact
    • concat
    • sort_natural
    • where

    Consultez Filtres pour les définitions.

    Termes à connaître

    Ces termes sont réinterprétés à partir de la documentation de Shopify en fonction de notre niveau de prise en charge.

    Terme Définition Exemple
    Liquid Un langage de modèles open source couramment utilisé, créé par Shopify et écrit en Ruby, qui permet de charger et d’extraire du contenu dynamique. {{${first_name}}} insérera le prénom d’un utilisateur dans un message.
    Objet Une notation de variable et d’emplacement du nom de variable souhaité qui indique à Liquid où afficher le contenu dans le message. {{${city}}} insérera la ville d’un utilisateur dans un message.
    Balise de logique conditionnelle Utilisée pour créer une logique et contrôler le flux du contenu d’un message. Dans Braze, les balises de logique conditionnelle sont utilisées pour créer des exceptions et des variations dans les messages en fonction de certains critères prédéfinis. {% if ${language} == 'en' %} déclenchera votre message d’une manière spécifique dans le cas où un utilisateur a défini « anglais » comme langue.
    Filtres Utilisés pour modifier, affiner ou reformater la sortie de l’objet Liquid. Ils sont souvent utilisés pour créer des opérations mathématiques. {{"Big Sale" | upcase}} fera apparaître les mots « Big Sale » sous la forme « BIG SALE » dans le message.
    Opérateurs Utilisés dans les messages pour créer des dépendances ou des critères qui peuvent influencer le message que votre utilisateur recevra. Si un utilisateur remplit les critères définis dans un message balisé avec {% custom_attribute.${Total_Revenue} > 0%}, il recevra le message. Sinon, il recevra un autre message désigné (ou non), selon ce que vous avez configuré.


    New Stuff!