Utilisation des catalogues

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

Utilisation de catalogues dans un message

Étape 1 : Ajouter un type de personnalisation

Dans le composeur de messages de votre choix, sélectionnez l’icône plus pour ouvrir la fenêtre modale/boîte de dialogue de l ‘ajout de personnalisation et sélectionnez Articles de catalogue pour le type de personnalisation. Sélectionnez ensuite votre nom de catalogue. En reprenant l’exemple précédent, nous allons sélectionner le catalogue “Jeux”.

!

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

1
{% catalog_items Games %}

Étape 2 : Sélectionnez les articles du catalogue

Ensuite, il est temps d’ajouter les articles de votre 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 que vous avez téléchargé et qui a été utilisé pour générer votre catalogue.

Par exemple, pour référencer le titre et le prix de notre jeu Tales, nous pourrions sélectionner le site id pour Tales (1234) comme élément de 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 }}!

Le résultat est le suivant :

Obtenez Tales pour seulement 7.49 !

Exporter des catalogues

Vous pouvez exporter des catalogues à partir du 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 Aperçu du catalogue.

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

Autres cas d’utilisation

Plusieurs articles

Vous n’êtes pas limité à un seul élément dans un seul message. Vous pouvez utiliser la fenêtre modale/boîte de dialogue de personnalisation pour ajouter jusqu’à trois éléments de catalogue à la fois. Pour ajouter d’autres éléments à votre message, sélectionnez Ajouter une personnalisation dans le compositeur de message et sélectionnez les éléments et informations supplémentaires du catalogue à afficher.

Dans cet exemple, nous ajoutons le site id de trois jeux, Tales, Teslagrad et Acaratus, pour les articles du catalogue et nous sélectionnons title pour les informations à afficher.

!

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

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

Le résultat est le suivant :

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

Utilisation des relevés liquides if

Vous pouvez utiliser des éléments de catalogue pour créer des instructions conditionnelles. Par exemple, vous pouvez déclencher l’affichage d’un certain message lorsqu’un article spécifique est sélectionné dans votre campagne.

Pour ce faire, vous utiliserez une déclaration Liquid if, comme dans cet exemple :

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 less than 10 characters. 
{% else %} 
{% abort_message(no venue_name) %} 
{% endif %}

Dans cet exemple, des messages différents s’afficheront si l’attribut personnalisé venue_name comporte plus de 10 caractères ou moins de 10 caractères. Si venue_name est blank, rien ne s’affichera.

Notez que vous devez déclarer la liste du catalogue et, le cas échéant, la sélection avant d’utiliser les instructions if. Dans l’exemple, item-list est la liste du catalogue et selections est le nom de la sélection.

Utilisation d’images

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

Par exemple, pour ajouter le site image_link de notre catalogue de jeux à notre message promotionnel pour les Contes, sélectionnez le site id pour le champ Articles du catalogue et image_link pour le champ Informations à afficher. Cela ajoute les étiquettes Liquid suivantes à notre champ d’image :

1
2
3
{% catalog_items Games 1234 %}

{{ items[0].image_link }}

!Compositeur de la carte de contenu avec l’étiquette Liquid du catalogue utilisée dans le champ de l’image.

Voici ce que cela donne lorsque le liquide est rendu :

!Exemple de carte de contenu avec rendu des étiquettes Liquid du catalogue.

Modélisation des éléments du catalogue

Vous pouvez également utiliser le modèle pour extraire dynamiquement des éléments du catalogue en fonction d’attributs personnalisés. Par exemple, supposons 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 à Liquid Templating, vous pouvez extraire dynamiquement les ID des listes de souhaits et les utiliser dans votre message. Pour ce faire, affectez une variable à votre attribut personnalisé, puis utilisez la fenêtre modale/boîte de dialogue de personnalisation pour extraire un élément spécifique du tableau. Les variables référencées comme l’ID de l’article du catalogue doivent être placées entre crochets pour être référencées correctement, comme ``.

Par exemple, pour informer un utilisateur que Tales (un article de notre catalogue qu’il a désiré) est en vente, nous pouvons ajouter ce qui suit à notre compositeur de messages :

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

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

qui s’affichera comme suit :

Obtenez Tales maintenant, pour seulement 7.49 !

Grâce à la création de modèles, vous pouvez afficher un article de 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 pouvant faire l’objet d’un modèle.

Téléchargement d’un fichier CSV

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

Utilisation du liquide

Vous pouvez également composer manuellement des catalogues avec la logique Liquid. Notez toutefois que si vous saisissez un ID qui n’existe pas, Braze renverra toujours un tableau d’objets sans objets. Nous vous recommandons d’inclure une gestion des erreurs, par exemple en vérifiant la taille du tableau et en utilisant une instruction if pour tenir compte du cas d’un tableau vide.

Templating catalog items including Liquid

Comme pour le contenu connecté, vous devez utiliser l’indicateur :rerender dans une étiquette Liquid pour rendre le contenu Liquid d’un article de catalogue. Notez que l’indicateur :rerender ne s’applique qu’à un seul niveau, ce qui signifie qu’il ne s’appliquera pas aux appels d’étiquettes Liquid imbriqués.

Si un article de catalogue contient des champs de profil d’utilisateur (dans une étiquette Liquid de personnalisation), ces valeurs doivent être définies dans Liquid plus tôt dans le message et avant la mise en page pour que le rendu de Liquid soit correct. Si le drapeau :rerender n’est pas fourni, le contenu brut du liquide sera rendu.

Par exemple, si un catalogue nommé “Messages” possède un article avec ce Liquid :

!

Pour rendre le contenu liquide suivant :

1
2
3
4
Hi ${first_name}

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

L’affichage est le suivant :

1
2
3
Hi Peter,

Welcome to our store, Peter!

[1] : /docs/fr/assets/img_archive/use_catalog_personalization.png?362644459eb9e05831c96632c4c703fb [2] : /docs/fr/assets/img_archive/catalog_multiple_items.png?fc8380c2670e9d911306fcbdf7429824