À 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

Le catalogue est une collection d'objets produit.

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

Branches de catalogue avec recherche

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 (la branche 0 est définie par défaut) en utilisant setDefaultBranch ou l'onglet "Data" (Données) de la console Search for Commerce. Votre site utilise ensuite les données de catalogue fournies par la branche vers laquelle pointe default_branch.

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

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.

Catégories de catalogue

Cette section décrit la structure du catalogue et comment le désigner pour une utilisation dans la taxonomie et le filtrage.

Structure du catalogue

Le champ categories du catalogue doit contenir le chemin de catégorie le plus précis pour chaque produit. Les catégories parentes ne sont pas obligatoires et ne doivent pas être incluses.

Voici un exemple de structure de catalogue :

• Correct : categories: ["Flowers, Cards, Occasion > Seasonal Items > Christmas"]
• Incorrect : categories: ["Flowers, Cards, Occasion", "Flowers, Cards, Occasion > Seasonal Items", "Flowers, Cards, Occasion > Seasonal Items > Christmas"]

Catégories parentes

Les catégories parentes d'un produit donné ne doivent pas être incluses dans le champ categories. Le filtrage pour la navigation doit être géré à l'aide d'autres attributs personnalisés.

Nommer les catégories

Choisissez soigneusement les noms de catégories pour éviter d'introduire des mots clés incorrects et améliorer les performances. Utiliser des termes plus spécifiques et précis permet d'améliorer la pertinence et de réduire les problèmes.

• Recommandé : Aliments surgelés > Fruits surgelés
• Déconseillé : Fruits et légumes surgelés > Fruits surgelés

Structure spécifique au projet, au niveau du catalogue

Créez un catalogue unique pour chaque langue. Si vous travaillez dans plusieurs pays, vous pouvez utiliser le même catalogue pour fournir des résultats de recherche dans différents pays.

Indiquez des prix déterminés à partir des inventaires locaux dans la même devise pour tous les pays. Si les prix varient d'un pays à l'autre, créez un inventaire en magasin pour chaque pays. Spécifiez-y ses prix.

Pour optimiser vos résultats de recherche, indiquez le nom de chaque pays en tant que SearchRequest.entity et UserEvent.entity. Utilisez les entités de pays uniquement à des fins de classement.

Présentation de la hiérarchie des produits

Lorsque vous gérez votre catalogue de produits dans Vertex AI Search pour le commerce, il est essentiel de comprendre comment les attributs sont traités pour les produits principaux et les variantes afin d'optimiser la recherche et les recommandations. Les désignations de SKU de produit déterminent la hiérarchie du catalogue.

Types de désignation de produit

Il existe trois types de désignation de produit :

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

2. Les articles Variante ou enfants sont des versions spécifiques et individuelles d'un produit principal d'un groupe de 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.

3. Les articles Collection sont des ensembles de produits principaux ou de variantes, comme une parure de bijoux composée d'un collier, de boucles d'oreilles et d'une bague. Les collections regroupent des produits principaux associés dans des structures hiérarchiques semblables à celles des produits et des variantes. 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 produits d'épicerie sont mieux catalogués en tant que produits principaux, chacun composé d'un seul SKU, tel que"bananas, fresh".

En revanche, les t-shirts seraient mieux structurés de manière hiérarchique, en tant que produits principaux avec leur ensemble de variantes correspondant. Chaque variante représente un code SKU individuel (pour chaque taille) et chaque article principal représente un groupe de codes SKU, où chaque code SKU correspond à une taille différente pour un même style de t-shirt. Cette structure d'organisation par SKU permet aux résultats de recherche et aux panneaux de recommandations d'afficher une gamme de styles de t-shirts. Il permet à l'acheteur d'examiner un style principal spécifique pour sélectionner la variante (taille) à acheter.

