Créer un catalogue
La création d’un catalogue consiste à importer un fichier CSV de données non-utilisateurs dans Braze. Vous pouvez ensuite accéder à ces informations pour enrichir vos messages. N’importe quel type de données peut être intégré à un catalogue. Il s’agit généralement de métadonnées provenant de votre entreprise, comme des informations produits pour un site e-commerce ou des informations sur les cours pour un fournisseur de formation.
Cas d’usage
Voici quelques cas d’usage courants pour les catalogues :
- Produits
- Services
- Alimentation
- Événements à venir
- Musique
- Forfaits
Une fois ces informations importées, vous pouvez y accéder dans vos messages, de la même manière que vous accédez aux attributs personnalisés ou aux propriétés d’événement personnalisé avec Liquid.
Types de données pris en charge
Le tableau suivant répertorie les types de données de catalogue pris en charge et la manière dont ils peuvent être créés ou mis à jour.
| Type de données | Description | Disponible via import CSV | Disponible via API et CDI |
|---|---|---|---|
| Chaîne de caractères | Une séquence de caractères. | ✅ Oui | ✅ Oui |
| Nombre | Une valeur numérique, entière ou décimale. | ✅ Oui | ✅ Oui |
| Valeur booléenne | Une valeur true ou false. |
✅ Oui | ✅ Oui |
| Date | Une chaîne de caractères au format ISO 8601. | ✅ Oui | ✅ Oui |
| Géolocalisation | Un tableau de coordonnées [longitude, latitude]. La latitude doit être comprise entre -90 et 90 ; la longitude doit être comprise entre -180 et 180. Par exemple, [-73.988103, 40.779109]. |
✅ Oui | ✅ Oui |
| Objet JSON | Un objet imbriqué avec des paires clé-valeur. Peut être affiché dans la plateforme, mais ne peut être créé ou mis à jour que via l’API ou le CDI. | ⛔ Non | ✅ Oui |
| Tableau de chaînes de caractères | Une liste de chaînes de caractères. Peut être affiché dans la plateforme, mais ne peut être créé ou mis à jour que via l’API ou le CDI. Maximum de 100 éléments. | ⛔ Non | ✅ Oui |
Création d’un catalogue
Pour créer un catalogue, accédez à Paramètres des données > Catalogues, puis sélectionnez Créer un nouveau catalogue et choisissez l’une des options suivantes :
Étape 1 : Vérifier votre fichier CSV
Avant d’importer votre fichier CSV, assurez-vous qu’il respecte les exigences suivantes :
| Exigence CSV | Détails |
|---|---|
| En-têtes | La première colonne du fichier CSV doit s’appeler id, et chaque ligne doit avoir une valeur id unique. |
| Colonnes | Un fichier CSV peut contenir jusqu’à 1 000 champs (colonnes), et chaque nom de colonne peut comporter jusqu’à 250 caractères. |
| Taille du fichier | Pour les offres Free, la taille totale de tous les fichiers CSV d’une entreprise est limitée à 500 Mo. Pour les offres Pro, la taille maximale d’un fichier CSV est de 2 Go. |
| Valeurs des champs | Chaque cellule (valeur de champ) peut contenir jusqu’à 5 000 caractères. |
| Caractères valides | La colonne id et toutes les valeurs d’en-tête ne peuvent contenir que des lettres, des chiffres, des traits d’union et des traits de soulignement. |
| Types de données | Les types de données pris en charge pour les importations CSV sont : chaîne de caractères, nombre, booléen, heure et géolocalisation. Pour obtenir la liste complète des types de données, y compris ceux disponibles uniquement via l’API et CDI, consultez Types de données pris en charge. |
| Mise en forme | Mettez tout le texte en minuscules pour garantir la cohérence. |
| Encodage | Enregistrez et importez le fichier CSV avec l’encodage UTF-8. |

Besoin de plus d’espace pour vos fichiers CSV ? Contactez votre gestionnaire de compte Braze pour en savoir plus sur la mise à niveau de vos catalogues.
Étape 2 : Importer le CSV
Glissez-déposez votre fichier dans la zone d’importation, ou sélectionnez Importer un CSV et choisissez votre fichier.

Sélectionnez un type de données pour chaque colonne.

