À propos des catalogues et des produits

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 Vertex AI Search pour le commerce ont un effet direct sur la qualité du modèle obtenu et, par conséquent, sur la qualité des résultats de recherche et de recommandation. 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 la recherche, vous pouvez utiliser des branches de catalogue pour tester les nouvelles données que vous avez importées hors connexion avant de les rendre disponibles sur votre site.

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. Indiquez quelle branche est votre default_branch (définie par défaut sur la branche 0) en utilisant setDefaultBranch ou l'onglet "Data" (Données) de la console Search for Retail. 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 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. Une fois que vous avez vérifié que le catalogue a été importé correctement, vous pouvez passer à la branche 1 en tant que fichier default_branch en direct.

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

Si vous utilisez des recommandations, 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 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.

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.

Champs récupérables

Si vous utilisez la recherche, les attributs sont inclus avec un produit dans la réponse de recherche si vous les marquez comme récupérables dans Product.retrievableFields. Ils peuvent ensuite être utilisés pour d'autres fonctionnalités de recherche comme le filtrage et les attributs.

Option de recherche exacte

Vous pouvez attribuer une valeur spécifique à l'option "Recherche exacte", un champ d'attribut de catalogue, pour des requêtes de chaîne spécifiques. Si une requête correspond à un produit de votre catalogue dont la valeur pour ce champ est la chaîne indiquée dans la requête, elle renvoie exactement ce produit dans la requête de recherche. Cette option convient bien aux numéros de série, pour lesquels les clients s'attendent à une expérience de recherche ciblée.

Champ utile pour les attributs de produit dont la valeur est exacte (par exemple, ModelId ou ManufacturerId), le champ ExactSearchableOption est généralement réservé aux attributs personnalisés. Les attributs tels que product_id sont des champs d'index principaux, qui peuvent être recherchés de manière exacte par défaut. Le champ item_id est toujours activé pour la correspondance exacte et ne peut pas être désactivé.

• Pour éviter de renvoyer des éléments sans rapport dans les recherches, ne définissez jamais l'option de recherche sur une valeur générique telle que battery.
• Pour éviter de ne pas diffuser suffisamment de requêtes de recherche, ne définissez pas de champs spéciaux tels que tag (qui peut avoir comme valeur de chaîne "iphone") comme champs pouvant faire l'objet d'une recherche exacte. Cela pourrait entraîner la limitation des résultats pour tous les iPhone du catalogue de produits.

Pour en savoir plus, consultez À propos des attributs de produit.

Niveaux de produits

Les codes SKU des produits déterminent la hiérarchie de votre catalogue.

Types de désignation de produit

Il existe trois types de désignations de produits:

1. Les articles principaux sont renvoyés dans les résultats de recommandation ou de recherche. Les principaux peuvent être des articles individuels (au niveau du SKU) et des groupes d'articles similaires (groupes de SKU).

2. Les articles Variante sont des versions d'un produit principal de groupe de SKU. 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.

3. Les articles Collection sont des lots de produits principaux ou de variantes, comme une parure de bijoux composée d'un collier, de boucles d'oreilles et d'une bague. Structures hiérarchiques semblables aux produits et aux variantes, les collections regroupent les produits principaux associés. Les clients ne peuvent pas les acheter directement, ils ne sont pas largement utilisés et ils ne sont disponibles que dans la recherche.

Exemples de produits

Par exemple, selon ces types de désignation de produits, les articles d'épicerie sont mieux catégorisés en tant que produits principaux, chacun étant composé d'un seul SKU, comme"bananas, fresh".

En revanche, les tee-shirts sont mieux structurés de manière hiérarchique, en tant que produits principaux avec leur ensemble de variantes correspondant. Chaque variante représente un SKU individuel (pour chaque taille) et chaque article principal représente un groupe de SKU, où chaque SKU est d'une taille différente pour un style de tee-shirt global. Cette organisation par code SKU permet aux résultats de recherche et aux panneaux de recommandations d'afficher une gamme de styles de tee-shirts. Il permet au client d'explorer un élément principal (style) particulier pour sélectionner la variante (taille) à acheter.

