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 et les recommandations, vous devez activer Vertex AI Search pour le commerce et accepter les conditions d'utilisation de Vertex AI Search pour le secteur. 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 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 Recherche pour le commerce

  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 de Vertex AI Search pour l'utilisation des données, puis cliquez sur Accepter si vous les acceptez.

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

  5. Si vous souhaitez utiliser uniquement le projet 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 dans 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 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.

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 Rechercher pour le commerce dans la console Google Cloud de votre projet.

    Accéder à la page Recherche pour le 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 acceptez.

  3. Si vous souhaitez utiliser uniquement le projet 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 et facturation des comptes

Pour plus d'informations 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 Vertex AI Search for Retail/Détails du service dans la console Google Cloud.

    Accéder à la page d'informations du service de l'API Vertex AI Search for Retail

  2. Cliquez sur Désactiver l'API.

  3. Dans la zone Désactiver Vertex AI Search pour l'API Retail ?, 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 pour l'importer.

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

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

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 l'ensemble des étapes pour 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 votre compte n'apparaît pas, vérifiez Accès des utilisateurs.
  5. Facultatif: Sélectionnez Filtre des flux Merchant Center pour n'importer que les offres des flux sélectionnés.

    Si ce n'est pas le cas, les offres de tous les flux sont importées (y compris les futurs flux).
  6. Facultatif: Pour importer uniquement les offres ciblant certains pays ou certaines langues, développez Afficher les options avancées, puis sélectionnez les pays de vente de Merchant Center et les langues à 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 des catalogues de produits vendus au détail) 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 des produits.

    Vous devez sélectionner les niveaux de produits si vous importez votre catalogue pour la première fois ou si vous réimportez 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 des données demande un effort important.

    Important:Vous ne pouvez pas activer la recherche de 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 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 option est spécifiée, les buckets BigQuery et 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électionner le niveau du produit si vous importez votre catalogue pour la première fois ou si vous réimportez le catalogue après l'avoir purgé. En savoir plus sur les niveaux de produits La modification des niveaux de produit après l'importation des données demande un effort important.

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

Importer l'historique des événements utilisateur

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

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. Choisissez Retail User Events Schema (Schéma des événements utilisateur Retail) 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.

  5. Renseignez la table BigQuery dans laquelle se trouvent vos données.
  6. Facultatif: indiquez l'emplacement d'un bucket Cloud Storage dans votre projet comme emplacement temporaire pour vos données.
    Si aucune valeur n'est spécifiée, un emplacement par défaut est utilisé. Si cette option est spécifiée, les buckets BigQuery et 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 option est spécifiée, les buckets BigQuery et 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.

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 pour lequel la configuration de diffusion sera utilisée.
  3. Attribuez un nom à votre configuration de diffusion.

    Le nom 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: mettez à jour l'ID si nécessaire.

    L'ID est généré à partir du nom que vous fournissez et doit être unique dans votre projet. Il ne doit pas comporter plus de 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 vous permet de gérer les ressources et de surveiller l'activité.

Accéder à la console Search for Retail

Configurer l'authentification pour votre application

Vous devez configurer l'authentification afin que les applications, telles que votre site d'e-commerce, puissent accéder à Vertex AI Search pour le commerce:

  • Compte de service. Les applications utilisent un compte de service pour authentifier les appels à Product. Pour configurer un compte de service, consultez la section Créer un compte de service ci-dessous.

  • Clé API. Les applications utilisent une clé API pour les appels à la méthode userEvents.Collect. Vous ne devez configurer cette méthode d'authentification que si vous souhaitez capturer les événements utilisateur des navigateurs des utilisateurs via un pixel JavaScript ou Google Tag Manager. Pour configurer une clé API, consultez Créer une clé API ci-dessous.

Créer un compte de service

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

  2. Sélectionnez le projet dans lequel vous créez un compte de service (le projet est peut-être déjà sélectionné).

  3. Cliquez sur Créer des identifiants, puis sélectionnez Compte de service.

    La page Créer un compte de service s'ouvre.

  4. Sous Détails du compte de service, renseignez les champs suivants:

    • Nom du compte de service: nom à afficher pour votre compte de service.
    • ID de compte de service: nom unique de votre compte de service. Vous pouvez utiliser l'ID par défaut fourni ou le remplacer par un ID personnalisé.
    • Description du compte de service: facultatif. Description du compte.

  5. Cliquez sur Créer et continuer pour créer le compte de service et lui accorder l'accès à votre projet.

  6. Sous Autoriser ce compte de service à accéder au projet, ajoutez les rôles suivants:

    • Comptes de service > Créateur de jetons du compte de service
    • Autre > Éditeur Retail

  7. Facultatif: pour accorder à des utilisateurs ou à des groupes l'accès au compte de service qui doivent effectuer des actions en tant que compte de service, cliquez sur Continuer et saisissez les informations de compte de l'utilisateur ou du groupe.

  8. Cliquez sur OK pour enregistrer les modifications.