Ce type de données ne peut plus être modifié une fois votre catalogue configuré. De plus, la valeur NULL n’est pas prise en charge lors de l’importation CSV et sera traitée comme une chaîne de caractères.

Saisissez un nom et, si vous le souhaitez, une description pour votre catalogue. Gardez à l’esprit les exigences suivantes lorsque vous nommez votre catalogue :
- Il doit être unique
- 250 caractères maximum
- Il ne peut contenir que des chiffres, des lettres, des traits d’union et des traits de soulignement

Vous pouvez également utiliser des modèles dans le nom d’un catalogue afin de générer dynamiquement des noms de catalogue à partir de variables comme la langue ou la Campaign.

Sélectionnez Traiter le catalogue pour créer le catalogue.

Braze rejette votre fichier CSV s’il ne respecte pas les exigences CSV de l’étape 1, comme l’en-tête id, des ID d’éléments uniques et valides, les limites de colonnes, l’encodage UTF-8 et les limites de taille de votre niveau. Si votre fichier CSV a été rejeté, vérifiez à nouveau ces exigences et importez-le de nouveau. Pour les problèmes de Liquid ou de personnalisation après une importation réussie, consultez Résolution des problèmes de personnalisation des catalogues.
Tutoriel : Créer un catalogue à partir d’un fichier CSV
Dans ce tutoriel, nous utilisons un catalogue qui répertorie deux jeux, leur prix et un lien vers une image.
| id | title | price | image_link |
|---|---|---|---|
| 1234 | Tales | 7.49 | https://picsum.photos/200 |
| 1235 | Regeneration | 22.49 | https://picsum.photos/200 |
Nous allons créer le catalogue en important un fichier CSV. Les types de données de id, title, price et image_link sont respectivement chaîne de caractères, chaîne de caractères, nombre et chaîne de caractères.

Ce type de données ne peut plus être modifié une fois votre catalogue configuré.

Ensuite, nous allons nommer ce catalogue « games_catalog » et sélectionner le bouton Traiter le catalogue. Braze vérifiera alors que le catalogue ne contient aucune erreur avant de le créer.

Notez que vous ne pourrez plus modifier ce nom une fois le catalogue créé. Vous pouvez supprimer un catalogue et réimporter une version mise à jour sous le même nom.
Une fois le catalogue créé, vous pouvez commencer à référencer le catalogue dans une Campaign.