Les collections regroupent des produits associés qu'un client peut acheter. Pour les représenter précisément dans le modèle de reclassement, Vertex AI Search pour le commerce dispose d'une logique qui leur attribue des achats. Par exemple: un acheteur clique sur les produits d'un ensemble de draps, puis ajoute un produit principal de cette collection au panier ou l'achète. Cet achat est attribué à la collection, et le modèle représente précisément la popularité et la valeur des collections.

Il existe également un type de catalogue réservé aux variantes, qui est désormais obsolète. Ce type de catalogue ne peut être utilisé qu'avec des recommandations. Pour le catalogue de variantes uniquement, ingestionProductType est défini sur variant lors de l'importation. Un produit principal est déduit pour chaque variante, en fonction d'un ID de produit principal spécifié pour chaque variante.

Configurer votre catalogue de produits

Lorsque vous planifiez votre catalogue de produits, vous devez décider s'il contient uniquement des produits principaux, des produits principaux et des variantes, ou un mélange des deux. Pensez-y en termes de structure de SKU de vos produits. Vos produits peuvent être des articles principaux, qui peuvent ou non avoir des variantes.

En fonction de la désignation de vos codes SKU, envisagez les options de configuration de votre catalogue de produits:

• Vous souhaitez que votre SKU s'affiche comme résultat de recherche ou recommandation individuels: SKU=primary
• Votre SKU doit faire partie d'un groupe de SKU similaires: SKU=variante, groupe de SKU=principal

• Mélange des deux combinaisons: SKU=principal, SKU=variante, groupe de SKU=principal

  Si votre page d'informations détaillées sur le produit affiche un sélecteur d'option/taille/couleur, ces options sont généralement importées en tant que variantes dans votre catalogue de produits. Déterminez si vous souhaitez que les différents types d'un même produit avec des attributs différents (taille et couleur, par exemple) apparaissent dans un seul résultat de recherche ou dans plusieurs. Par exemple, pour un livre, vous devez décider si vous souhaitez que le SKU en couverture rigide et le SKU en couverture souple du même livre apparaissent dans des résultats de recherche distincts (SKU = principal) ou dans un seul résultat (SKU = variante, groupe de SKU = principal).

Lorsque vous configurez votre catalogue de produits, gardez à l'esprit que les recommandations et les résultats de recherche ne renvoient que des articles principaux.

Produits principaux minimaux

Si vous déterminez que votre catalogue doit comporter à la fois des SKU principaux et des variantes, c'est-à-dire des groupes de SKU et des SKU, mais que vous ne disposez que de SKU pour le moment, vous devez créer des SKU principaux pour les groupes de SKU. Ces primaires sont parfois appelées "primaires virtuelles" ou "primaires factices".

Ces primaires ne doivent contenir que des informations minimales: id, title et categories.

Si type n'est pas spécifié, le type de produit est défini par défaut sur "principal". Si vous importez, vous n'avez pas besoin de spécifier name. Pour en savoir plus, consultez la section précédente, Informations produit requises.

Le type est immuable

Vous ne pouvez pas modifier le type d'un produit, par exemple, de variante à principal ou de principal à variante.

Si vous devez modifier le type d'un produit, supprimez-le, puis créez-en un autre avec un type différent. Avant de pouvoir supprimer un produit principal, vous devez supprimer les variantes associées.

Importation de catalogues

Si vous avez déjà un 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 dans Cloud Storage, BigQuery ou un autre espace de stockage, effectuez une importation de données groupée.

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 concernant votre catalogue. Cette étape est importante, car modifier la configuration d'un catalogue existant nécessite de le supprimer et de l'importer à nouveau (voir la section Modifier la configuration au niveau du produit).

Pour savoir comment importer un catalogue, consultez Importer des informations de catalogue.

Inventaire de produits

L'inventaire de produits comprend:

• Prix, à la fois le prix actuel et le prix d'origine

• Disponibilité (en stock, non disponible, en réapprovisionnement et en précommande, par exemple)

• Quantité disponible

• Informations sur le traitement des commandes, telles que le retrait en magasin, la livraison en magasin et la livraison le jour suivant

Il existe deux niveaux d'inventaire: au niveau du produit et en magasin.

Inventaire au niveau du produit

Pour les marchands qui ne vendent qu'en ligne, l'inventaire est spécifié au niveau du produit. Le prix, la disponibilité et d'autres données d'inventaire sont définis pour chaque produit du catalogue.

