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.

La personnalisation des messages dans Pushwoosh est basée sur les Tags (données utilisateur). Pushwoosh propose une variété de Tags par défaut et de Tags personnalisés. 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 « free », 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 utilisent une combinaison de balises, d’objets et de filtres 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.

Note

Pour en savoir plus sur la syntaxe, veuillez vous référer à la documentation Liquid.

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.

Entrée

Hi {{Name}}! We're glad you're back!

Sortie

Bonjour Anna ! Nous sommes ravis de vous revoir !

Balises

Les balises 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 la logique Liquid à un utilisateur.

Par exemple, en utilisant la balise if, vous pouvez faire varier la langue du message en fonction de la langue définie sur l’appareil de l’utilisateur :

Entrée

{% if Language == 'fr' %}
Salut!
{% else %}
Hello!
{% endif %}

Sortie (fr)

Salut!

Sortie (es)

Hello!

Opérateurs de balises

Opérateur	Description
==	égal à
!=	n’est pas égal à
>	supérieur à
<	inférieur à
>=	supérieur ou égal à
<=	inférieur ou égal à
or	ou logique
and	et logique
contains	vérifie la présence d’une sous-chaîne dans une chaîne ou un tableau de chaînes

Note

Dans les balises avec plus d’un opérateur and ou or, les opérateurs sont vérifiés dans l’ordre de droite à gauche. Vous ne pouvez pas changer l’ordre des opérations en utilisant des parenthèses — les parenthèses sont des caractères invalides en Liquid et empêcheront vos balises de fonctionner.

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 une barre verticale |. Plusieurs filtres peuvent être utilisés sur une même sortie, et sont appliqués de gauche à droite.

Entrée

{{ Name | capitalize | prepend:"Hello " }}

Sortie

Bonjour Anna

Utilisation des modèles Liquid dans les messages envoyés via l’API

Utilisez la syntaxe Liquid dans vos requêtes 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 prenant en charge le Contenu dynamique, en particulier les paramètres spécifiques à la plateforme « title », « subtitle » et « image ».

En utilisant les 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 créer des campagnes push basées sur l’utilisateur contenant un contenu extrêmement pertinent.

Note

Veuillez noter que, contrairement au Contenu dynamique, les variables dans les modèles doivent être entourées de doubles accolades comme suit : {{myVariable}}.

Pour définir la logique du modèle en utilisant des Tags avec des espaces dans leurs noms, utilisez la technique suivante :

Exemple

{% capture my_tag %}{{My Tag}}{% endcapture %}
{% if my_tag == 'value' %}
Content to send in this case
{% else %}
Content to send otherwise
{% endif %}

Cas d’utilisation des modèles Liquid

Vous trouverez ici plusieurs cas d’utilisation où les modèles Liquid sont pratiques.

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.

Entrée Liquid

{% if Language == 'es' %}
¡Hola!
{% else %}
Hello!
{% endif %}

Requête API

{
  "request": {
    "application": "XXXXX-XXXXX", // Pushwoosh app code
    "auth": "yxoPUlw.....IyEX4H", // API access token from Pushwoosh Control Panel
    "notifications" : [ // push message parameters
      {
       "content": "{% raw %}
{% if language == 'es' %}¡Hola!{% else %}hello!{% endif %}
{% endraw %}",
        "template_bindings": { // optional. When no template_bindings are passed in a request, Tag values from the device are used.
         "language" : "es"
        }
      }
    ]
  }
}

Sortie

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.

Entrée Liquid

{% if Subscription == 'Basic' %}
    Upgrade to Silver for getting more product features and 24/7 support.
{% elsif Subscription == 'Silver' %}
    Upgrade to Gold for priority support and advanced features.
{% else %}
    Please contact your manager to renew your subscription.
{% endif %}

Requête API