Les fichiers CSV importés précédemment peuvent être téléchargés depuis la page Catalogues pendant 30 jours après leur date d’importation. Passé ce délai, le fichier est définitivement supprimé et n’est plus accessible.
Types de données des catalogues
Les catalogues prennent en charge différents types de données pour vous aider à organiser et à structurer efficacement vos données. Le tableau suivant décrit chaque type de données pris en charge et sa correspondance avec les noms de types utilisés dans les fichiers CSV et l’API :
| Type de données | Format | Exemple | Description |
|---|---|---|---|
| Chaîne de caractères | Texte | "Hello World" |
Toute séquence de caractères utilisée pour des données textuelles telles que des noms, des descriptions et des ID. Équivaut au type string dans les importations CSV et API. |
| Heure | ISO 8601 ou horodatage Unix (en secondes) | "2024-03-15T14:30:00Z" |
Valeurs de date et d’heure au format ISO 8601 ou sous forme d’horodatage Unix en secondes. Équivaut au type time dans l’API et au type datetime dans les importations CSV. |
| Booléen | true ou false |
true |
Valeurs logiques représentant un état vrai ou faux. Équivaut au type boolean dans les importations CSV et API. |
| Nombre | Entier ou décimal | 42 ou 19.99 |
Valeurs numériques, y compris les entiers et les nombres à virgule flottante, pour les prix, les quantités, les notes, etc. Équivaut aux types integer et float dans les importations CSV et au type number dans l’API. |
| Géolocalisation | Tableau [longitude, latitude] |
[-73.988103, 40.779109] |
Paire de coordonnées représentant un emplacement géographique. La longitude doit être comprise entre -180 et 180 ; la latitude doit être comprise entre -90 et 90. La valeur type dans l’API est geo. Ce type peut être ajouté via le volet Ajouter des champs de l’interface des catalogues, par importation CSV ou via la REST API. |
| Objet | Objet JSON | {"key": "value", "price": 10} |
Structures de données imbriquées complexes. La valeur type dans l’API est object. S’affiche comme Objet JSON dans le tableau de bord. Disponible uniquement via l’API ou l’ingestion de données cloud (CDI). |
| Tableau | Tableau de chaînes de caractères | ["red", "blue", "green"] |
Listes de valeurs de chaînes de caractères. La valeur type dans l’API est array. S’affiche comme Tableau de chaînes dans le tableau de bord. Disponible uniquement via l’API ou la CDI. |
Utilisation de modèles dans les noms de catalogues
Lorsque vous nommez votre catalogue, vous pouvez également utiliser des modèles dans le nom du catalogue. Cela vous permet de générer dynamiquement des noms de catalogues en fonction de variables telles que la langue ou la campagne. Par exemple :
{% assign language = "content_spanish" %}
{% catalog_items {{language}} fall_campaign %}
{{ items[0].body }}
Gestion des catalogues
Dans le tableau de bord
Pour mettre à jour votre catalogue après avoir téléversé un fichier CSV ou créé un catalogue dans le navigateur, sélectionnez Mettre à jour le catalogue > Téléverser un CSV, puis choisissez si vous souhaitez mettre à jour, ajouter ou supprimer des éléments de votre catalogue.
Avec la REST API
À mesure que vous créez des catalogues, vous pouvez également utiliser l’endpoint Lister les catalogues pour obtenir la liste des catalogues d’un espace de travail.
La REST API prend en charge tous les types de données de catalogue, y compris les objets JSON et les tableaux de chaînes de caractères. Les objets JSON et les tableaux de chaînes de caractères ne peuvent être créés ou mis à jour que via la REST API.
Avec l’ingestion de données cloud
Vous pouvez gérer vos catalogues avec l’ingestion de données cloud en synchronisant les données de catalogue directement depuis votre entrepôt de données (comme Snowflake, Redshift, BigQuery, Databricks, Microsoft Fabric ou S3) selon une planification.
Gestion des éléments de catalogue
En plus de gérer vos catalogues, vous pouvez utiliser des endpoints asynchrones et synchrones pour gérer les éléments de catalogue. Vous pouvez ainsi modifier et supprimer des éléments de catalogue, ou encore lister les détails des éléments de catalogue.
Par exemple, pour modifier un élément de catalogue individuel, utilisez l’endpoint /catalogs/catalog_name/items/item_id.
Stockage des catalogues
La version gratuite des catalogues prend en charge des fichiers CSV d’une taille totale combinée de 500 Mo pour l’ensemble de votre entreprise, tandis que la version Catalogues Pro prend en charge des fichiers CSV d’une taille maximale de 2 Go par fichier.

Les droits d’utilisation des packages affichés dans le tableau de bord de Braze sont arrondis à l’unité la plus proche à des fins d’affichage. Vous conservez toutefois l’intégralité des droits d’utilisation achetés. Pour demander une mise à niveau du stockage des catalogues, contactez votre gestionnaire de compte Braze.
Version gratuite
La taille de stockage pour la version gratuite des catalogues est de 500 Mo maximum. Vous pouvez avoir un nombre illimité d’éléments tant qu’ils ne dépassent pas 500 Mo au total.
Catalogues Pro
Au niveau de l’entreprise, le stockage maximum pour Catalogues Pro dépend de la taille des données du catalogue. Les options de taille de stockage sont les suivantes : 5 Go, 10 Go ou 15 Go. L’espace de stockage de la version gratuite (500 Mo) est inclus dans chacun de ces plans.
Spécifications
Le tableau suivant résume les spécifications applicables au contenu des catalogues.
| Domaine | Spécifications |
|---|---|
| Caractères d’une valeur d’article | Jusqu’à 5 000 caractères dans une seule valeur. Par exemple, si vous avez un champ intitulé description, le nombre maximal de caractères dans ce champ est de 5 000. |
| Caractères d’un nom de colonne d’article | Jusqu’à 250 caractères |
| Sélections par catalogue | Jusqu’à 30 sélections par catalogue |

Les étiquettes Liquid de catalogue ne peuvent pas être utilisées de manière récursive : vous ne pouvez pas référencer un article de catalogue qui appelle ensuite un second article de catalogue au sein de la même évaluation Liquid.

