Cette documentation ne concerne que Recommendations AI. Pour essayer Retail Search et la console Play Store unifiée pendant la phase de disponibilité limitée, contactez le service commercial Cloud. Si vous ne prévoyez pas d'utiliser Retail Search, restez dans la console "Recommandations" jusqu'à nouvel ordre.

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. Utilisez les informations ci-dessous pour choisir les informations que vous fournirez lors de l'importation des informations du catalogue.

Pour afficher la liste complète de tous les champs de produit, consultez la page de référence du 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.

Champ Remarques
name Nom de ressource unique complet du produit. Obligatoire pour toutes les méthodes produit, à l'exception de import.
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.

Informations facultatives du catalogue

Ces champs ne sont pas obligatoires. Cependant, toutes les informations de catalogue que vous fournissez peuvent servir à améliorer la qualité du modèle, des résultats de prédiction ou des métriques de prédiction. Veillez à renseigner autant de champs que possible.

Champ Remarques Utilisation
type

Type de produit. Ce champ est uniquement en sortie. Les valeurs possibles sont :

  • PRIMARY
  • VARIANT
  • COLLECTION

La valeur par défaut est PRIMARY, si elle n'est pas spécifiée.

primaryProductId ID du groupe de variantes. Pour les produits PRIMARY, ce champ doit être vide ou défini sur la même valeur que id. Pour les produits VARIANT, ce champ est obligatoire. Ce champ doit être activé par l'API Retail pour pouvoir être utilisé. Regroupement des codes SKU
categories[]

Liste des hiérarchies de catégories auxquelles le produit appartient. Les catégories doivent être extraites de la classification des produits de votre entreprise et doivent décrire précisément le produit.

Vous devez indiquer au moins une catégorie ; plusieurs catégories sont également acceptées.

Les sous-catégories sont regroupées entre crochets. Par exemple, supposons qu'un produit de type chaussures appartienne à la fois aux sous-catégories "Shoes & Accessories" -> "Shoes" et ""Sports & Fitness > Athletic Clothing > Shoes"]. Son champ de catégories serait le suivant :


categories: [
       ["Shoes & Accessories", "Shoes"],
       ["Sports & Fitness > Athletic Clothing > Shoes"]
]
description Description de l'article provenant de votre base de données de produits. Chaîne encodée en UTF-8. 1250 caractères maximum. Fortement encouragée.
attributes Un endroit pour fournir des informations sur votre produit qui ne sont pas incluses dans d'autres champs et qui, selon vous, pourraient aider à améliorer la qualité du modèle. Fortement encouragée. Qualité du modèle
tags

Le champ tags vous permet de filtrer vos résultats de prédiction. Les valeurs de tags ne doivent contenir que des caractères alphanumériques, des traits de soulignement et des tirets.

La mise à jour des valeurs des tags peut prendre jusqu'à 24 heures avant que les tags ne puissent être utilisés pour filtrer les résultats de prédiction.

Filtrage des recommandations
priceInfo Objet contenant des informations sur les tarifs de votre produit.
priceInfo.currencyCode Code ISO-4217 à trois caractères alphabétiques pour la devise utilisée dans les champs price et cost du produit.
priceInfo.price Prix de votre produit.
priceInfo.originalPrice Prix du produit sans aucune remise. Si la valeur est de zéro, c'est le prix qui est défini par défaut.
priceInfo.cost

Lorsque vous indiquez le coût d'un produit, il est utilisé pour générer des métriques de rentabilité précises.

Métriques de recommandations
availableTime Horodatage correspondant à la date de disponibilité du produit.
availability

Vous pouvez utiliser ce champ pour fournir des informations sur le stock du produit. Les valeurs possibles sont les suivantes :

  • IN_STOCK
  • OUT_OF_STOCK
  • PREORDER
  • BACKORDER

La valeur par défaut est IN_STOCK.

Qualité du modèle
availableQuantity

Nombre d'articles disponibles. Une valeur de zéro ne modifie pas le champ availability en OUT_OF_STOCK, et n'empêche pas Recommendations AI de recommander cet article.

images Objet comportant jusqu'à 300 images pour le produit. Les images facilitent l'affichage des résultats de recommandations, et l'aperçu de la prédiction utilise des URL d'image pour afficher les images lorsque vous prévisualisez les résultats de prédiction d'un modèle dans Cloud Console. Qualité du modèle
images.uri URI de l'image. Obligatoire pour images. Qualité du modèle
images.height Hauteur de l'image en pixels. Qualité du modèle
images.width Largeur de l'image en pixels. Qualité du modèle

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.

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.