Conditions requises pour la configuration

Avant de configurer Agent Platform Search pour le commerce pour un nouveau projet, vous devez :

1. Créer un projet ou configurer votre projet existant
2. Activer Agent Platform Search pour le commerce
3. Importer votre catalogue de produits et vos événements utilisateur

Créez un Google Cloud projet

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

   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 Agent Platform Search pour le commerce

Pour utiliser Agent Platform Search pour le commerce, procédez comme suit. De plus, si vous activez Agent Platform 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 d'Agent Platform Search pour le commerce, consultez Tarifs d'Agent Platform Search pour le commerce.

**Important** : Vous devez accepter les conditions d'utilisation d'Agent Platform Search pour le secteur d'activité pour chaque projet avec lequel vous souhaitez utiliser Agent Platform Search pour le commerce.

Pour votre nouveau projet

Pour configurer Agent Platform Search pour le commerce :

1. Accédez à la page Agent Platform Search pour le commerce de la Google Cloud console.

   Accéder à la page "Search for commerce"

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

3. Lorsque Agent Platform Search pour le commerce et IA de recommandations sont activés, cliquez sur Continuer.

4. Lisez les conditions d'utilisation des données d'Agent Platform Search pour le secteur d'activité pour l'utilisation des données et cliquez sur Accepter si vous les approuvez. Vous recevrez une confirmation de la Google Cloud console une fois les conditions acceptées pour la recherche.

5. Si vous ne souhaitez utiliser le projet qu'avec des recommandations, cliquez sur Commencer.

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 Google Cloud console affiche les composants d'Agent Platform 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 commerce de la Google Cloud console pour votre projet.

   Accéder à la page "Search for commerce"

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

3. Si vous ne souhaitez utiliser le projet qu'avec des recommandations, cliquez sur Commencer.

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

Important : Assurez-vous de disposer du rôle Administrateur Retail ou Propriétaire pour votre projet avant d'accepter les conditions d'utilisation des données.

Désactiver les fonctionnalités de recherche

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

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

• Catégorie : Machine learning
• Composant : Agent Platform Search pour le commerce : recherche et navigation
• Sous-composant : Administration du compte et facturation

Pour en savoir plus sur la création d'un ticket d'assistance, consultez la page Assistance.

Désactiver Agent Platform Search pour le commerce

Vous pouvez désactiver Agent Platform Search pour le commerce à tout moment. Cette action désactive à la fois les recommandations et la recherche.

Pour désactiver Agent Platform Search pour le commerce, procédez comme suit :

1. Accédez à la page Détails de l'API/du service Agent Platform Search pour Retail dans la Google Cloud console.

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

2. Cliquez sur Désactiver l'API.

3. Dans la boîte de dialogue Désactiver l'API Agent Platform Search pour le commerce ?, cliquez sur Désactiver.

Remarque : Lorsque vous désactivez l'API Agent Platform Search pour le commerce, plusieurs heures sont nécessaires pour que les conditions d'utilisation des données d'Agent Platform Search pour le secteur d'activité soient désactivées pour le projet.

Premiers pas avec Agent Platform Search pour le commerce

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

• Données > Catalogue : affiche votre catalogue de produits et un lien pour importer votre catalogue.

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

• Configurations de diffusion : contient des informations 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 Agent Platform Search pour le commerce.

Importer votre catalogue de produits

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

Obsolète : Le connecteur Merchant Center est obsolète et n'est disponible que pour les utilisateurs actuels. Les nouveaux utilisateurs doivent utiliser l'API Catalog ou BigQuery pour importer des catalogues.

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 Synchronisation Merchant Center comme source de données.
4. Sélectionnez votre compte Merchant Center. Vérifiez l'accès utilisateur si vous ne voyez pas votre compte.
5. Facultatif : Sélectionnez Filtre des flux Merchant Center pour n'importer que les offres des flux sélectionnés.
   
   Si vous ne spécifiez rien, les offres de tous les flux sont importées (y compris les flux futurs).
6. Facultatif : Pour n'importer que les offres ciblées sur certains pays ou certaines langues, développez Afficher les options avancées et 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 Retail pour les catalogues de produits 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 après sa suppression. En savoir plus sur les niveaux de produit. 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 dont le catalogue de produits 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 Retail pour les catalogues de produits : le schéma de produit pour Agent Platform 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 de votre projet en tant qu'emplacement temporaire pour vos données.
   
   Si vous ne spécifiez rien, une position par défaut est utilisée. 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 de produit.
   
   Vous devez sélectionner le niveau de produit si vous importez votre catalogue pour la première fois ou si vous le réimportez après sa suppression. En savoir plus sur les niveaux de produit. 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 dont le catalogue de produits a été ingéré en tant que variantes.
9. Cliquez sur Importer.

Importer vos événements utilisateur historiques

Pour importer vos événements utilisateur historiques, suivez les étapes correspondant à votre source de données. Pour en savoir plus sur les événements utilisateur historiques, consultez Importer un historique d'événements utilisateur.

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 Schéma Retail pour les événements utilisateur comme schéma.
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 : à utiliser pour les événements Google Analytics 4.
   • Google Analytics 360 : à utiliser pour les événements Google Analytics 360, sauf si vous n'importez que les vues de la page d'accueil depuis Google Analytics 360 (dans ce cas, utilisez Schéma Retail pour les événements utilisateur).
   • Schéma Retail pour les événements utilisateur : à utiliser pour importer des événements provenant de sources autres que Google Analytics et pour importer uniquement les vues de la page d'accueil 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 de votre projet en tant qu'emplacement temporaire pour vos données.
   Si vous ne spécifiez rien, 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.
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 vous ne spécifiez rien, 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 contrôles permettant de générer vos résultats de recherche ou de recommandation.

Remarque : Agent Platform 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 Search comme produit pour lequel la configuration de diffusion sera utilisée.
3. Attribuez un nom à votre configuration de diffusion.
   
   Ce nom doit comporter 1 024 caractères au 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 ou moins 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. Sélectionnez ou créez des contrôles de diffusion pour optimiser vos recherches.
   
   Pour en savoir plus sur les contrôles, consultez Créer et gérer des contrôles.

Gérer les ressources et surveiller l'activité

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

Accéder à la console Search for commerce

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 à partir des navigateurs des utilisateurs. 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 userEvents.Collect méthode, procédez comme suit :

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

2. Dans la liste déroulante de projet en haut de la page de la Google Cloud console, 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 d'application 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 lors des appels à l'API de 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 Agent Platform Search pour le commerce à l'adresse https://retail.googleapis.com/*.

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

Étape suivante

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