Changement de nom : le secteur de la vente au détail s'appelle Vertex AI Search pour le commerce. Nous sommes en train de mettre à jour le contenu pour refléter le nouveau branding.

À 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 donc sur la qualité des résultats de recherche et des 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 les branches du catalogue pour tester les nouvelles données que vous avez importées hors connexion avant de les publier 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. Spécifiez la branche qui correspond actuellement à votre default_branch active (définie sur la branche 0 par défaut) à l'aide de setDefaultBranch ou de l'onglet "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 renvoie.

Par exemple, supposons que default_branch est actuellement 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. Après avoir vérifié que le catalogue a été importé correctement, vous pouvez basculer sur la branche 1 en tant que default_branch active.

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

Si vous utilisez les 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.

Champ	Notes
`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 chacune d'entre elles. La valeur doit être une chaîne non vide encodée au format UTF-8 et d'une limite de 5 000 caractères. Spécifiez 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 niveaux de produits déterminent la hiérarchie de votre catalogue. En règle générale, vous devez choisir entre un catalogue à un seul niveau ou un catalogue à deux niveaux.

Par exemple, vous pouvez avoir un catalogue à un seul niveau dans lequel chaque article de produit a un SKU. Vous pouvez également choisir un catalogue à deux niveaux contenant à la fois des groupes de SKU et des SKU individuels.

Types de produit

Il existe trois types de niveaux de produit:

Les éléments principal sont renvoyés dans les recommandations ou les résultats de recherche. Les éléments principaux peuvent être des éléments 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 d'un groupe de SKU. Les variantes ne peuvent être que des articles individuels (au niveau du SKU). Par exemple, si le produit principal est "T-shirt à col en V", les variantes peuvent être "Chemise à col en V marron, taille XL" et "Chemise à col en V blanche, taille S". Les éléments primaires et les variantes sont parfois décrits comme des éléments parent et enfant.
Les éléments de collection sont des collections de produits. Les collections sont des lots de produits principaux ou de variantes de produits. Par exemple, une collection peut être un bijou avec un collier, des boucles d'oreille et une bague. Les collections ne sont disponibles que dans la recherche et ne sont pas largement utilisées.

À propos de la hiérarchie du catalogue

Lorsque vous planifiez la hiérarchie de votre catalogue, vous devez décider si votre catalogue ne doit contenir que des primaires ou des variantes principales et des variantes. N'oubliez pas que la prédiction et les résultats de recherche ne renvoient que des éléments principaux.

Par exemple, un catalogue réservé à une utilisation principale peut convenir à la vente de livres, où un panneau de recommandations affiche une sélection de livres, chacun avec son propre code SKU. Toutefois, un catalogue de tee-shirts uniquement principal affichera probablement le même tee-shirt dans chaque taille disponible dans le panneau de recommandations.

Il est préférable que le catalogue de tee-shirts comporte à la fois des valeurs principales et des variantes, les SKU en tant que variantes (une variante pour chaque taille) et les primaires représentant les groupes de SKU pour les tailles de chaque style de tee-shirt. Ce catalogue sur deux niveaux permet au panneau des recommandations d'afficher toute une gamme de styles de t-shirts similaires. L'acheteur peut afficher le détail d'une instance principale (style) spécifique pour sélectionner la variante (la taille) à acheter.

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. Une valeur principale est déduite pour chaque variante en fonction d'un ID produit principal spécifié pour chaque variante.

Produits de base minimaux

Si vous déterminez que votre catalogue doit contenir à la fois des valeurs principales et des variantes, c'est-à-dire des groupes de SKU et des SKU, mais que vous n'avez maintenant que des SKU, vous devez créer des primaires pour les groupes de SKU. Ces primaires sont parfois appelées "principales virtuelles" ou "fausses primaires".

Ces instances principales 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 des données, vous n'avez pas besoin de spécifier name. Pour en savoir plus, consultez la section précédente intitulée Informations obligatoires sur le produit.

Le type est immuable

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

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

Importation de catalogue

Si vous disposez actuellement de votre 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 groupée de données.

Si vous prévoyez d'importer des données de catalogue depuis Merchant Center à l'avenir, examinez vos données comme décrit pour les importations Merchant Center afin de vous assurer que vous faites les bons choix concernant votre catalogue. Ce point est important, car pour modifier la configuration d'un catalogue existant, vous devez le supprimer, puis l'importer à nouveau (consultez Modifier la configuration au niveau du produit).

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

Inventaire de produits

L'inventaire de produits englobe:

Prix (prix actuel et prix d'origine)
La disponibilité, par exemple "en stock", "non disponible", "en cours de réapprovisionnement" ou "précommandé"
Quantité disponible
les informations sur le traitement des commandes (retrait en magasin, livraison en magasin et livraison le jour suivant, par exemple) ;

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

Inventaire de 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 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 les informations d'inventaire par magasin. Pour ce faire, elle utilise l'inventaire en magasin.

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

Product.fulfillmentInfo. Modes de retrait et de livraison dans chaque magasin
Product.localInventories. Informations sur le prix, attributs des produits, et modes de retrait et de livraison dans chaque magasin

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

Pour en savoir plus sur les inventaires en magasin, consultez la page Mettre à jour l'inventaire en magasin pour Vertex AI Search 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 du catalogue pour améliorer la qualité des résultats de recherche et débloquer des niveaux de performances de recherche.

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

Métrique de qualité de catalogue	Règle de qualité	Notes
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 via cet URI pour améliorer la qualité de la 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 depuis BigQuery, utilisez le schéma de produit Vertex AI Search pour le commerce ci-dessous pour créer une table BigQuery au format approprié et la charger avec 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"
      }
    ]
  }
]