Ajouter le compte de service à votre environnement local

Si vous souhaitez appeler Vertex AI Search pour le commerce à l'aide de l'outil de ligne de commande cURL, vous devez rendre votre compte de service disponible dans votre environnement local.

Pour obtenir un fichier JSON de clé de compte de service, suivez les instructions de la section Créer et gérer des comptes de service.

Le fichier JSON contient la clé publique/privée de votre compte de service. Ce fichier JSON est la seule copie de la clé pour votre compte de service. Assurez-vous de le stocker dans un endroit sûr.

Le fichier de clé JSON doit être stocké dans un emplacement accessible depuis votre application.

cURL utilise la commande gcloud auth application-default print-access-token pour obtenir un jeton d'accès pour votre compte de service à l'aide de la Google Cloud CLI. Pour télécharger et installer la gcloud CLI, consultez gcloud CLI. Si vous utilisez Cloud Shell, gcloud CLI est déjà installée.

La variable d'environnement GOOGLE_APPLICATION_CREDENTIALS ne sera pas conservée si vous fermez votre fenêtre de commande. Pour vous assurer que la variable est définie sur le chemin d'accès au fichier de votre compte de service à chaque ouverture d'une nouvelle fenêtre de commande, définissez la valeur dans un script shell d'initialisation.

  export GOOGLE_APPLICATION_CREDENTIALS=path-to-service-account-json-key-file

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 provenant de leurs navigateurs. 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 de 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 utilisez lorsque vous appelez 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 sur https://retail.googleapis.com/*.

Examples

S'authentifier à l'aide d'un compte de service (OAuth 2.0)

Voici un exemple Java d'authentification OAuth 2.0 utilisant un compte de service. Vous trouverez des instructions plus détaillées dans la documentation de l'authentification. Google dispose de bibliothèques clientes disponibles en sept langages pour implémenter l'authentification OAuth2 dans votre application. Si vous préférez implémenter directement HTTP/REST, suivez les instructions d'authentification REST.

Dans l'exemple, remplacez your-service-account-json-key-file par le chemin d'accès au fichier de clé JSON de votre compte de service.

// Simple Java example of using Google Cloud OAuth client library.
//
// Please see here for the list of libraries in different languages:
// https://developers.google.com/identity/protocols/OAuth2#libraries
//
// The following example depends on the google api client library.
//
// Maven:
//    <dependency>
//      <groupId>com.google.api-client</groupId>
//      <artifactId>google-api-client</artifactId>
//      <version>1.22.0</version>
//    </dependency>
import com.google.api.client.googleapis.auth.oauth2.GoogleCredential;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.GenericUrl;
import com.google.api.client.http.HttpRequest;
import com.google.api.client.http.HttpRequestFactory;
import com.google.api.client.http.HttpResponse;
import com.google.api.client.http.HttpTransport;
import com.google.api.client.http.json.JsonHttpContent;
import com.google.api.client.json.GenericJson;
import com.google.api.client.json.jackson2.JacksonFactory;
import java.io.FileInputStream;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collections;
import java.util.List;

public class RetailApiSample {
  public static final String CREATE_PRODUCT_URL =
     "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products";

  public static GoogleCredential authorize() throws Exception {
    return GoogleCredential.fromStream(new FileInputStream("your-service-account-json-key-file"))
        .createScoped(Collections.singleton("https://www.googleapis.com/auth/cloud-platform"))
        .setExpirationTimeMilliseconds(new Long(3600 * 1000));;
  }

  // Build an example product.
  public static GenericJson getProduct() {
    GenericJson categories = new GenericJson()
        .set("categories", Arrays.asList("Electronics > Computers", "Laptops"));
    GenericJson priceInfo = new GenericJson()
        .set("currency_code", "USD")
        .set("price", 800.00)
        .set("original_price", 1000.00);

    return new GenericJson()
        .set("name", "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/[ProductName]")
        .set("title", "Sample Laptop")
        .set("description", "Indisputably the most fantastic laptop ever created.")
        .set("categories", categories)
        .set("price_info", priceInfo)
        .set("availability", "IN_STOCK")
        .set("available_quantity", 1219);
  }

  public static void main(String[] args) {
    try {
      GoogleCredential credential = RetailApiSample.authorize();

      HttpTransport httpTransport = GoogleNetHttpTransport.newTrustedTransport();
      HttpRequestFactory requestFactory = httpTransport.createRequestFactory();
      HttpRequest request = requestFactory.buildPostRequest(new GenericUrl(CREATE_PRODUCT_URL),
          new JsonHttpContent(new JacksonFactory(), RetailApiSample.getProduct()));
      credential.initialize(request);
      HttpResponse response = request.execute();
      System.out.println("Response content: " + response.parseAsString());
    } catch (Exception e) {
      e.printStackTrace();
    }
  }
}

Étapes suivantes