Conditions requises pour la configuration

Avant de pouvoir configurer Vertex AI Search pour le commerce pour un nouveau projet, vous devez:

  1. Créez un projet ou configurez un projet existant.
  2. Activer Vertex AI Search pour le commerce
  3. Importer votre catalogue de produits et vos événements utilisateur

Créer un projet Google Cloud

  1. Sur la page Gérer les ressources de la console Google Cloud, sélectionnez ou créez un projet Google Cloud.

    Accéder à la page "Gérer les ressources"

  2. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier si la facturation est activée sur un projet.

Configurer Vertex AI Search pour le commerce

Pour utiliser Vertex AI Search pour le commerce, procédez comme suit. De plus, si vous activez Vertex AI Search pour le commerce et que vous utilisez des recommandations, sachez que les coûts sont basés sur le nombre de requêtes. Pour en savoir plus sur les tarifs de Vertex AI Search pour le commerce, consultez la page Frais de Vertex AI Search pour le commerce.

Pour votre nouveau projet

Pour configurer Vertex AI Search pour le commerce:

  1. Accédez à la page Vertex AI Search for retail (Recherche Vertex AI pour le commerce) dans la console Google Cloud.

    Accéder à la page "Search for Retail"

  2. Sur la page Configurer Vertex AI Search pour le commerce, cliquez sur Activer l'API.

  3. Lorsque Vertex AI Search pour le commerce et Recommendations AI affichent l'état Activé, cliquez sur Continuer.

  4. Lisez les Conditions d'utilisation des données de Vertex AI Search pour l'industrie, puis cliquez sur Accepter si vous les acceptez. Vous recevrez une confirmation de la part de la console Google Cloud une fois les conditions acceptées pour la recherche.

  5. Si vous souhaitez utiliser le projet avec des recommandations uniquement, cliquez sur Premiers pas

  6. Pour activer la recherche en plus des recommandations, procédez comme suit :

    1. Cliquez sur Continuer, puis sur Activer sur la page Activer la recherche (facultatif).
    2. Cliquez sur Commencer.

    La console Google Cloud affiche les composants Vertex AI Search pour le commerce que vous avez activés. Vous pouvez maintenant configurer les paramètres initiaux de votre projet.

Pour un projet existant

Pour continuer sur un projet existant, procédez comme suit:

  1. Accédez à la page Search for Retail dans la console Google Cloud pour votre projet.

    Accéder à la page "Search for Retail"

  2. Sur la page Conditions d'utilisation des données, lisez les conditions d'utilisation des données des solutions de découverte et cliquez sur Accepter si vous les acceptez.

  3. Si vous souhaitez utiliser le projet avec les recommandations uniquement, cliquez sur Commencer.

  4. Si vous souhaitez activer la recherche en plus des recommandations, procédez comme suit :

    1. Cliquez sur Continuer, puis sur Activer sur la page Activer la recherche (facultatif).
    2. Cliquez sur Commencer.

Désactiver les fonctionnalités de recherche

Si vous ne souhaitez plus utiliser la recherche, vous pouvez la désactiver en envoyant une demande d'assistance.

Pour attribuer votre demande au bon composant, sélectionnez les champs suivants :

  • Catégorie : Machine learning
  • Composant: Vertex AI Search pour le commerce: recherche et parcourir
  • Sous-composant : Administration et facturation du compte

Pour en savoir plus sur la création d'une demande d'assistance, consultez la page Obtenir de l'aide.

Désactiver Vertex AI Search pour le commerce

Vous pouvez désactiver Vertex AI Search pour le commerce à tout moment. Les recommandations et la recherche sont alors désactivées.

Pour désactiver Vertex AI Search pour le commerce, procédez comme suit:

  1. Accédez à la page API/Détails du service Vertex AI Search pour le commerce dans les console Google Cloud.

    Accéder à la page d'informations du service de l'API Vertex AI Search pour le commerce

  2. Cliquez sur Désactiver l'API.

  3. Dans la zone Désactiver l'API Vertex AI Search pour le commerce, cliquez sur Désactiver.

Premiers pas avec Vertex AI Search pour le commerce

