Utilisation des catalogues

Après avoir créé un catalogue, vous pouvez référencer des données non-utilisateurs dans vos campagnes Braze via Liquid. Les catalogues sont utilisables dans tous vos canaux de communication, y compris partout dans l’éditeur par glisser-déposer où Liquid est pris en charge.

Utiliser des catalogues dans un message

La vidéo suivante explique comment utiliser les catalogues dans un message.

Étape 1 : Ajouter un type de personnalisation

Dans l’éditeur de message de votre choix, sélectionnez Add Personalization et sélectionnez Catalog Items pour le Personalization type. Sélectionnez ensuite le nom de votre catalogue. En reprenant l’exemple précédent, nous allons sélectionner le catalogue « Games ».

Nous pouvons immédiatement voir l’aperçu Liquid suivant :

1
{% catalog_items Games %}

Étape 2 : Sélectionner les éléments du catalogue

Il est maintenant temps d’ajouter vos éléments de catalogue ! À l’aide de la liste déroulante, sélectionnez les éléments du catalogue et les informations à afficher. Ces informations correspondent aux colonnes du fichier CSV importé utilisé pour générer votre catalogue.

Par exemple, pour référencer le titre et le prix de notre jeu Tales, nous pouvons sélectionner l’id de Tales (1234) comme élément du catalogue et demander title et price pour les informations affichées.

1
2
3
{% catalog_items Games 1234 %}

Get {{ items[0].title }} for just {{ items[0].price }}!

Ceci donne le résultat suivant :

Get Tales for just 7.49!

Exporter des catalogues

Vous pouvez exporter des catalogues depuis le tableau de bord de deux manières :

• Survolez la ligne du catalogue dans la section Catalogs. Sélectionnez ensuite le bouton Export catalog.
• Sélectionnez votre catalogue. Ensuite, sélectionnez le bouton Export catalog dans l’onglet Preview du catalogue.

Vous recevrez un e-mail pour télécharger le fichier CSV après avoir lancé l’exportation. Vous disposerez de quatre heures pour récupérer ce fichier.

Cas d’utilisation supplémentaires

Plusieurs éléments

Vous n’êtes pas limité à un seul élément par message. Utilisez la fenêtre modale Add Personalization pour ajouter jusqu’à trois éléments du catalogue à la fois. Pour en ajouter davantage, sélectionnez à nouveau Add Personalization dans l’éditeur, puis choisissez les éléments supplémentaires du catalogue et les informations à afficher.

Dans cet exemple, nous ajoutons l’id de trois jeux — Tales, Teslagrad et Acaratus — pour Catalog Items et nous sélectionnons title pour Information to Display.

Nous pouvons personnaliser davantage notre message en ajoutant du texte autour de notre Liquid :

1
2
Get the ultimate trio {% catalog_items Games 1234 1235 1236 %}
{{ items[0].title }}, {{ items[1].title }}, and {{ items[2].title }} today!

Ceci donne le résultat suivant :

Get the ultimate trio Tales, Teslagrad, and Acaratus today!

Conseil

Check out selections to create groups of data for more personalized messaging!

Using Liquid if statements

You can use catalog items to create conditional statements. For example, you can trigger a certain message to display when a specific item is selected in your campaign. You must declare the catalog (and, if applicable, the selection) before referencing items in an if statement.

With catalog items

1
2
3
4
5
6
{% catalog_items Games 1234 %}
{% if items[0].on_sale == true %}
  {{ items[0].title }} is on sale! Get it for {{ items[0].price }}.
{% else %}
  Check out {{ items[0].title }} at full price.
{% endif %}

Dans cet exemple, la balise catalog_items récupère l’élément 1234 du catalogue Games, puis l’instruction if vérifie le champ on_sale pour afficher différents messages.

Avec des sélections de catalogue

