Cette documentation de Recommendations AI fait référence à la console Recommendations. Nous vous recommandons de passer à la console Retail et d'utiliser la documentation pour le commerce de détail, qui fournit des informations sur Recommendations AI, la console et sur Retail Search.

Si vous utilisez la version v1beta de Recommendations AI, migrez vers la version Retail API.

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.

Aperçu

Les données de catalogue que vous importez dans Recommendations AI ont un effet direct sur la qualité du modèle obtenu et, par conséquent, sur la qualité des prédictions fournies par Recommendations AI. 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.

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.

Toutes les informations produit que vous spécifiez peuvent servir à améliorer la qualité des recommandations. Veillez à renseigner autant de champs que possible.

Champ Remarques
name Nom de ressource unique complet du produit. Obligatoire pour toutes les méthodes produit, à 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 la méthode predict.
title Nom du produit dans votre base de données de produits. Chaîne encodée en UTF-8. 1250 caractères maximum.

Utiliser les niveaux de produits

Lorsque vous importez votre catalogue pour la première fois, vous devez spécifier si vous fournissez uniquement des articles principaux, ou des articles principaux ainsi que leurs variantes.

  • Les articles principaux sont ceux renvoyés par l'API Retail dans les résultats de la prédiction. Il peut s'agir d'articles individuels (au niveau du SKU) ou de groupes d'articles similaires (groupes de SKU). Par défaut, l'API Retail est configurée pour n'importer que les articles principaux.
  • Les articles Variante sont des versions d'un produit principal. Les variantes ne peuvent être que des articles individuels (au niveau du code SKU). Par exemple, si le produit principal est "Chemise à col en V", les variantes peuvent être "Chemise à col en V, coloris marron, taille XL" et "Chemise à col en V, coloris blanc, taille S". Les produits principaux et leurs variantes sont parfois décrits comme des éléments "parents" et "enfants". L'importation de variantes est facultative.

Lors de l'importation du catalogue, définissez vos niveaux de produits à l'aide de la méthode Catalog.patch. Exemple :

curl -X PATCH 
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)"
-H "Content-Type: application/json; charset=utf-8"
--data '{ "productLevelConfig": { "ingestionProductType": "PRODUCT-TYPE", "merchantCenterProductIdField": "PRODUCT-ID-FIELD" } }'
"https://retail.googleapis.com/v2/projects/PROJECT_ID/locations/global/catalogs/default_catalog"

Pour déterminer les meilleurs choix concernant le niveau de produit de votre mise en œuvre, vous devez examiner les données de votre catalogue et la logique de votre site Web. Quels ID d'article sont disponibles lorsque vous capturez des données d'événement utilisateur ? Quels ID d'article seraient les plus efficaces à renvoyer avec des prédictions ? En quoi ces ID sont associés ?

Suivez les étapes appropriées, selon que vous importez ou non depuis Merchant Center :

Déterminer les niveaux de vos produits pour l'importation à partir de Merchant Center

Lorsque vous importez des données de catalogue à partir de Merchant Center, l'API Retail utilise ingestionProductType pour déterminer s'il convient de les importer en tant que produits principaux ou variantes, et le champ merchantCenterProductIdField pour indiquer s'il faut utiliser la fonction offer_id ou item_group_id de Merchant Center en tant qu'ID de produit.

Examinez les données de votre catalogue et la logique de votre site Web pour répondre aux questions suivantes :

  • Ai-je des produits principaux et des variantes dans mon catalogue ?
  • Si oui, quel niveau d'article sera disponible lorsque je capture des données d'événements utilisateur ?
  • Quel type d'article dois-je renvoyer avec mes prévisions ?

Déterminez si :

  1. Votre catalogue ne contient qu'un seul niveau d'article. Cela peut signifier que :

    • Tous vos produits et événements résident au niveau du code SKU, et vous souhaitez obtenir des prédictions au niveau du code SKU.
    • Tous vos produits et événements résident au niveau du groupe, et vous souhaitez obtenir des prédictions au niveau du groupe.

    Si tel est le cas, importez uniquement avec les articles principaux. Il s'agit du paramètre d'importation par défaut.

  2. Vous souhaitez obtenir des prédictions au niveau du groupe (principal), mais vos produits Merchant Center résident au niveau du code SKU. Dans ce cas, votre décision d'importation dépend de la manière dont vos événements sont capturés.

    1. Vos événements sont capturés au niveau du groupe. Si tel est le cas, utilisez les paramètres suivants pour l'importation :

      Lorsque plusieurs produits Merchant Center ont le même item_group_id Merchant Center, Recommendations AI n'importe qu'un seul de ces produits en tant que produit principal, et utilise item_group_id comme ID produit. Dans ce cas, les produits qui n'ont pas de item_group_id ne peuvent pas être importés. Les événements enregistrés doivent faire référence à l'ID de produit principal (au niveau du groupe).

    2. Vos événements sont capturés au niveau du code SKU. Si tel est le cas, utilisez les paramètres suivants pour l'importation :

      Recommendations AI importe vos produits en tant que variantes et utilise le offer_id de Merchant Center comme ID de produit. Les événements enregistrés doivent faire référence à l'ID de produit de variante (au niveau du SKU).

Déterminer les niveaux de vos produits pour l'importation sans Merchant Center

Tous vos produits doivent avoir une valeur pour primaryProductId, ou aucun d'entre eux ne peut en avoir. Vous ne pouvez pas importer de données de catalogue avec primaryProductId défini pour certains articles mais pas pour d'autres.

  1. Si votre catalogue ne comporte qu'un seul niveau d'article, cela peut signifier que :

    • Tous vos produits et événements résident au niveau du code SKU, et vous souhaitez obtenir des prédictions au niveau du code SKU.
    • Tous vos produits et événements résident au niveau du groupe, et vous souhaitez obtenir des prédictions au niveau du groupe.

    Si tel est le cas, importez uniquement avec les articles principaux. Il s'agit du paramètre recommandé par défaut.

  2. Si vos événements et produits résident au niveau du SKU, vous pouvez obtenir des prédictions au niveau du groupe. Définissez ingestionProductType sur variant lors de l'importation.

La prédiction au niveau des SKU n'est pas disponible si vous ne disposez que d'événements et de produits au niveau du groupe.

Si vous envisagez d'importer des données de catalogue à partir de Merchant Center dans le futur, examinez vos données comme décrit dans la section concernant les importations Merchant Center afin de vous assurer de faire le bon choix. Vous ne pouvez modifier cette configuration qu'en supprimant le catalogue et en l'important à nouveau (consultez la section Modifier la configuration au niveau du produit).

Schéma Recommendations AI

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