{
  "request": {
    "application": "XXXXX-XXXXX", // Pushwoosh app code
    "auth": "yxoPUlw.....IyEX4H", // API access token from Pushwoosh Control Panel
    "notifications" : [ // push message parameters
      {
       "content": "{% raw %}
{% if Subscription == 'Basic' %}Upgrade to Silver for getting more product features and 24/7 support.{% elsif Subscription == 'Silver' %}Upgrade to Gold for priority support and advanced features.{% else %}Please contact your manager to renew your subscription. {% endif %}
{% endraw %}",
        "template_bindings": { // optional. When no template_bindings are passed in a request, Tag values from the device are used.
         "language" : "es"
        }
      }
    ]
  }
}

Sortie

Pour les utilisateurs avec un abonnement Basic : Passez à l’abonnement Silver pour obtenir plus de fonctionnalités produit et un support 24/7.

Pour les utilisateurs avec un abonnement Silver : Passez à l’abonnement Gold pour un support prioritaire et des fonctionnalités avancées.

Pour les utilisateurs avec d’autres abonnements : Veuillez contacter votre responsable pour renouveler votre abonnement.

Balises de type Liste

Les modèles de contenu sont très utiles pour gérer les Tags de type Liste.

Taille de la variable

Un des cas d’utilisation possibles est de fournir 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 en fonction de leurs comportements. 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 !

Entrée Liquid

{% if WishList.size >= 3 %}
Get 20% off your next purchase!
{% elsif WishList.size == 2 %}
Get a 10% discount on your next purchase!
{% else %}
Hey, take a look at new outwears!
{% endif %}

Requête API

{
  "request": {
    "application": "XXXXX-XXXXX", // Pushwoosh app code
    "auth": "yxoPUlw.....IyEX4H", // API access token from Pushwoosh Control Panel
    "notifications" : [ // push message parameters
      {
       "content": "{% raw %}
{% if WishList.size >= 3 %}Get 20% off your next purchase!{% elsif WishList.size == 2 %}Get a 10% discount on your next purchase!{% else %}Hey, take a look at new outwears!{% endif %}
{% endraw %}",
        "template_bindings": {
         "WishList" : ["Skinny Low Ankle Jeans", "Linen Trenchcoat", "High Waisted Denim Skirt", "Strappy Tiered Maxi Dress"]
        }
      }
    ]
  }
}

Taille de WishList ≥ 3

Taille de WishList = 2

La variable contient

Un autre cas que vous pourriez avoir besoin de couvrir est de gérer les valeurs des Tags de type Liste et de fournir le contenu le plus pertinent en fonction des valeurs que le Tag contient.

Entrée Liquid

{% if WishList contains 'Skinny Low Ankle Jeans' %}
Get 20% off products in your wishlist!
{% else %}
Hey, take a look at the brand new Skinny Low Ankle Jeans!
{% endif %}

Requête API

{
  "request": {
    "application": "C90C0-0E786",
    "auth": "yxoPUlw.....IyEX4H", // API access token from Pushwoosh Control Panel
    "notifications" : [ // push message parameters
      {
       "content": "{% raw %}
{% if WishList contains 'Skinny Low Ankle Jeans' %}Get 20% off your next purchase!{% else %}Hey, take a look at the brand new Skinny Low Ankle Jeans!{% endif %}
{% endraw %}",
        "template_bindings": {
         "WishList" : ["Skinny Low Ankle Jeans", "Linen Trenchcoat", "High Waisted Denim Skirt", "Strappy Tiered Maxi Dress"]
        }
      }
    ]
  }
}

La variable contient des données

La variable ne contient pas de données

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 type Liste contient plus d’une valeur.

Entrée Liquid

    Get 20% off item
{% if WishList.size > 1 %}
    s in your WishList!
{% else %}
    in your Wishlist!
{% endif %}

Requête API

{
  "request": {
    "application": "C90C0-0E786",
    "auth": "yxoPUlw.....IyEX4H", // API access token from Pushwoosh Control Panel
    "notifications" : [ // push message parameters
      {
       "content": "Get 20% off item{% raw %}
{% if WishList.size > 1 %}s in your WishList!{% else %} in your Wishlist!{% endif %}
{% endraw %}",
        "template_bindings": { // optional. When no template_bindings are passed in a request, Tag values from the device are used.
         "WishList" : ["Skinny Low Ankle Jeans", "Linen Trenchcoat", "High Waisted Denim Skirt", "Strappy Tiered Maxi Dress"]
        }
      }
    ]
  }
}

