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’utilisation
Les cas d’utilisation courants des catalogues sont les suivants :
- 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 pour les attributs personnalisés ou les propriétés d’événement personnalisé, via 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, rendez-vous dans Paramètres des données > Catalogues, puis sélectionnez Créer un nouveau catalogue et choisissez l’une des options suivantes :
Étape 1 : Vérifiez votre fichier CSV
Avant de télécharger votre fichier CSV, assurez-vous qu’il répond aux exigences suivantes :
| Exigences relatives aux fichiers CSV | Détails |
|---|---|
| En-têtes | La première colonne du fichier CSV doit être nommée id, et chaque ligne doit contenir 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 forfaits gratuits, la taille totale de tous les fichiers CSV d’une entreprise est limitée à 100 Mo. Pour les plans Pro, la taille maximale d’un seul 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 tirets et des traits de soulignement. |
| Types de données | Les types de données pris en charge pour les imports CSV comprennent les chaînes de caractères, les nombres, les booléens, les dates et la géolocalisation. Pour obtenir la liste complète des types de données, y compris ceux disponibles uniquement via l’API et le CDI, consultez la section Types de données pris en charge. |
| Formatage | Formatez tout le texte en minuscules afin de garantir la cohérence. |
| Encodage | Enregistrez et téléchargez le fichier CSV en utilisant l’encodage UTF-8. |
Vous avez 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 : Téléchargez le fichier CSV
Glissez-déposez votre fichier dans la zone de téléchargement ou sélectionnez Upload CSV et choisissez votre fichier.
Sélectionnez un type de données pour chaque colonne.
Ce type de données ne peut pas être modifié après la configuration de votre catalogue. De plus, la valeur NULL n’est pas prise en charge dans l’import CSV et sera traitée comme une chaîne de caractères.
Saisissez un nom et une description facultative pour votre catalogue. Tenez compte des exigences suivantes lorsque vous nommez votre 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
Vous pouvez également utiliser des modèles dans un nom de catalogue, ce qui vous permet de générer dynamiquement des noms de catalogue en fonction de variables telles que la langue ou la campagne.
Sélectionnez Process Catalog pour créer le catalogue.
Votre fichier CSV peut être rejeté si vous dépassez votre seuil.
Tutoriel : Création d’un catalogue à partir d’un fichier CSV
Pour ce tutoriel, nous utilisons un catalogue qui répertorie deux jeux, leur prix et un lien d’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 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.
Ce type de données ne peut pas être modifié après la configuration de votre catalogue.
Ensuite, nous nommerons ce catalogue « games_catalog » et sélectionnerons le bouton Process Catalog. 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 toutefois supprimer un catalogue et en télécharger une version mise à jour en utilisant le même nom.
Après avoir créé le catalogue, vous pouvez commencer à y faire référence dans une campagne.
Conditions préalables
Avant de pouvoir modifier ou créer des catalogues dans le navigateur, vous devez disposer des autorisations utilisateur suivantes pour votre espace de travail :
- View Catalogs
- Edit Catalogs
- Export Catalogs
- Delete Catalogs
Étape 1 : Saisissez les détails du catalogue
Saisissez un nom et une description facultative pour votre catalogue. Tenez compte des exigences suivantes lorsque vous nommez votre 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
Vous pouvez également utiliser des modèles dans un nom de catalogue, ce qui vous permet de générer dynamiquement des noms de catalogue en fonction de variables telles que la langue ou la campagne.
Étape 2 : Créez votre catalogue
Sélectionnez votre catalogue dans la liste, puis choisissez Update Catalog > Add fields. Saisissez le Field name et utilisez le menu déroulant pour sélectionner le type de données. Répétez l’opération autant de fois que nécessaire.
Sélectionnez Update Catalog > Add items pour ajouter un élément à votre catalogue en saisissant les informations dans les champs que vous avez précédemment ajoutés. Ensuite, sélectionnez Save Item ou Save and Add Another pour continuer à ajouter vos éléments.
Braze traite les valeurs temporelles sur la base de l’horodatage du tableau de bord. Par exemple, si une colonne a pour valeur « 03/13/2024 » et que votre fuseau horaire est celui du Pacifique, cette heure sera importée dans Braze sous la forme « 12 mars 2024, 17 h 00 ».
Types de données de catalogue
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 la correspondance avec les noms de types CSV et 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 identifiants. Équivalent au type string dans les imports CSV et API. |
| Date | ISO 8601 ou horodatage Unix (secondes) | "2024-03-15T14:30:00Z" |
Valeurs de date et d’heure au format ISO 8601 ou horodatage Unix en secondes. Équivalent au type time dans l’API et au type datetime dans les imports CSV. |
| Valeur booléenne | true ou false |
true |
Valeurs logiques représentant les états vrai ou faux. Équivalent au type boolean dans les imports CSV et API. |
| Nombre | Entier ou décimal | 42 ou 19.99 |
Valeurs numériques comprenant les entiers et les nombres à virgule flottante pour les prix, les quantités, les notes, etc. Équivalent aux types integer et float dans les imports CSV et au type number dans l’API. |
| Géolocalisation | Tableau [longitude, latitude] |
[-73.988103, 40.779109] |
Une 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 de l’API est geo. Peut être ajoutée via le tiroir Add Fields dans l’interface des catalogues, l’import CSV ou la REST API. |
| Objet | Objet JSON | {"key": "value", "price": 10} |
Structures de données imbriquées complexes. La valeur type de l’API est object. Affiché 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 type chaîne de caractères. La valeur type de l’API est array. Affiché comme tableau de chaînes de caractères dans le tableau de bord. Disponible uniquement via l’API ou le 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 :
1
2
3
4
{% assign language = "content_spanish" %}
{% catalog_items {{language}} fall_campaign %}
{{ items[0].body }}
Gérer les catalogues
Dans le tableau de bord
Pour mettre à jour votre catalogue après avoir téléchargé un fichier CSV ou créé un catalogue dans le navigateur, sélectionnez Update Catalog > Upload CSV, puis choisissez de mettre à jour, d’ajouter ou de supprimer des éléments dans votre catalogue.
Avec la REST API
Au fur et à 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 via l’Ingestion de données cloud en synchronisant régulièrement les données de vos catalogues directement depuis votre entrepôt de données (tel que Snowflake, Redshift, BigQuery, Databricks, Microsoft Fabric ou S3).
Gérer les éléments du catalogue
En plus de gérer vos catalogues, vous pouvez utiliser des endpoints synchrones et asynchrones pour gérer les éléments du catalogue. Cela inclut la possibilité de modifier et de supprimer des éléments, ainsi que de consulter les détails d’un élément.
Par exemple, si vous souhaitez modifier un élément de catalogue spécifique, vous pouvez utiliser 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 100 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 100 Mo maximum. Vous pouvez avoir un nombre illimité d’éléments tant qu’ils ne dépassent pas 100 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 (100 Mo) est inclus dans chacun de ces plans.
Spécifications
Le tableau suivant résume les spécifications relatives au contenu des catalogues.
| Domaine | Spécifications |
|---|---|
| Caractères par valeur d’élément | Jusqu’à 5 000 caractères dans une seule valeur. Par exemple, si vous avez un champ intitulé description, le nombre maximum de caractères dans ce champ est de 5 000. |
| Caractères par nom de colonne d’élément | 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 élément de catalogue qui appelle ensuite un second élément de catalogue au sein de la même évaluation Liquid.