"Retail" devient Vertex AI Search pour le commerce. Nous sommes en train de mettre à jour le contenu pour refléter le nouveau branding.

Cette page a été traduite par l'API Cloud Translation.

À 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 du catalogue que vous importez dans Vertex AI Search pour le commerce ont un impact direct sur la qualité du modèle qui en résulte, et donc sur la qualité des recherches recommandations. 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 comme 0, 1 et 2. Votre site en ligne pointe vers default_branch pour ses données de catalogue. Spécifiez la branche qui correspond actuellement à votre default_branch actif (la valeur par défaut est définie sur branche 0) à l'aide de setDefaultBranch ou de l'onglet "Data" (Données) de Recherchez la console Retail. Votre site utilise ensuite les données de catalogue fournies par la branche vers laquelle pointe default_branch.

Par exemple, supposons que default_branch soit défini sur l'ID de branche 0. Votre utilise les données de catalogue que vous avez importées sur 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 les recommandations, nous vous recommandons de n'utiliser que la valeur 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.

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.
`categories`	Catégories de produits. Chaque produit doit être attribué à au moins une catégorie. Si un produit appartient à plusieurs catégories, répétez le champ pour chaque catégorie. La valeur doit être une chaîne encodée en UTF-8 non vide, d'une longueur maximale de 5 000 caractères. Indiquez toujours le chemin d'accès complet de la catégorie, par exemple : `["Sports & Fitness > Athletic Clothing > Shoes"]`.

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 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 telles que le filtrage et les attributs.

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

Niveaux de produits

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

Types de désignation de produit

Il existe trois types de désignation de produit:

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).
Les articles de type variante sont des versions d'un produit principal appartenant à un 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 pourraient être "Chemise col en V marron, taille XL" et « Blanc Chemise à col en V, taille S". Les primaires et les variantes sont parfois décrites comme parent et child.
Les éléments Collection sont des collections de produits. Les collections sont des ensembles de produits principaux ou de variantes de produits. Par exemple, une collection peut être une parure de bijoux composée d'un collier, de boucles d'oreilles et d'une bague. Les collections ne sont disponibles que dans la recherche et ne sont pas largement utilisées.

Exemples de produits

Selon ces types de désignation de produit, les produits alimentaires, par exemple, se composeraient de produits ayant un seul SKU, tels que "bananas, fresh".

En revanche, les T-shirts seraient mieux structurés de manière hiérarchique, en tant que variantes principales 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 structure d'organisation par SKU permet aux résultats de recherche et aux panneaux de recommandations de présenter une gamme de styles de t-shirts. Elle permet à l'acheteur d'afficher le détail d'une principale (style) spécifique pour sélectionner la variante. (taille) à acheter.

Il existe également un type de catalogue ne contenant que des variantes, qui est désormais obsolète. Ce catalogue ne peut être utilisé qu'avec des recommandations. Pour la variante uniquement catalogue, ingestionProductType est défini sur variant lors de l'importation. Un produit principal est inféré 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 désignés comme principaux, des produits principaux et des variantes, ou un mélange des deux. Pensez-y en termes de structure de SKU de vos produits. Il peut s'agir d'articles principaux, qui peuvent avoir ou non 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=variant, groupe de SKU=primary
Mélange des deux combinaisons: SKU=principal, SKU=variante, groupe de SKU=principal

Si la page d'informations détaillées sur le produit affiche un sélecteur d'option, de taille ou de 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 souhaitez déterminer si vous souhaitez qu'un SKU à couverture rigide et un SKU à couverture brochée du même livre apparaissent dans des résultats de recherche distincts (SKU = principal) ou sous la forme d'un seul (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.

Nombre minimal de produits principaux

Si vous pensez que votre catalogue doit comporter à la fois des variantes principales et des variantes, les groupes de SKU et les SKU, mais que vous n'avez que des SKU actuellement, vous devez créer primaires pour les groupes de SKU. Ces instances primaires sont parfois appelées primaires" 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 utilisez 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 du catalogue

Si votre catalogue figure dans Merchant Center, recommandez d'importer votre catalogue en associant vos votre compte Merchant Center.

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

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. C'est important car pour modifier la configuration d'un catalogue existant, vous devez supprimer catalogue et le réimporter (voir 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 englobe:

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 de niveau produit

Pour les marchands qui ne vendent qu'en ligne, l'inventaire est spécifié au niveau du produit. Les données de prix, de disponibilité et d'autres données d'inventaire sont définies pour chaque produit 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 cela, il utilise l'inventaire en magasin.

Vous pouvez utiliser deux champs de produit pour stocker l'inventaire en magasin. Les deux sont des listes d'établissements (identifiants de lieu) avec les informations d'inventaire associées:

Product.fulfillmentInfo. Modes de retrait et de livraison disponibles chaque adresse de 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 du La console Search for Retail détermine si une mise à jour est nécessaire des données de catalogue pour améliorer la qualité des résultats de recherche les niveaux de performances sur le Réseau de Recherche.

Le tableau suivant décrit les métriques de qualité utilisées par Vertex AI Search pour le commerce pour à é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.

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.	La recherche utilise des signaux Web explorés à l'aide de 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 de produit 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 ci-dessous pour créer une table BigQuery au format adapté et y insérer vos données de catalogue. Ensuite, importez le catalogue.

Schéma de Vertex AI Search pour le commerce

BigQuery

[
  {
    "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"
      }
    ]
  }
]