Pluriel

Singulier

Fuseau horaire

Le modèle pour les fuseaux horaires convertit la date et l’heure en fonction du fuseau horaire spécifié.

Entrée Liquid

{{ MyDate | timezone: MyTimezone | date: \"%Y-%m-%d %H:%M\" }}

Requête API

Example

{
  "request" : {
    "auth" : "3H9bk8w3.....Acge2RbupTB", // API access token from Pushwoosh Control Panel
    "application" : "XXXXX-XXXXX", // Pushwoosh app code
    "notifications" : [ // push message parameters
      {
        "content": "Current Date: {{ MyDate | timezone: MyTimezone | date: \"%Y-%m-%d %H:%M\" }}",
        "template_bindings": { // optional. When no template_bindings are passed in a request, Tag values from the device are used.
         "MyDate" : "2019-07-23 15:00",
         "MyTimezone" : "Asia/Dubai"
        }
      }
    ]
  }
}

Sortie

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 provenant 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 disposer de 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’User ID, 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 ex., 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

Comment ça marche

Le service backend agit comme un fournisseur de données, répondant aux requêtes HTTP avec des informations spécifiques à l’utilisateur.

1. Pushwoosh envoie une requête à votre backend, en passant des identifiants spécifiques à l’utilisateur comme paramètres de requête.
2. Votre backend traite la requête et récupère les données demandées.
3. Votre backend renvoie une réponse JSON.
4. Avant d’envoyer un message, Pushwoosh récupère la réponse JSON du service backend et utilise les valeurs renvoyées (par exemple, le code) dynamiquement dans le contenu du message.

Exemple de réponse

{ "code": "SPECIALOFFERFORUSER12345" }

Étape 2. Créer un préréglage avec du Contenu connecté dans Pushwoosh

1. Dans l’éditeur de contenu Push ou Email, 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

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=YOUR_API_KEY :save result %}

Vous pouvez également envoyer des données d’authentification (ou toute autre donnée) en tant qu’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 YOUR_TOKEN", "X-Api-Key": "YOUR_API_KEY"} :save result %}

:headers {...}	Un objet JSON d’en-têtes HTTP envoyés avec la requête, par ex. Authorization: Bearer <token>.

Valeurs statiques uniquement

Les variables de personnalisation ${} ne fonctionnent qu’à l’intérieur de l’URL. Les valeurs à l’intérieur de :headers sont statiques et ne sont pas interpolées.

Ne mettez pas les identifiants dans l'URL

Préférez :headers à un paramètre de requête URL (par ex. &auth=YOUR_API_KEY) pour les clés API et les jetons : si la récupération échoue, l’URL de la requête est écrite dans les journaux, exposant une clé qui s’y trouve. Les valeurs à l’intérieur de :headers ne sont jamais journalisées.

Le contenu connecté nécessite également que les modèles de contenu Liquid soient activés pour votre compte. S’ils ne le sont pas, toute la balise connected_content — y compris toute clé à l’intérieur — est envoyée à chaque destinataire sous forme de texte littéral au lieu d’être rendue. Contactez le Support Pushwoosh si vous n’êtes pas sûr que votre compte ait cette fonctionnalité activée.

Utilisation des balises 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é ({{ tag_name }}).

{% 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 :

Hey, {{userid}}, grab your personal promo code - {{result.code}}

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.

Étape 3. Envoyer un message en utilisant le préréglage configuré

Envoyez un message avec ce préréglage en utilisant le formulaire de push unique ou d’e-mail ou via un parcours client.

Important

Si le service renvoie un statut autre que HTTP 200 OK, l’e-mail ou la notification push ne sera pas envoyé. Cela garantit que votre communication n’est envoyée que si les données nécessaires sont récupérées avec succès.