1
2
3
4
5
6
7
8
{% catalog_selection_items item-list selections %}
{% if items[0].venue_name.size > 10 %}
Message if the venue name's size is more than 10 characters.
{% elsif items[0].venue_name.size <= 10 %}
Message if the venue name's size is 10 characters or fewer.
{% else %}
{% abort_message('no venue_name') %}
{% endif %}

Dans cet exemple, différents messages s’affichent selon que le champ venue_name contient plus ou moins de 10 caractères. Si venue_name est vide, le message est interrompu.

Pour afficher le nombre d’éléments renvoyés par une sélection, utilisez le filtre Liquid size sur le tableau items après la balise, et non sur un champ individuel :

1
{% catalog_selection_items item-list selections %}{{ items | size }}

Conseil

Pour éviter les erreurs de syntaxe Liquid, sélectionnez le bouton + dans l’éditeur de message pour insérer automatiquement les balises Liquid de catalogue.

Utiliser des images

Vous pouvez également référencer des images du catalogue pour les utiliser dans vos messages. Pour ce faire, utilisez la balise catalogs et l’objet item dans le champ Liquid pour les images.

Par exemple, pour ajouter le image_link de notre catalogue Games à notre message promotionnel pour Tales, sélectionnez l’id pour le champ Catalog Items et image_link pour le champ Information to Display. Ceci ajoute les balises Liquid suivantes à notre champ d’image :

1
2
3
{% catalog_items Games 1234 %}

{{ items[0].image_link }}

Voici à quoi cela ressemble une fois le Liquid rendu :

Important

Dans les canaux HTML tels que l’e-mail, évitez les espaces ou sauts de ligne supplémentaires entre la balise de fermeture {% catalog_items ... %} et le Liquid qui affiche l’URL de l’image (par exemple, {{ items[0].image_link }}). Les espaces supplémentaires dans le modèle peuvent empêcher la résolution correcte de l’URL de l’image dans le message rendu. Gardez l’expression d’URL immédiatement adjacente à la balise du catalogue, comme ceci : <img src="{% catalog_items Games 1234 %}{{ items[0].image_link }}">.

Modèles d’éléments de catalogue

Vous pouvez également utiliser les modèles pour extraire dynamiquement des éléments du catalogue en fonction d’attributs personnalisés. Par exemple, imaginons qu’un utilisateur possède l’attribut personnalisé wishlist, qui contient un tableau d’ID de jeux de votre catalogue.

1
2
3
4
5
6
7
8
{
    "attributes": [
        {
            "external_id": "user_id",
            "wishlist": ["1234", "1235"]
        }
    ]
}

Remarque

Les objets JSON dans les catalogues ne sont ingérés que via l’API. Vous ne pouvez pas importer un objet JSON à l’aide d’un fichier CSV.

Grâce au modèle Liquid, vous pouvez extraire dynamiquement les ID de la liste de souhaits, puis les utiliser dans votre message. Pour ce faire, affectez une variable à votre attribut personnalisé, puis utilisez la fenêtre modale Add Personalization pour extraire un élément spécifique du tableau. Les variables référencées comme ID d’élément du catalogue doivent être placées entre accolades pour être correctement référencées, comme ``.

Conseil

N’oubliez pas que les tableaux commencent à 0 et non à 1.

Par exemple, pour informer un utilisateur que Tales (un élément de notre catalogue qu’il a ajouté à ses souhaits) est en promotion, nous pouvons ajouter ce qui suit à notre éditeur de message :

1
2
3
4
{% assign wishlist = {{custom_attribute.${wishlist}}}%}
{% catalog_items Games {{ wishlist[0] }} %}

Get {{ items[0].title }} now for {{ items[0].price }}!

Ce qui s’affichera comme suit :

Get Tales now for just 7.49!

Avec les modèles, vous pouvez afficher un élément du catalogue différent pour chaque utilisateur en fonction de ses attributs personnalisés, de ses propriétés d’événement ou de tout autre champ modélisable.

Importer un CSV

Vous pouvez importer un fichier CSV contenant de nouveaux éléments de catalogue à ajouter ou des éléments existants à mettre à jour. Pour supprimer une liste d’éléments, vous pouvez importer un CSV d’ID d’éléments à supprimer.