Les collections regroupent des produits associés qu'un client peut acheter. Pour les représenter avec précision dans le modèle de réorganisation, Vertex AI Search pour le commerce dispose d'une logique qui leur attribue les achats. Par exemple, un client clique sur des produits d'un ensemble de draps, puis ajoute au panier ou achète un produit principal de cette collection. La collection est créditée de cet achat et le modèle représente fidèlement la popularité et la valeur des collections.

Il existe également un type de catalogue "Variantes uniquement", 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 des produits désignés comme principaux uniquement, des produits principaux et des variantes, ou une combinaison 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 façon dont vos codes SKU de produits sont désignés, réfléchissez aux options de configuration de votre catalogue de produits :

• Vous souhaitez que votre SKU s'affiche en tant que résultat de recherche ou recommandation individuel : SKU=primary
• Votre SKU doit faire partie d'un groupe de SKU similaires : SKU=variante, groupe de SKU=principal
• Combinaison des deux : SKU=principal, SKU=variante, groupe de SKU=principal

Si la page d'informations détaillées sur votre produit affiche un sélecteur d'options, de tailles ou de couleurs, ces options sont généralement importées en tant que variantes dans votre catalogue de produits. Déterminez si vous souhaitez que différents types d'un même produit, avec des attributs différents tels que la taille et la couleur, apparaissent dans un seul résultat de recherche ou dans des résultats distincts. Par exemple, pour un livre, vous devez décider si vous souhaitez que le code SKU de l'édition reliée et celui de l'édition brochée du même livre apparaissent comme des résultats de recherche distincts (SKU = principal) ou comme 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 produits principaux et des variantes (c'est-à-dire des groupes de SKU et des SKU), mais que vous n'avez que des SKU pour le moment, vous devez créer des produits principaux pour les groupes de SKU. Ces primaires sont parfois appelées primaires virtuelles ou fausses primaires.

Ces primaires n'ont besoin de 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 des données, vous n'avez pas besoin de spécifier name. Pour en savoir plus, consultez la section précédente Informations produit requises.

Importation de catalogues

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

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

Inventaire de produits

L'inventaire de produits comprend :

• Prix actuel et prix d'origine

• Disponibilité (en stock, non disponible, en réapprovisionnement, en précommande, etc.)

• Quantité disponible

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

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

Inventaire au niveau des produits

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 des produits, y compris sur la façon de gérer les 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 les informations sur l'inventaire pour chaque magasin. Pour ce faire, ils utilisent l'inventaire en magasin.

Deux champs de produit 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, et méthodes de retrait et de livraison dans chaque magasin

Vous pouvez utiliser l'un ou l'autre de ces champs, ou les deux, pour fournir des informations sur votre magasin.

Pour en savoir plus sur les inventaires en magasin, consultez Mettre à jour l'inventaire en magasin pour Vertex AI Search for Commerce.

Structure d'inventaire avec variante principale

La structure de données d'inventaire des variantes principales est composée de produits principaux, de variantes et d'inventaires en magasin :

• Produits principaux : les données des produits principaux sont stockées sans prix.

• Produits avec variantes (avec le prix le plus bas dans le pays) : par exemple, la variante de la caractéristique principale (couleur, taille) doit avoir le prix le plus bas dans le pays. Les données de prix des variantes sont regroupées dans les données produit principales. Le prix principal est ensuite utilisé à des fins de classement. Les prix spécifiques à une zone géographique sont ignorés.

• Inventaire en magasin (prix spécifiques à une région ou à un magasin) : utilisez les informations sur les prix de l'inventaire en magasin pour le reclassement au moment de la diffusion.

• Attributs de produit principal : les produits principaux ne doivent inclure que les attributs communs à toutes leurs variantes associées.

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

La page Qualité des données de la console Search for Commerce évalue 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 pour le commerce 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 la recherche dans la console Search for Commerce, consultez Débloquer les niveaux de performances de la recherche.

Schéma de produit

Lorsque vous importez un catalogue à partir de BigQuery, utilisez le schéma de produit Vertex AI Search for Commerce 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": "publishTime",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "promotions",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "promotionId",
        "type": "STRING",
        "mode": "NULLABLE"
      }
    ]
  }
]