Lorsque vous configurez Vertex AI Search pour le commerce pour un nouveau projet, la console Google Cloud affiche les trois panneaux suivants pour vous aider à configurer votre projet Vertex AI Search pour le commerce :

  • Données > Catalogue: affiche votre catalogue de produits et un lien d'importation. votre catalogue.

  • Données > Événements : affiche vos événements utilisateur et un lien permettant d'importer un historique d'événements utilisateur.

  • Configurations de diffusion : contient des informations sur votre configuration de diffusion et un lien permettant de créer une configuration de diffusion.

Vous pouvez utiliser ces panneaux pour importer vos données et créer une de votre projet Vertex AI Search pour le commerce.

Importer votre catalogue de produits

Pour importer votre catalogue de produits, suivez la procédure correspondant à votre source de données. Pour en savoir plus sur les catalogues de produits, consultez Importer des informations du catalogue

Synchronisation Merchant Center

  1. Cliquez sur Importer un catalogue de produits pour ouvrir le panneau Importer des données.
  2. Sélectionnez Catalogue de produits.
  3. Sélectionnez Merchant Center Sync comme source de données.
  4. Sélectionnez votre compte Merchant Center. Si vous ne voyez pas votre compte, cochez la case Accès utilisateur.
  5. Facultatif: Sélectionnez Filtre de flux Merchant Center pour importer uniquement les offres des flux sélectionnés.

    Si aucune valeur n'est spécifiée, les offres de tous les flux sont importées (y compris les futurs flux).
  6. Facultatif: Pour importer uniquement des offres ciblant certains pays ou certaines langues, développez Afficher les options avancées, puis sélectionnez les pays de vente et les langues Merchant Center à filtrer.
  7. Sélectionnez la branche dans laquelle vous allez importer votre catalogue.
  8. Cliquez sur Importer.

Cloud Storage

  1. Cliquez sur Importer un catalogue de produits pour ouvrir le panneau Importer des données.
  2. Sélectionnez Catalogue de produits comme source de données.
  3. Sélectionnez la branche dans laquelle vous allez importer votre catalogue.
  4. Sélectionnez Schéma des catalogues de produits Retail comme schéma.
  5. Saisissez l'emplacement Cloud Storage de vos données.
  6. Si la recherche n'est pas activée, sélectionnez les niveaux de produits.

    Vous devez sélectionnez les niveaux de produits s'il s'agit de la première importation de votre catalogue réimporter le catalogue après l'avoir supprimé définitivement. En savoir plus sur les niveaux de produits. La modification des niveaux de produit après l'importation de données nécessite un effort considérable.

    Important : Vous ne pouvez pas activer la recherche pour les projets avec un catalogue de produits ingéré en tant que variantes.
  7. Cliquez sur Importer.

BigQuery

  1. Cliquez sur Importer un catalogue de produits pour ouvrir le panneau Importer des données.
  2. Sélectionnez Catalogue de produits.
  3. Sélectionnez BigQuery comme source de données.
  4. Sélectionnez la branche dans laquelle vous allez importer votre catalogue.
  5. Choisissez l'un des schémas suivants :
  6. Renseignez la table BigQuery dans laquelle se trouvent vos données.
  7. Facultatif : Sous Afficher les options avancées, saisissez l'emplacement d'un bucket Cloud Storage de votre projet en tant qu'emplacement temporaire pour vos données.

    Si aucun emplacement n'est spécifié, un emplacement par défaut est utilisé. Si vous spécifiez un emplacement, BigQuery et le bucket Cloud Storage doivent se trouver dans la même région.
  8. Si la recherche n'est pas activée et que vous utilisez le schéma Merchant Center, sélectionnez le niveau du produit.

    Vous devez sélectionnez le niveau de produit s'il s'agit de la première importation de votre catalogue réimporter le catalogue après l'avoir supprimé définitivement. En savoir plus sur les niveaux de produits. Modification au niveau des produits une fois que vous avez importé des données, cela exige un effort important.

    Important : Vous ne pouvez pas activer la recherche pour les projets avec un catalogue de produits ingéré en tant que variantes.
  9. Cliquez sur Importer.

Importer l'historique de vos événements utilisateur

Pour importer l'historique de vos événements utilisateur, suivez la procédure correspondant à votre source de données. Pour en savoir plus sur l'historique des événements utilisateur, consultez Importer des événements utilisateur historiques