Utiliser Liquid

Vous pouvez également composer manuellement des catalogues avec la logique Liquid. Notez cependant que si vous saisissez un ID qui n’existe pas, Braze renverra tout de même un tableau d’éléments sans objet. Nous vous recommandons d’inclure une gestion des erreurs, comme la vérification de la taille du tableau et l’utilisation d’une instruction if pour gérer le cas d’un tableau vide.

Modélisation d’éléments de catalogue incluant du Liquid

Tout comme pour le Contenu connecté, vous devez utiliser le drapeau :rerender dans une balise Liquid pour afficher le contenu Liquid d’un élément du catalogue. Notez que le drapeau :rerender ne s’applique qu’à un seul niveau de profondeur : il ne s’appliquera pas aux appels de balises Liquid imbriquées.

Si un élément du catalogue contient des champs de profil utilisateur (dans une balise de personnalisation Liquid), ces valeurs doivent être définies en Liquid plus tôt dans le message, avant la modélisation, afin de garantir le bon rendu du Liquid. Si le drapeau :rerender n’est pas fourni, le contenu Liquid brut sera restitué.

Par exemple, si un catalogue nommé « Messages » possède un élément avec ce Liquid :

Pour rendre le contenu Liquid suivant :

1
2
3
4
Hi ${first_name},

{% catalog_items Messages greet_msg :rerender %}
{{ items[0].Welcome_Message }}

L’affichage sera le suivant :

1
2
3
Hi Peter,

Welcome to our store, Peter!

Remarque

Les balises Liquid des catalogues ne peuvent pas être utilisées de manière récursive à l’intérieur des catalogues.

Résolution des problèmes de personnalisation des catalogues

Si le Liquid d’un catalogue ou d’une sélection ne s’affiche pas comme prévu dans un message ou une étape Canvas, vérifiez les points suivants :

Pour le comportement général de Liquid, voir Cas d’utilisation Liquid et Utiliser Liquid.

Structurer les données de votre catalogue

Lorsque vous planifiez la structure des données de votre catalogue, partez de votre cas d’utilisation et concevez le catalogue en conséquence. Chaque ligne du catalogue représente un élément (avec un id unique). Les colonnes doivent contenir les attributs de cet élément, tels que les URL, le texte descriptif, les URL d’images, le prix, la note, la taille ou la couleur.

Quand utiliser les appels de catalogue standard

Avec les appels de catalogue standard, vous faites correspondre une valeur à la colonne id. En insérant un attribut personnalisé ou une propriété d’événement (sous forme de chaîne de caractères d’ID) dans la balise Liquid du catalogue, vous pouvez récupérer plusieurs attributs d’un même élément dans votre message. Les cas d’utilisation courants incluent :

• Produit ou service récemment consulté
• Éléments de la liste de souhaits
• Offres par emplacement
• Produit acheté
• Contenu lié à l’étape du cycle de vie
• Produit ou service recherché le plus récemment

Quand utiliser les sélections de catalogue

Les sélections de catalogue vous permettent de filtrer sur n’importe quelle colonne de votre catalogue et de renvoyer jusqu’à 50 éléments correspondants. En insérant des attributs personnalisés ou des propriétés d’événement dans les filtres de sélection, les résultats sont personnalisés pour chaque utilisateur. Les cas d’utilisation courants incluent :

• Éléments dont la catégorie correspond aux préférences de l’utilisateur
• Éléments correspondant à la marque, la cuisine ou la taille préférée de l’utilisateur
• Contenu lié au type d’abonnement ou au niveau de fidélité
• Produits dans la fourchette de valeur moyenne de commande de l’utilisateur

La différence principale est que les appels de catalogue standard recherchent un seul élément connu par id, tandis que les sélections de catalogue interrogent l’ensemble du catalogue et renvoient plusieurs éléments correspondant à vos critères de filtre.