Passer au contenu

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.

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 :

É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.

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

Un catalogue nommé « my_catalog ».

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

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.

Quatre noms de colonnes de catalogue : « id », « title », « price », « image_link ».

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.

Un catalogue nommé « games_catalog ».

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.

Prérequis

Avant de pouvoir modifier ou créer des catalogues dans le navigateur, vous avez besoin des autorisations utilisateur suivantes pour votre espace de travail :

  • Voir les catalogues
  • Modifier les catalogues
  • Exporter les catalogues
  • Supprimer les catalogues

Étape 1 : Saisir les détails du catalogue

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

Un catalogue nommé « my_catalog ».

Étape 2 : Créer votre catalogue

Sélectionnez votre catalogue dans la liste, puis sélectionnez Mettre à jour le catalogue > Ajouter des champs. Saisissez le Nom du champ 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.

Deux exemples de champs : « rating » et « name ».

Sélectionnez Mettre à jour le catalogue > Ajouter des éléments pour ajouter un élément à votre catalogue en saisissant les informations correspondant aux champs ajoutés précédemment. Ensuite, sélectionnez Enregistrer l’élément ou Enregistrer et ajouter un autre pour continuer à ajouter vos éléments.

Ajout d’un élément de catalogue.

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 :

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.

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.

New Stuff!