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

Étape 1 : Ajouter un type de personnalisation

Dans l’éditeur de message de votre choix, sélectionnez l’icône « + » pour ouvrir la fenêtre modale Ajouter une personnalisation, puis sélectionnez Éléments du catalogue comme type de personnalisation. 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 Catalogues. Sélectionnez ensuite le bouton Exporter le catalogue.
• Sélectionnez votre catalogue. Ensuite, sélectionnez le bouton Exporter le catalogue dans l’onglet Prévisualiser 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 Ajouter une personnalisation pour ajouter jusqu’à trois éléments du catalogue à la fois. Pour en ajouter davantage, sélectionnez à nouveau Ajouter une personnalisation 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 les éléments du catalogue et nous sélectionnons title pour les informations à afficher.

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!

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.

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 Éléments du catalogue et image_link pour le champ Informations à afficher. Ceci ajoute les étiquettes 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 :

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"]
        }
    ]
}

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 Ajouter une personnalisation 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 ``.

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 étiquette 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 d’étiquettes Liquid imbriqués.

Si un élément du catalogue contient des champs de profil utilisateur (dans une étiquette 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!

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 l’étiquette 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.