Création d’un catalogue

La création d’un catalogue implique l’importation d’un fichier CSV de données non-utilisateurs dans Braze. Cela vous permet ensuite d’accéder à ces informations pour enrichir vos messages. Vous pouvez ajouter n’importe quel type de données à un catalogue. Ces données sont généralement des métadonnées de votre entreprise, telles que des informations sur les produits pour une entreprise de commerce électronique ou des informations sur les cours pour un prestataire de services éducatifs.

Voici quelques exemples d’utilisation courante des catalogues :

• Produits
• Services
• Alimentation
• Événements à venir
• Musique
• Emballages

Une fois ces informations importées, vous pouvez commencer à y accéder dans les messages de la même manière que pour accéder aux attributs personnalisés ou aux propriétés d’événements personnalisés via Liquid.

Préparer votre fichier CSV

Avant de créer un catalogue, veillez à préparer votre fichier CSV si votre méthode de création de catalogue préférée est le téléchargement.

Lignes directrices pour les fichiers CSV

Notez ces directives lors de la création de votre fichier CSV. La première colonne du fichier CSV doit être un en-tête de idet chaque article id doit être unique. Tous les autres noms de colonnes doivent être uniques. En outre, les limitations suivantes s’appliquent aux fichiers CSV du catalogue :

• Maximum de 1 000 champs (colonnes)
• Nom maximum de champ (colonne) de 250 caractères
• Maximum 100 Mo pour tous les fichiers CSV combinés dans votre entreprise (gratuit)
• Taille maximale du fichier CSV : 2 Go (Pro)
• Valeur maximale de champ (cellule) de 5 000 caractères
• Seuls les lettres, chiffres, traits d’union et traits de soulignement pour id et des valeurs d’en-tête

Nous vous recommandons également de formater tout le texte de vos fichiers CSV en minuscules. Assurez-vous d’encoder votre fichier CSV au format UTF-8 afin de pouvoir le télécharger avec succès à l’étape suivante.

Sélectionner votre méthode

Pour créer un catalogue, allez dans Paramètres des données > Catalogues.

Sélectionnez Créer un catalogue, puis choisissez de charger un fichier CSV ou de créer dans le navigateur.

Méthode 1 : Charger un fichier CSV

1. Glissez-déposez votre fichier dans la zone de chargement, ou cliquez sur Charger un fichier CSV et choisissez votre fichier.
   
   
   
2. Sélectionnez l’un des types de données suivants pour chaque colonne : booléen, nombre, chaîne de caractères ou temps.
   
   
   
3. Nommez votre catalogue. Gardez à l’esprit les exigences suivantes pour le nom du catalogue :
   • Doit être unique
   • Maximum de 250 caractères
   • Peut uniquement inclure des chiffres, des lettres, des traits d’union et des traits de soulignement
     
     
4. (facultatif) Ajoutez une description pour le catalogue.
5. Cliquez sur Traiter le catalogue pour créer le catalogue.

Vous pouvez également utiliser des modèles dans le nom d’un catalogue. Par exemple, vous pouvez utiliser les éléments suivants :

1
2
3
4
{% assign language = "content_spanish" %}

{% catalog_items {{language}} fall_campaign %}
{{ items[0].body }}

Vous pouvez également mettre à jour le fichier CSV après avoir choisi de créer un catalogue dans le navigateur. Cliquez sur Mettre à jour le catalogue > Charger un fichier CSV, puis choisissez de mettre à jour, d’ajouter ou de supprimer des produits dans votre catalogue.

Méthode 2 : Créer dans le navigateur

1. Saisissez un nom pour votre catalogue. Gardez à l’esprit les exigences suivantes pour le nom de votre catalogue :
   • Doit être unique
   • Jusqu’à 250 caractères
   • Peut uniquement inclure des chiffres, des lettres, des traits d’union et des traits de soulignement
     
     
     
2. (facultatif) Saisissez une description de votre catalogue.
3. Sélectionnez le catalogue que vous venez de créer dans la page Catalogues de la liste pour mettre à jour votre catalogue.
4. Sélectionnez Mettre à jour le catalogue > Ajouter des champs pour ajouter vos champs. Saisissez ensuite le nom du champ et utilisez le menu déroulant pour sélectionner le type de données. Répétez l’opération en fonction de vos besoins.
   
   
   
5. Sélectionnez Mettre à jour le catalogue > Ajouter des éléments pour ajouter un élément à votre catalogue en saisissant les informations basées sur les champs que vous avez précédemment ajoutés. Ensuite, sélectionnez Enregistrer l’élément ou Enregistrer et ajouter un autre élément pour continuer à ajouter vos éléments.
   

Vous pouvez également télécharger un fichier CSV après avoir choisi de créer un catalogue dans le navigateur.

Tutoriel : Création d’un catalogue à partir d’un fichier CSV

Pour ce didacticiel, nous utilisons un catalogue qui répertorie deux jeux, leur coût et un lien d’image.

Nous allons créer le catalogue en téléchargeant un fichier CSV. Les types de données pour id, title, price et image_link sont respectivement une chaîne de caractères, une chaîne de caractères, un nombre et une chaîne de caractères.

Ensuite, nous appellerons ce catalogue « games_catalog » et cliquerons sur le bouton Traiter le catalogue. Braze vérifie alors que le catalogue ne contient pas d’erreurs avant de le créer.

Notez que vous ne pourrez pas modifier ce nom après la création du catalogue. Vous pouvez supprimer un catalogue et télécharger à nouveau une version mise à jour en utilisant le même nom de catalogue.

Après avoir créé le catalogue, vous pouvez commencer à y faire référence dans une campagne.

Gérer les catalogues via l’API

Au fur et à mesure que vous créez des catalogues, vous pouvez également utiliser l’endpoint Lister des catalogues pour obtenir la liste des catalogues d’un espace de travail.

Gérer les articles du catalogue

En plus de gérer vos catalogues, vous pouvez également utiliser des endpoints synchrones et asynchrones pour gérer les articles du catalogue. Ils comprennent la possibilité d’modifier et de supprimer des articles du catalogue ainsi que d’afficher les détails d’un d’eux.

Par exemple, si vous souhaitez modifier un produit de catalogue spécifique, vous pouvez utiliser l’endpoint /catalogs/catalog_name/items/item_id.

Niveaux du catalogue

Le tableau suivant décrit les différences entre la version gratuite et la version pro des catalogues :

Stockage du catalogue

Version gratuite

La taille de stockage pour la version gratuite des catalogues est de 100 Mo maximum. Vous disposez d’un nombre illimité de produits, tant que cela ne dépasse pas 100 Mo. Les sélections contribueront à votre stockage. Plus une sélection est complexe, plus elle occupera de place. Il y aura également un décalage de taille entre les données du catalogue CSV et la représentation de ces données dans notre magasin de données.

Catalogues Pro

Au niveau de l’entreprise, le stockage maximum pour Catalogues Pro est basé sur la taille des données du catalogue. Les options de taille de stockage sont les suivantes : 5 Go, 10 Go ou 15 Go. Notez que l’espace de stockage de la version gratuite (100 Mo) est inclus dans chacun de ces plans.