# Utilisation des modèles Liquid Les modèles Liquid élargissent considérablement les capacités de personnalisation de Pushwoosh en mettant en œuvre une logique sophistiquée en plus de l'utilisation habituelle du [Contenu Dynamique](/fr/developer/guides/personalization/dynamic-content/). La personnalisation des messages dans Pushwoosh est basée sur les [Tags (données utilisateur)](/fr/developer/guides/audience-and-segmentation/tags/). Pushwoosh offre une variété de [Tags par défaut](/fr/developer/guides/audience-and-segmentation/tags/#default-tags) et de [Tags personnalisés](/fr/developer/guides/audience-and-segmentation/tags/#custom-tags). En les utilisant, vous pouvez spécifier le prénom de l'utilisateur, sa ville, son historique d'achat, etc. pour envoyer un message plus personnalisé, par exemple : Bonjour `{First_name}`, merci d'avoir commandé `{item}`. Les modèles Liquid ajoutent plus de logique au contenu dynamique. Par exemple, si le tag d'abonnement d'un utilisateur contient « gratuit », vous pouvez lui envoyer un message : « Profitez de votre réduction de 10 % ». Modifier le contenu du message en fonction des identifiants, des comportements et des préférences des utilisateurs est le moyen le plus efficace d'augmenter la pertinence et d'obtenir des résultats plus impressionnants de vos campagnes marketing. ## Syntaxe Les modèles de contenu basés sur [Liquid de Shopify](https://shopify.github.io/liquid/) utilisent une combinaison de [**tags**](/fr/developer/guides/personalization/liquid-templates/#tags), d'[**objets**](/fr/developer/guides/personalization/liquid-templates/#objects) et de [**filtres**](/fr/developer/guides/personalization/liquid-templates/#filters) pour charger du contenu dynamique. Les modèles de contenu vous permettent d'accéder à certaines variables depuis un modèle et d'afficher leurs données sans avoir à connaître quoi que ce soit sur les données elles-mêmes. ### Objets Les `objets` définissent le contenu qui sera affiché à un utilisateur. Les `objets` doivent être entourés de doubles accolades : `{{ }}` Par exemple, lors de la personnalisation d'un message, envoyez `{{Name}}` dans son corps pour ajouter les noms des utilisateurs au contenu du message. Le nom de l'utilisateur (valeur du tag Name) remplacera l'objet Liquid dans le message que l'utilisateur verra. ``` Bonjour {{Name}} ! Nous sommes ravis de vous revoir ! ``` Bonjour Anna ! Nous sommes ravis de vous revoir ! ### Tags Les `tags` créent la logique et le flux de contrôle pour les modèles. Les délimiteurs pourcentage-accolade `{%` et `%}` et le texte qu'ils entourent ne produisent aucune sortie visible lorsque le modèle est rendu. Cela vous permet d'assigner des variables et de créer des conditions ou des boucles sans montrer aucune de la logique Liquid à un utilisateur. Par exemple, en utilisant le tag `if`, vous pouvez varier la langue du message en fonction de la langue définie sur l'appareil de l'utilisateur : ```liquid {% if Language == 'fr' %} Salut! {% else %} Hello! {% endif %} ```` Salut! Hello! ### Opérateurs de tags
OpérateurDescription
==égal à
!=différent de
>supérieur à
<inférieur à
>=supérieur ou égal à
<=inférieur ou égal à
orou logique
andet logique
containsvérifie la présence d'une sous-chaîne dans une chaîne de caractères ou un tableau de chaînes de caractères
### Filtres Les `filtres` modifient la sortie d'un objet ou d'une variable Liquid. Ils sont utilisés à l'intérieur des doubles accolades `{{ }}` et de l'assignation de variables, et sont séparés par un caractère pipe `|`. Plusieurs filtres peuvent être utilisés sur une seule sortie, et sont appliqués de gauche à droite. ``` {{ Name | capitalize | prepend:"Hello " }} ``` Hello Anna ## Utilisation des modèles Liquid dans les messages envoyés via l'API Utilisez la syntaxe Liquid dans vos requêtes [`createMessage`](/fr/developer/api-reference/messages-api/#createmessage) pour implémenter les modèles Liquid. Les modèles sont disponibles pour le paramètre "content" de la requête `createMessage`, ainsi que pour tout autre paramètre supportant le Contenu Dynamique, en particulier les paramètres spécifiques à la plateforme "title", "subtitle" et "image". En utilisant des modèles de contenu, vous pouvez soit spécifier les données dans vos requêtes API (en passant le paramètre "template\_bindings") soit obtenir les données à partir des valeurs de Tag stockées sur les appareils des utilisateurs (en n'utilisant pas le paramètre "template\_bindings"). De cette façon, vous êtes en mesure de construire des campagnes push basées sur l'utilisateur contenant un contenu extrêmement pertinent. Pour définir la logique du modèle en utilisant les Tags avec des espaces dans leurs noms, utilisez la technique suivante : **Exemple** ``` {% capture my_tag %}{{My Tag}}{% endcapture %} {% if my_tag == 'value' %} Contenu à envoyer dans ce cas {% else %} Contenu à envoyer sinon {% endif %} ``` ## Cas d'utilisation des modèles Liquid Vous trouverez ici plusieurs cas d'utilisation où les modèles Liquid sont utiles. ### Push multilingue Les modèles Liquid permettent de spécifier précisément dans quelle langue les utilisateurs doivent recevoir vos messages push. Regardez l'exemple simple de la requête API et du message reçu en fonction des liaisons de modèle utilisées dans la requête. ``` {% if Language == 'es' %} ¡Hola! {% else %} Hello! {% endif %} ```` ```javascript { "request": { "application": "XXXXX-XXXXX", // Code d'application Pushwoosh "auth": "yxoPUlw.....IyEX4H", // Jeton d'accès API du Panneau de Contrôle Pushwoosh "notifications" : [ // paramètres du message push { "content": "{% raw %} {% if language == 'es' %}¡Hola!{% else %}hello!{% endif %} {% endraw %}", "template_bindings": { // optionnel. Lorsque aucun template_bindings n'est passé dans une requête, les valeurs de Tag de l'appareil sont utilisées. "language" : "es" } } ] } } ```` **La langue est 'es'** : ¡Hola! **La langue est 'en'** : Hello! ### Incitation à la mise à niveau de l'abonnement Encouragez vos clients à mettre à niveau leur abonnement en fonction de leur plan actuel. ``` {% if Subscription == 'Basic' %} Passez à Silver pour obtenir plus de fonctionnalités produit et un support 24/7. {% elsif Subscription == 'Silver' %} Passez à Gold pour un support prioritaire et des fonctionnalités avancées. {% else %} Veuillez contacter votre gestionnaire pour renouveler votre abonnement. {% endif %} ```` ```json { "request": { "application": "XXXXX-XXXXX", // Code d'application Pushwoosh "auth": "yxoPUlw.....IyEX4H", // Jeton d'accès API du Panneau de Contrôle Pushwoosh "notifications" : [ // paramètres du message push { "content": "{% raw %} {% if Subscription == 'Basic' %}Passez à Silver pour obtenir plus de fonctionnalités produit et un support 24/7.{% elsif Subscription == 'Silver' %}Passez à Gold pour un support prioritaire et des fonctionnalités avancées.{% else %}Veuillez contacter votre gestionnaire pour renouveler votre abonnement. {% endif %} {% endraw %}", "template_bindings": { // optionnel. Lorsque aucun template_bindings n'est passé dans une requête, les valeurs de Tag de l'appareil sont utilisées. "language" : "es" } } ] } } ```` **Pour les utilisateurs avec le plan d'abonnement Basic :** Passez à Silver pour obtenir plus de fonctionnalités produit et un support 24/7. **Pour les utilisateurs avec le plan d'abonnement Silver :** Passez à Gold pour un support prioritaire et des fonctionnalités avancées. **Pour les utilisateurs avec d'autres plans :** Veuillez contacter votre gestionnaire pour renouveler votre abonnement. ### Tags de liste Les modèles de contenu sont très utiles pour gérer les Tags de type Liste. #### Taille variable L'un des cas d'utilisation possibles est de livrer un contenu différent en fonction du nombre de valeurs que le Tag contient. Par exemple, vous pouvez offrir différentes réductions aux clients ayant des comportements différents. Disons que le client a des articles dans sa WishList — encouragez-le à acheter avec la réduction la plus appropriée en fonction du nombre de produits qu'il va acheter ! ``` {% if WishList.size >= 3 %} Obtenez 20% de réduction sur votre prochain achat ! {% elsif WishList.size == 2 %} Obtenez une réduction de 10% sur votre prochain achat ! {% else %} Hé, jetez un œil aux nouveaux vêtements d'extérieur ! {% endif %} ```` ```javascript { "request": { "application": "XXXXX-XXXXX", // Code d'application Pushwoosh "auth": "yxoPUlw.....IyEX4H", // Jeton d'accès API du Panneau de Contrôle Pushwoosh "notifications" : [ // paramètres du message push { "content": "{% raw %} {% if WishList.size >= 3 %}Obtenez 20% de réduction sur votre prochain achat !{% elsif WishList.size == 2 %}Obtenez une réduction de 10% sur votre prochain achat !{% else %}Hé, jetez un œil aux nouveaux vêtements d'extérieur !{% endif %} {% endraw %}", "template_bindings": { "WishList" : ["Skinny Low Ankle Jeans", "Linen Trenchcoat", "High Waisted Denim Skirt", "Strappy Tiered Maxi Dress"] } } ] } } ```` Aperçu de l'e-mail avec une taille de liste de souhaits supérieure ou égale à 3 Aperçu de l'e-mail avec une taille de liste de souhaits égale à 2 #### La variable contient Un autre cas que vous pourriez avoir besoin de couvrir est de traiter les valeurs des Tags de Liste et de livrer le contenu le plus pertinent en fonction des valeurs que le Tag contient. ``` {% if WishList contains 'Skinny Low Ankle Jeans' %} Obtenez 20% de réduction sur les produits de votre liste de souhaits ! {% else %} Hé, jetez un œil aux tout nouveaux Skinny Low Ankle Jeans ! {% endif %} ```` ```javascript { "request": { "application": "C90C0-0E786", "auth": "yxoPUlw.....IyEX4H", // Jeton d'accès API du Panneau de Contrôle Pushwoosh "notifications" : [ // paramètres du message push { "content": "{% raw %} {% if WishList contains 'Skinny Low Ankle Jeans' %}Obtenez 20% de réduction sur votre prochain achat !{% else %}Hé, jetez un œil aux tout nouveaux Skinny Low Ankle Jeans !{% endif %} {% endraw %}", "template_bindings": { "WishList" : ["Skinny Low Ankle Jeans", "Linen Trenchcoat", "High Waisted Denim Skirt", "Strappy Tiered Maxi Dress"] } } ] } } ```` Modèle personnalisé avec des données Vue de repli lorsque les données sont manquantes ### Pluriels En utilisant les modèles de contenu, vous pouvez ajuster le contenu du message en fonction du comportement des utilisateurs. Par exemple, vous pouvez modifier le texte du message pour qu'il contienne des mots au pluriel si le Tag de Liste contient plus d'une valeur. ``` Obtenez 20% de réduction sur l'article {% if WishList.size > 1 %} s de votre WishList ! {% else %} de votre Wishlist ! {% endif %} ```` ```javascript { "request": { "application": "C90C0-0E786", "auth": "yxoPUlw.....IyEX4H", // Jeton d'accès API du Panneau de Contrôle Pushwoosh "notifications" : [ // paramètres du message push { "content": "Obtenez 20% de réduction sur l'article{% raw %} {% if WishList.size > 1 %}s de votre WishList !{% else %} de votre Wishlist !{% endif %} {% endraw %}", "template_bindings": { // optionnel. Lorsque aucun template_bindings n'est passé dans une requête, les valeurs de Tag de l'appareil sont utilisées. "WishList" : ["Skinny Low Ankle Jeans", "Linen Trenchcoat", "High Waisted Denim Skirt", "Strappy Tiered Maxi Dress"] } } ] } } ```` Exemple de modèle au pluriel Exemple de modèle au singulier ### Fuseau horaire Le modèle pour les fuseaux horaires convertit la date et l'heure en fonction du fuseau horaire spécifié. ``` {{ MyDate | timezone: MyTimezone | date: \"%Y-%m-%d %H:%M\" }} ``` ```javascript title="Exemple" { "request" : { "auth" : "3H9bk8w3.....Acge2RbupTB", // Jeton d'accès API du Panneau de Contrôle Pushwoosh "application" : "XXXXX-XXXXX", // Code d'application Pushwoosh "notifications" : [ // paramètres du message push { "content": "Date actuelle : {{ MyDate | timezone: MyTimezone | date: \"%Y-%m-%d %H:%M\" }}", "template_bindings": { // optionnel. Lorsque aucun template_bindings n'est passé dans une requête, les valeurs de Tag de l'appareil sont utilisées. "MyDate" : "2019-07-23 15:00", "MyTimezone" : "Asia/Dubai" } } ] } } ``` Sortie de date personnalisée dans une notification push ## Contenu connecté Le contenu connecté est une fonctionnalité des modèles Liquid qui vous permet de récupérer et d'utiliser dynamiquement des données d'une source externe, comme un service web, directement dans vos messages e-mail ou de notification push. Cette fonctionnalité permet une personnalisation en temps réel en récupérant des données JSON à partir d'une URL spécifiée et en les enregistrant dans une variable qui peut être utilisée dans votre contenu. #### Principaux cas d'utilisation - **Recommandations de produits** : Affichez des listes de produits personnalisées adaptées à chaque utilisateur. - **Codes promotionnels** : Insérez des codes promotionnels uniques générés par un service backend. #### Prérequis * Pour utiliser le Contenu Connecté, vous devez avoir votre propre service backend qui génère et fournit les données requises (par exemple, codes promotionnels, recommandations de produits) en fonction de l'**ID utilisateur, du HWID ou de tags personnalisés**. Pushwoosh récupère ensuite ces données avant d'envoyer un message. ### Guide de mise en œuvre étape par étape #### Étape 1. Configurer le service backend Le service backend doit : * Accepter une requête contenant des paramètres spécifiques à l'utilisateur (par exemple, `userId`). Le Contenu Connecté prend en charge `UserID`, `HWID`, ou tout tag personnalisé que vous avez configuré dans votre projet. * Renvoyer une réponse JSON avec les données requises. Ce contenu peut ensuite être inséré dynamiquement dans les messages. #### Étape 2. Créer un préréglage avec du Contenu Connecté dans Pushwoosh 1. Dans l'[éditeur de contenu Push](/fr/product/content/push-presets/) ou [Email](/fr/product/content/email-content/drag-and-drop-email-editor/), insérez la syntaxe du Contenu Connecté dans le champ du message. **Exemple** ``` {% connected_content http://your-backend-url.com?userId={{ ${userid} }} :save result %} ``` **Décomposition de la syntaxe** | | | | ----- | ----- | | `connected_content` | Récupère les données JSON de l'URL backend spécifiée. | | `http://your-backend-url.com` | Le point de terminaison backend qui renvoie les données requises au format JSON. | | `userId={{ ${userid} }}` | Un paramètre de requête dynamique qui passe l'ID utilisateur au backend. | | `:save result` | Stocke la réponse JSON récupérée dans la variable `result` pour une utilisation dans les modèles Liquid. | ![Insérer la syntaxe du Contenu Connecté](/connectedcontent.webp) **Authentification (optionnel)** Si votre service backend nécessite une authentification, vous pouvez inclure une clé API ou un jeton dans la requête de Contenu Connecté pour garantir un accès sécurisé. ``` {% connected_content http://your-backend-url.com?userId={{ ${userid} }}&auth=VOTRE_CLE_API :save result %} ``` Vous pouvez également envoyer des données d'authentification (ou toute autre donnée) sous forme d'en-têtes HTTP en utilisant le paramètre optionnel `:headers` — un objet JSON de noms et de valeurs d'en-tête. ``` {% connected_content http://your-backend-url.com?userId={{ ${userid} }} :headers {"Authorization": "Bearer VOTRE_JETON", "X-Api-Key": "VOTRE_CLE_API"} :save result %} ``` | | | | ----- | ----- | | `:headers {...}` | Un objet JSON d'en-têtes HTTP envoyés avec la requête, par exemple `Authorization: Bearer `. | **Utilisation des tags dans le Contenu Connecté** Pour inclure des tags personnalisés, insérez-les comme paramètres de requête dans la requête de **Contenu Connecté** (`{{ nom_du_tag }}`). ``` {% connected_content http://your-backend-url.com?userId={{ ${userid} }}{{ Language }} :save result %} ``` 2. Ensuite, ajoutez le texte du message en incorporant les **données récupérées**, comme ceci : ``` Hé, {{userid}}, attrapez votre code promo personnel - {{result.code}} ``` ![Ajouter le texte du message avec les données récupérées](/connectedcontent-1.webp) 3. Après avoir finalisé le contenu du message et configuré les paramètres du préréglage, enregistrez-le pour le réutiliser dans les campagnes.