Utiliser les recommandations d’articles dans vos messages
Une fois votre recommandation formée, vous pouvez utiliser Liquid pour récupérer et afficher les éléments recommandés dans vos messages en travaillant directement avec l’objet Liquid
product_recommendation
.
Pour une présentation étape par étape, consultez notre cours d’apprentissage Braze : Créer des expériences personnalisées grâce à l’intelligence artificielle.
Conditions préalables
Avant de pouvoir utiliser des recommandations dans vos messages, vous devrez créer et former un moteur de recommandation. La formation peut durer entre 10 minutes et 36 heures. Vous recevrez un e-mail lorsque la formation sera terminée ou si une erreur s’est produite.
Utiliser des recommandations dans vos messages
Étape 1 : Ajouter le code Liquid
Une fois la formation de votre recommandation terminée, vous pouvez personnaliser vos messages avec Liquid pour y insérer les produits les plus populaires de ce catalogue.
Vous pouvez générer du liquide à partir de la section Ajouter une personnalisation dans votre compositeur de messages :
- Dans tous les compositeurs de messages qui prennent en charge la personnalisation, sélectionnez pour ouvrir la fenêtre de personnalisation.
- Pour le type de personnalisation, sélectionnez Recommandation produit.
- Pour Nom de la recommandation de l’élément, sélectionnez la recommandation que vous venez de créer.
- Pour Nombre de produits prédits, indiquez le nombre de meilleurs produits que vous souhaitez insérer. Par exemple, vous pouvez afficher les trois produits les plus achetés.
- Pour les informations à afficher, sélectionnez les champs du catalogue à inclure pour chaque article. Les valeurs de ces champs pour chaque article seront tirées du catalogue associé à cette recommandation.
- Sélectionnez l’icône Copier et collez le liquide à l’endroit voulu dans votre message.
Vous pouvez écrire un code Liquid personnalisé en faisant référence à l’objet product_recommendation
d’un catalogue. Il contient toutes les données de recommandation de produits générées dynamiquement pour ce catalogue, structurées sous la forme d’un tableau d’objets, où chaque objet représente un article recommandé.
Spécifications | Détails |
---|---|
Structure | Chaque élément est accessible sous la forme items[index] , où l’index commence à 0 (pour le premier élément) et s’incrémente pour les éléments suivants. |
Champs du catalogue | Chaque élément du tableau contient des paires clé-valeur correspondant à des champs (colonnes) du catalogue. Par exemple, les champs de catalogue courants pour les recommandations de produits sont les suivants : - name ou title - price - image_url |
Utilisez l’étiquette assign
pour récupérer les données de product_recommendation
et les affecter à une variable.
1
{% assign items = {{product_recommendation.${recommendation_name}}} %}
Remplacez les éléments suivants :
Marque substitutive | Description |
---|---|
recommendation_name |
Le nom de la recommandation d’intelligence artificielle que vous avez créée dans Braze. |
items |
Variable contenant le tableau des éléments recommandés. |
Ensuite, faites référence à des éléments spécifiques et à leurs champs en utilisant l’indexation de tableau et la notation par points :
1
2
{% assign items = {{product_recommendation.${recommendation_name}}} %}
{{ items[0].name }} for {{ items[0].price }}
Pour inclure plusieurs éléments, faites référence à chaque élément individuellement par son index. .name
et .price
tirent le champ correspondant du catalogue.
1
2
3
4
{% assign items = {{product_recommendation.${recommendation_name}}} %}
{{ items[0].name }} for {{ items[0].price }}
{{ items[1].name }} for {{ items[1].price }}
{{ items[2].name }} for {{ items[2].price }}
Les recommandations de l’intelligence artificielle renvoient plusieurs produits sous la forme d’un tableau, où items[0]
est le premier article, items[1]
le deuxième, et ainsi de suite. Si une recommandation ne renvoie qu’un seul élément, toute tentative de référence à items[1]
aboutira à un champ vide.
Étape 2 : Référencez une image (facultatif)
Si le catalogue que vous recommandez comporte des liens vers des images, vous pouvez y faire référence dans votre message.
Dans l’éditeur par glisser-déposer de l’e-mail, ajoutez un bloc d’image à votre e-mail, puis sélectionnez le bloc d’image pour ouvrir les propriétés de l’image.
Basculez sur Image with Liquid, puis ajoutez ce qui suit au champ Dynamic URL :
1
2
{% assign items = {{product_recommendation.${recommendation_name}}} %}
{{ items[0].image_url_field }}
Remplacez les éléments suivants :
Marque substitutive | Description |
---|---|
recommendation_name |
Le nom de votre recommandation. |
image_url_field |
Le nom du champ de votre catalogue qui contient les URL des images. |
Pour inclure une image substitutive dans vos e-mails de prévisualisation et de test, sélectionnez Choisir une image, puis choisissez une image dans votre bibliothèque multimédia ou saisissez l’URL d’une image sur votre site d’hébergement.
Pour les références d’images HTML, définissez l’attribut image src
sur le champ URL de l’image dans le catalogue. Vous pouvez utiliser un autre champ, tel que le nom ou la description d’un produit, comme texte alt.
1
2
{% assign items = {{product_recommendation.${recommendation_name}}} %}
<img src="{{ items[0].image_url_field }}" alt="{{ items[0].name }}">
Remplacez les éléments suivants :
Marque substitutive | Description |
---|---|
recommendation_name |
Le nom de votre recommandation. |
image_url_field |
Le nom du champ de votre catalogue qui contient les URL des images. |