Ce document concerne Recommendations AI, Retail Search et la nouvelle console Retail.

Catalogues et informations sur le catalogue

Cette page présente les bonnes pratiques à suivre pour créer vos informations de catalogue et les insérer.

Présentation

Les données de catalogue que vous importez dans Retail ont un effet direct sur la qualité du modèle obtenu et, par conséquent, sur la qualité des résultats fournis par l'API Retail. En général, plus les informations du catalogue sont précises et spécifiques, plus la qualité du modèle est bonne.

Votre catalogue doit être à jour. Vous pouvez importer des modifications de catalogue aussi souvent que nécessaire (dans l'idéal, de façon quotidienne pour les catalogues dont le taux de variation est élevé). Vous pouvez importer (modifier) des produits existants, auquel cas seuls les champs modifiés sont mis à jour. L'importation des informations de catalogue est gratuite. Pour plus d'informations, consultez la section Maintenir votre catalogue à jour.

Branches de catalogue

Si vous utilisez Retail Search, vous pouvez utiliser les branches de catalogue pour tester les nouvelles données que vous avez importées hors connexion avant de les mettre en ligne sur votre site.

Avec l'API Retail, vous pouvez utiliser jusqu'à trois branches, identifiées par 0, 1 et 2. Votre site en ligne pointe vers default_branch pour ses données de catalogue. Spécifiez la branche actuelle de votre default_branch actif (elle est définie sur la branche 0 par défaut) à l'aide de setDefaultBranch ou de l'onglet "Data" (Données) de la console. Votre site utilise ensuite les données de catalogue fournies par la branche vers laquelle default_branch pointe.

Par exemple, supposons que default_branch est actuellement défini sur l'ID de branche 0. Votre site utilise donc les données de catalogue que vous avez importées vers cette branche. Vous pouvez importer de nouvelles données de catalogue vers la branche 1 et les prévisualiser. Après avoir vérifié que le catalogue a bien été importé, vous pouvez passer à la branche 1 en tant que default_branch active.

La mise à jour du cache du catalogue peut prendre jusqu'à 30 minutes après le changement de branche.

Si vous utilisez Recommendations AI, nous vous recommandons de n'utiliser que la branche par défaut en raison du délai de mise à jour lors du changement de branche. Si la différence de données entre les branches est importante, le délai de mise à jour peut avoir un impact négatif sur les résultats de la prédiction.

Produits

Le catalogue est une collection d'objets produit.

Informations produit requises

Les champs suivants sont obligatoires : vous devez les renseigner lorsque vous créez des produits dans votre catalogue. Ils doivent également correspondre aux valeurs utilisées dans votre base de données de produits internes et doivent refléter avec précision le produit représenté, car ils sont utilisés pour l'entraînement de vos modèles.

Dans certains cas, d'autres champs sont également requis. Consultez la liste complète de tous les champs de produit sur la page de référence Product.

Cependant, toutes les informations produit que vous fournissez peuvent servir à améliorer la qualité des recommandations et des résultats de recherche. Veillez à renseigner autant de champs que possible.

Champ Remarques
name Nom de ressource unique complet du produit. Obligatoire pour toutes les méthodes Product, à l'exception de import. Lors de l'importation, le nom est généré automatiquement et n'a pas besoin d'être fourni manuellement.
id ID produit utilisé par votre base de données de produits. Le champ d'ID doit être unique dans l'ensemble de votre catalogue. La même valeur est utilisée lorsque vous enregistrez un événement utilisateur. Elle est également renvoyée par les méthodes predict et search.
title Nom du produit dans votre base de données de produits. Chaîne encodée en UTF-8. 1250 caractères maximum.

Attributs du produit

Il est vivement recommandé de fournir des valeurs pour les attributs système prédéfinis de Product tels que la marque, la couleur et la taille. Vous pouvez également inclure des attributs personnalisés que vous définissez avec Product.attributes.

Si vous utilisez Retail Search, les attributs sont inclus avec un produit dans la réponse de recherche si vous les marquez comme récupérables dans Product.retrievableFields. Vous pouvez ensuite les utiliser pour d'autres fonctionnalités Retail Search, telles que le filtrage et les attributs.

Niveaux de produits

Les niveaux de produit déterminent la hiérarchie de votre catalogue. En règle générale, vous devez choisir entre un catalogue à un seul niveau ou un catalogue à deux niveaux.

Par exemple, vous pouvez créer un catalogue à un seul niveau, où chaque article possède un code SKU. Vous pouvez également choisir un catalogue à deux niveaux contenant à la fois des groupes de codes SKU et des codes SKU individuels.

Types au niveau du produit

Il existe trois types de produits:

  • Les articles principaux sont ceux renvoyés par l'API Retail dans les résultats de prédiction ou de recherche. Les principaux peuvent être des éléments individuels (au niveau du SKU) et des groupes d'éléments similaires (groupes de codes SKU).

  • Les articles variantes sont des versions d'un produit principal de groupe de codes SKU. Les variantes ne peuvent être que des éléments individuels (au niveau du SKU). Par exemple, si le produit principal est une chemise à col en V, la chemise v-col brune taille XL et la chemise v-col blanche blanche sera de taille S. Les modèles principaux et les variantes sont parfois décrits comme des éléments parent et enfant.

  • Les éléments Collection sont des collections de produits. Les collections sont des lots de produits principaux ou de variantes de produits. Par exemple, une collection peut être un ensemble de bijoux avec un collier, des boucles d'oreilles et une bague. Les collections ne sont disponibles que dans Retail Search et sont peu utilisées.

À propos de la hiérarchie du catalogue

Lorsque vous planifiez la hiérarchie de votre catalogue, vous devez décider si votre catalogue ne doit contenir que des primaires, ou des primaires et des variantes. N'oubliez pas que la prédiction et les résultats de recherche ne renvoient que des éléments principaux.

Par exemple, un catalogue ne comprenant que des livres principaux peut être utile pour la vente de livres, où un panneau de recommandations renvoie une sélection de livres, chacun avec son propre code SKU. Toutefois, un catalogue ne contenant que des tee-shirts principaux afficherait probablement le même tee-shirt dans chaque taille disponible dans le panneau des recommandations.

Il est préférable d'inclure à la fois des codes principaux et des variantes, avec les codes SKU comme variantes (une variante pour chaque taille) et les listes principales correspondant aux groupes de codes SKU des tailles de chaque style de t-shirt. Ce catalogue à deux niveaux permet au panneau des recommandations d'afficher une gamme de styles de t-shirts similaires. L'acheteur peut afficher le détail d'un principal (style) particulier afin de sélectionner la variante (taille) à acheter.

Si vous estimez que votre catalogue doit comporter à la fois des ensembles principaux et des variantes, c'est-à-dire des groupes de codes SKU et des codes SKU, mais que vous ne disposez plus que de codes SKU, vous devez créer des ensembles de données principales pour les groupes de codes SKU. Les informations minimales que vous devez fournir pour un serveur principal sont id, title et categories. Si vous effectuez l'importation, vous n'avez pas besoin de spécifier name. Pour en savoir plus, consultez la section Informations sur le produit obligatoires ci-dessus.

Il existe également un type de catalogue ne comportant que des variantes, qui est désormais obsolète. Ce type de catalogue ne peut être utilisé qu'avec Recommendations AI. Pour le catalogue ne comportant que des variantes, la valeur de ingestionProductType est définie sur variant lors de l'importation. Une principale est déduite pour chaque variante en fonction de l'ID de produit principal spécifié pour chaque variante.

Importation depuis un catalogue

Si vous disposez actuellement de votre catalogue dans Merchant Center, nous vous recommandons de l'importer en associant votre compte Merchant Center.

Si votre catalogue ne se trouve pas dans Merchant Center, mais se trouve dans Cloud Storage, BigQuery ou un autre espace de stockage, effectuez une importation groupée de données.

Si vous prévoyez d'importer des données de catalogue à partir de Merchant Center, consultez vos données comme indiqué pour les importations Merchant Center afin de vous assurer que vous faites les bons choix concernant votre catalogue. Cette étape est importante, car pour modifier la configuration d'un catalogue existant, vous devez le supprimer, puis le réimporter (consultez la section Modifier la configuration au niveau du produit).

Pour en savoir plus sur l'importation d'un catalogue, consultez la page Importer des informations de catalogue.

Métriques de qualité des données de catalogue

Pour vous aider à assurer le suivi de la qualité de recherche de vos données de catalogue, Retail évalue vos données produit par rapport à un ensemble de règles de qualité. Vous pouvez afficher le pourcentage des produits qui répond à chaque règle de qualité sur la page Données Retail.

Le tableau suivant décrit les métriques de qualité utilisées par Retail pour vous aider à évaluer vos données produit :

Métrique de qualité de catalogue Règle de qualité Remarques
L'URI est présent et accessible. Le produit possède un Product.uri valide. L'URI doit être accessible et correspondre à votre domaine. Cloud Retail Search utilise des signaux Web explorés via cet URI pour améliorer la qualité de recherche.
Respecte la continuité temporelle. Product.availableTime est antérieur à l'heure actuelle et Product.expireTime postérieur à l'heure actuelle. Seuls les produits respectant la continuité temporelle sont disponibles pour la recherche.
L'attribut d'inclusion dans l'index de recherche est présent. Le produit contient au moins un attribute inclus dans l'index de recherche. Les attributs personnalisés marqués comme inclus dans l'index de recherche peuvent faire l'objet d'une recherche par des requêtes de texte.
La description est présente Le produit comporte un champ Product.description non vide. Une description complète permet d'améliorer la qualité de recherche.
Le nom de produit contient au moins deux mots. Product.title comprend au moins deux mots. Un nom de produit complet contribue à améliorer la qualité de recherche.
Comporte une variante avec image. Le produit variant a au moins un élément Product.image. Vous pouvez ignorer cette métrique si tous vos produits sont au niveau primary. Cette métrique est fournie à titre informatif et n'a aucune incidence sur la qualité de recherche.
Comporte une variante avec des informations de prix. Le produit variant comporte un élément Product.priceInfo défini. Vous pouvez ignorer cette métrique si tous vos produits sont au niveau primary. Cette métrique est fournie à titre informatif et n'a aucune incidence sur la qualité de recherche.

Schéma Retail

Lorsque vous importez un catalogue à partir de BigQuery, utilisez le schéma Retail ci-dessous pour créer une table BigQuery au format adapté et y insérer vos données de catalogue. Ensuite, importez le catalogue.