Avant de commencer

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 ainsi que les recommandations, vous devez activer Vertex AI Search pour le commerce et accepter les Conditions d'utilisation de Vertex AI Search pour le secteur concernant l'utilisation des données. Si vous utilisez également la recherche, vous devez l'activer. L'utilisation de la recherche entraîne des coûts supplémentaires en fonction du nombre de requêtes. Pour en savoir plus, consultez la section Frais liés à la recherche.

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

1. Accédez à la page Vertex AI Search 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 le secteur et cliquez sur Accepter si vous les acceptez.

   Lorsque vous acceptez les conditions d'utilisation des données, la console Google Cloud indique que vous acceptez les conditions d'utilisation des données de Vertex AI Search pour le commerce.

   Important :Vous devez accepter les conditions d'utilisation de Vertex AI Search pour le secteur pour chaque projet avec lequel vous souhaitez utiliser Vertex AI Search pour le commerce.

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

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

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.

Configurer pour un projet existant

Si vous avez configuré Vertex AI Search pour le commerce sur un projet Google Cloud avant l'entrée en vigueur des conditions d'utilisation des données le 4 avril 2022, vous devez accepter les conditions d'utilisation de Vertex AI Search pour le secteur afin de continuer à utiliser Vertex AI Search pour le commerce avec ce projet. Vous devez également activer la recherche pour ce projet, si nécessaire.

Important :Vous devez accepter les conditions d'utilisation des données pour chaque projet avec lequel vous souhaitez utiliser Vertex AI Search pour le commerce.

Pour accepter les conditions d'utilisation de Vertex AI Search pour le secteur pour 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.

   Important :Vous ne pouvez accepter les conditions d'utilisation des données que si vous disposez du rôle d'administrateur ou de propriétaire Retail pour le projet.

3. Si vous souhaitez utiliser le projet uniquement avec des recommandations, 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 la recherche ou Vertex AI Search pour le commerce

Désactiver la recherche

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

Pour définir le composant approprié pour votre billet, sélectionnez les champs suivants:

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

Pour plus d'informations sur la création d'une demande d'assistance, consultez la section Obtenir de l'aide.

Désactiver Vertex AI Search pour le commerce

Vous pouvez désactiver Vertex AI Search pour le commerce à tout moment en le désactivant. Cela désactive à la fois les recommandations et la recherche.

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

Remarque :Lorsque vous désactivez l'API Vertex AI Search pour le commerce, plusieurs heures peuvent s'écouler avant que les conditions d'utilisation de Vertex AI Search pour le secteur soient désactivées pour le projet.

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 pour l'importer.

• Données > Événements: affiche vos événements utilisateur et un lien pour importer l'historique des événements utilisateur.

• Configurations de diffusion: contient des détails sur votre configuration de diffusion et un lien pour en créer une.

Vous pouvez utiliser ces panneaux pour importer vos données et créer une configuration initiale pour 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 la page 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 Retail Product Catalogs Schema (Schéma Retail Product Catalogs) 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 produit.
   
   Vous devez sélectionner les niveaux de produit si vous importez votre catalogue pour la première fois ou si vous le réimportez définitivement. En savoir plus sur les niveaux de produits La modification des niveaux de produit après avoir importé des données nécessite un effort important.
   
   Important:Vous ne pouvez pas activer la recherche de projets avec un catalogue de produits qui a été 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:
   • Schéma des catalogues de produits pour le commerce: schéma de produit pour Vertex AI Search pour le commerce
   • Merchant Center: schéma utilisé pour l'importation groupée depuis Merchant Center
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 dans votre projet en tant qu'emplacement temporaire pour vos données.
   
   Si aucune valeur n'est spécifiée, un emplacement par défaut est utilisé. Si cette valeur est spécifiée, le bucket 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 de produit.
   
   Vous devez sélectionner le niveau de produit s'il s'agit de la première importation de votre catalogue ou s'il est réimporté après sa suppression définitive. En savoir plus sur les niveaux de produits La modification des niveaux de produit après avoir importé des données nécessite un effort important.
   
   Important:Vous ne pouvez pas activer la recherche de projets avec un catalogue de produits qui a été ingéré en tant que variantes.
9. Cliquez sur Importer.

Importer l'historique des événements utilisateur

Pour importer votre historique des événements utilisateur, suivez l'ensemble des étapes pour votre source de données. Pour en savoir plus sur les événements utilisateur historiques, consultez Importer des événements utilisateur historiques.

Remarque :Vous pouvez également enregistrer des événements utilisateur en temps réel pour générer des recommandations et des résultats de recherche. Pour en savoir plus, consultez Enregistrer des événements utilisateur en temps réel.

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.

   • Google Analytics 4: utilisez cette option pour les événements Google Analytics 4.
   • Google Analytics 360: utilisez cette option pour les événements Google Analytics 360, sauf si vous n'importez que des événements de page d'accueil vues depuis Google Analytics 360 (dans ce cas, utilisez le schéma des événements utilisateur Retail).
   • Schéma des événements utilisateur Retail: permet d'importer des événements provenant de sources autres que Google Analytics et d'importer uniquement des événements de pages d'accueil vues depuis Google Analytics 360.
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.
   Si aucun emplacement n'est spécifié, un emplacement par défaut est utilisé. Si cette valeur est spécifiée, 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 dans votre projet en tant qu'emplacement temporaire pour vos données.
   
   Si aucune valeur n'est spécifiée, un emplacement par défaut est utilisé. Si cette valeur est spécifiée, le bucket 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 recommandations.

Remarque :Vertex AI Search pour le commerce crée une configuration de diffusion par défaut. Cette procédure est donc facultative si vous souhaitez créer une configuration de diffusion personnalisée.

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 Recherche comme produit pour lequel la configuration de diffusion sera utilisée.
3. Attribuez un nom à votre configuration de diffusion.
   
   Il ne doit pas comporter plus de 1 024 caractères. Il 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 ne doit pas dépasser 50 caractères et ne peut pas contenir d'espaces.
5. Cliquez sur Continuer.
6. Indiquez si vous souhaitez activer 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 sur les commandes, consultez Créer et gérer des commandes.

Le tableau de bord

Une fois la configuration initiale de votre projet terminée, la console Search for Retail affiche l'état du système de votre projet Vertex AI Search pour le commerce. La console permet de gérer les ressources et 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 une balise Tag Manager pour capturer les événements utilisateur dans leur navigateur. Pour en savoir plus sur les méthodes de capture 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 (il est peut-être déjà sélectionné).

3. Cliquez sur Créer des identifiants, puis sélectionnez Clé API. N'ajoutez aucune restriction pour les applications de site Web. Certains paramètres de confidentialité des utilisateurs ne transmettent pas l'URL de provenance.

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

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

Remarque :La clé API sert uniquement à authentifier la méthode userEvents.Collect. D'autres méthodes API nécessitent OAuth 2.0 via un compte de service ou un compte utilisateur.

Étapes suivantes

• Restreindre les clés API
• S'authentifier auprès de Vertex AI Search pour le commerce
• Identity and Access Management (IAM)
• Implémenter Vertex AI Search pour le commerce