Pour en savoir plus sur l'inventaire au niveau du produit, y compris sur la gestion des données d'inventaire, consultez Mettre à jour l'inventaire pour Vertex AI Search pour le commerce.

Inventaire en magasin

Les marchands qui possèdent des magasins physiques et une boutique en ligne doivent conserver des informations sur l'inventaire par magasin. Pour ce faire, elles utilisent l'inventaire en magasin.

Deux champs de produits peuvent être utilisés pour stocker l'inventaire en magasin. Ces deux champs sont des listes d'établissements (identifiants de lieu) avec des informations d'inventaire associées:

• Product.fulfillmentInfo Méthodes de retrait et de livraison dans chaque magasin

• Product.localInventories Informations sur les prix, attributs des produits, ainsi que méthodes de retrait et de livraison dans chaque magasin

Vous pouvez utiliser l'un ou les deux champs pour vos informations au niveau du magasin.

Pour en savoir plus sur les inventaires en magasin, consultez Mettre à jour l'inventaire en magasin pour la recherche Vertex AI pour le commerce.

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

La page Qualité des données de la console Search for Retail indique si vous devez mettre à jour les données de votre catalogue pour améliorer la qualité des résultats de recherche et débloquer les niveaux de performances de recherche.

Le tableau suivant décrit les métriques de qualité utilisées par Vertex AI Search for retail pour vous aider à évaluer vos données produit. Pour savoir comment afficher les métriques sur la qualité des données et les niveaux de performances de recherche dans la console Search for Retail, consultez Débloquer les niveaux de performances de recherche.

Schéma des produits pour Vertex AI Search pour le commerce

Lorsque vous importez un catalogue à partir de BigQuery, utilisez le schéma Vertex AI Search for retail product suivant pour créer une table BigQuery au format adapté et y insérer vos données de catalogue. Ensuite, importez le catalogue.

[
  {
    "name": "name",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "id",
    "type": "STRING",
    "mode": "REQUIRED"
  },
  {
    "name": "type",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "primaryProductId",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "collectionMemberIds",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "gtin",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "categories",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "title",
    "type": "STRING",
    "mode": "REQUIRED"
  },
  {
    "name": "brands",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "description",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "languageCode",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "attributes",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "key",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "value",
        "type": "RECORD",
        "mode": "NULLABLE",
        "fields": [
          {
            "name": "text",
            "type": "STRING",
            "mode": "REPEATED"
          },
          {
            "name": "numbers",
            "type": "FLOAT",
            "mode": "REPEATED"
          }
        ]
      }
    ]
  },
  {
    "name": "tags",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "priceInfo",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "currencyCode",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "price",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "originalPrice",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "cost",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "priceEffectiveTime",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "priceExpireTime",
        "type": "STRING",
        "mode": "NULLABLE"
      }
    ]
  },
  {
    "name": "rating",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "ratingCount",
        "type": "INTEGER",
        "mode": "NULLABLE"
      },
      {
        "name": "averageRating",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "ratingHistogram",
        "type": "INTEGER",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "expireTime",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "ttl",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "seconds",
        "type": "INTEGER",
        "mode": "NULLABLE"
      },
      {
        "name": "nanos",
        "type": "INTEGER",
        "mode": "NULLABLE"
      }
    ]
  },
  {
    "name": "availableTime",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "availability",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "availableQuantity",
    "type": "INTEGER",
    "mode": "NULLABLE"
  },
  {
    "name": "fulfillmentInfo",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "type",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "placeIds",
        "type": "STRING",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "uri",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "images",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "uri",
        "type": "STRING",
        "mode": "REQUIRED"
      },
      {
        "name": "height",
        "type": "INTEGER",
        "mode": "NULLABLE"
      },
      {
        "name": "width",
        "type": "INTEGER",
        "mode": "NULLABLE"
      }
    ]
  },
  {
    "name": "audience",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "genders",
        "type": "STRING",
        "mode": "REPEATED"
      },
      {
        "name": "ageGroups",
        "type": "STRING",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "colorInfo",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "colorFamilies",
        "type": "STRING",
        "mode": "REPEATED"
      },
      {
        "name": "colors",
        "type": "STRING",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "sizes",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "materials",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "patterns",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "conditions",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "retrievableFields",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "publishTime",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "promotions",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "promotionId",
        "type": "STRING",
        "mode": "NULLABLE"
      }
    ]
  }
]