Cloud Storage

  1. Cliquez sur Importer des événements utilisateur pour ouvrir le panneau Importer des données.
  2. Sélectionnez Événements utilisateur.
  3. Sélectionnez Google Cloud Storage comme source de données.
  4. Sélectionnez le schéma Retail User Events Schema (Schéma des événements utilisateur Retail).
  5. Saisissez l'emplacement Cloud Storage de vos données.
  6. Cliquez sur Importer.

BigQuery

  1. Cliquez sur Importer des événements utilisateur pour ouvrir le panneau Importer des données.
  2. Sélectionnez Événements utilisateur.
  3. Sélectionnez BigQuery comme source de données.

  4. Sélectionnez le schéma de données.

  5. Renseignez la table BigQuery dans laquelle se trouvent vos données.
  6. Facultatif: Saisissez l'emplacement d'un bucket Cloud Storage dans votre projet en tant qu'emplacement temporaire pour vos données.
    S'il n'est pas spécifié, l'emplacement par défaut est utilisé. Si vous spécifiez un emplacement, BigQuery et le bucket Cloud Storage doivent se trouver dans la même région.
  7. Facultatif: Sous Afficher les options avancées, saisissez l'emplacement d'un bucket Cloud Storage de votre projet en tant qu'emplacement temporaire pour vos données.

    Si aucun emplacement n'est spécifié, un emplacement par défaut est utilisé. Si vous spécifiez un emplacement, BigQuery et le bucket Cloud Storage doivent se trouver dans la même région.
  8. Cliquez sur Importer.

Créer une configuration de diffusion

Une configuration de diffusion est une entité de diffusion qui associe un modèle ou un ensemble de commandes permettant de générer vos résultats de recherche ou de recommandation.

Pour créer une configuration de diffusion, procédez comme suit :

  1. Dans le panneau Configurations de diffusion, cliquez sur Créer une configuration de diffusion.
  2. Sur la page Créer une configuration de diffusion, sélectionnez Rechercher comme produit et configurer la diffusion. sera utilisé.
  3. Attribuez un nom à votre configuration de diffusion.

    Le nom doit être 1 024 caractères maximum, et ne peut contenir que des caractères alphanumériques des traits de soulignement, des traits d'union et des espaces.
  4. Facultatif : Si nécessaire, mettez à jour l'ID.

    L'ID est généré à partir du nom que vous fournissez et doit être unique dans votre projet. Il doit comporter 50 caractères au maximum, et ne peut pas contenir d'espaces.
  5. Cliquez sur Continuer.
  6. Choisissez d'activer ou non les attributs dynamiques pour cette configuration de diffusion.
  7. Choisissez ou créez des commandes de diffusion pour optimiser vos recherches.

    Pour en savoir plus pour plus d'informations sur les commandes, consultez la page Créer et gérer des commandes.

Gérer les ressources et surveiller l'activité

Une fois la configuration initiale de votre projet terminée, Le tableau de bord de la console Google Cloud affiche l'état du système Projet Vertex AI Search pour le commerce. Le tableau de bord de la console vous permet de gérer les ressources de surveiller l'activité.

Accéder à la console Search for Retail

Créer une clé API

Une clé API est requise si vous utilisez un pixel JavaScript ou un tag Tag Manager pour capturer les événements utilisateur à partir des navigateurs des utilisateurs. Pour en savoir plus sur les méthodes permettant de capturer des événements utilisateur, consultez Enregistrer des événements utilisateur en temps réel.

Pour créer une clé API pour les appels à la méthode userEvents.Collect , procédez comme suit:

  1. Accédez à la page Identifiants de la console Google Cloud.

  2. Dans la liste déroulante du projet en haut de la page de la console Google Cloud, sélectionnez votre projet (le projet est peut-être déjà sélectionné).

  3. Cliquez sur Créer des identifiants, puis sélectionnez Clé API. N'ajoutez aucune restriction d'application pour les sites Web. Il est connu que certains paramètres de confidentialité de l'utilisateur ne transmettent pas l'URL de provenance.

    • Prenez note de la clé API générée, que vous utiliserez lorsque vous appelez la journalisation des événements utilisateur.

  4. Pour renforcer la sécurité, ajoutez une restriction d'API à votre clé API afin de restreindre l'accès au service Vertex AI Réseau de Recherche pour le commerce à l'adresse https://retail.googleapis.com/*.

Étape suivante