Console
    Contact Us Start free

    Setup prerequisites

    Before you can set up Vertex AI Search for commerce for a new project, you must:

    1. Create a new project or set up your existing project
    2. Enable Vertex AI Search for commerce
    3. Import your product catalog and user events

    Create a Google Cloud project

    1. On the Manage resourcespage in the Google Cloud console, select or create a Google Cloud project .

      Go to the Manage Resources page

    2. Make sure that billing is enabled for your Cloud project. Learn how to check if billing is enabled on a project .

    Set up Vertex AI Search for commerce

    To use Vertex AI Search for commerce, take the following steps. Also, if you enable Vertex AI Search for commerce and use recommendations, know that costs are based on the number of queries. For more information on Vertex AI Search for commerce pricing, see Vertex AI Search for commerce charges .

    For your new project

    To set up Vertex AI Search for commerce:

    1. Go to the Vertex AI Search for commercepage in the Google Cloud console.

      Go to the Search for commerce page

    2. On the Set up Vertex AI Search for commercepage, click Turn on API.

    3. When Vertex AI Search for commerceand Recommendations AIdisplay as On, click Continue.

    4. Read the Vertex AI Search for Industry terms for data use for data use and click Acceptif you agree to the data use terms. You will receive confirmation from the Google Cloud console once the terms have been accepted for search.

    5. If you want to use the project with recommendations only, click Get Started.

    6. To turn on search in addition to recommendations, do the following:

      1. Click Continueand then click Turn onon the Turn on search (Optional)page.
      2. Click Get Started.

      The Google Cloud console displays the Vertex AI Search for commerce components that you have turned on. You can now configure your project's initial settings .

    For an existing project

    To continue on an existing project, complete these steps:

    1. Go to the Search for commercepage in the Google Cloud console for your project.

      Go to the Search for commerce page

    2. On the Data use termspage, read the Discovery Solutions data use terms and click Acceptif you agree to the terms.

    3. If you want to use the project with recommendations only, click Get Started.

    4. If you want to turn on search in addition to recommendations, do the following:

      1. Click Continueand then click Turn onon the Turn on search (Optional)page.
      2. Click Get Started.

    Turn off search features

    If you no longer want to use search, you can turn it off by submitting a support ticket.

    To set your ticket to the correct component, select the following fields:

    • Category: Machine Learning
    • Component: Vertex AI Search for commerce: search & browse
    • Subcomponent: Account Administration & Billing

    For more information on creating a support ticket, see Getting support .

    Turn off Vertex AI Search for commerce

    You can turn off Vertex AI Search for commerce at any time by disabling it. This turns off both recommendations and search.

    To turn off Vertex AI Search for commerce, complete the following steps:

    1. Go to the Vertex AI Search for Retail API/Service Detailspage in the Google Cloud console.

      Go to Vertex AI Search for commerce API Service Details page

    2. Click Disable API.

    3. In the Disable Vertex AI Search for commerce API?box, click Disable.

    Get started with Vertex AI Search for commerce

    When you set up Vertex AI Search for commerce for a new project, the Google Cloud console displays the following three panels to help you configure your Vertex AI Search for commerce project:

    • Data> Catalog: displays your product catalog and a link to import your catalog.

    • Data> Events: displays your user events and a link to import historical user events.

    • Serving configs: contains details on your serving config and a link to create a new serving config.

    You can use these panels to import your data and to create an initial configuration for your Vertex AI Search for commerce project.

    Import your product catalog

    To import your product catalog, complete the set of steps for your data source. For more information on product catalogs, see Importing catalog information .

    Merchant Center Sync

    1. Click Import product catalogto open the Import Datapanel.
    2. Choose Product catalog.
    3. Select Merchant Center Syncas your data source.
    4. Select your Merchant Center account. Check User Access if you don't see your account.
    5. Optional: Select Merchant Center feeds filterto import only offers from selected feeds.

      If not specified, offers from all feeds are imported (including future feeds).
    6. Optional: To import only offers targeted to certain countries or languages, expand Show Advanced Options and select Merchant Center countries of sale and languages to filter for.
    7. Select the branch you will upload your catalog to.
    8. Click Import.

    Cloud Storage

    1. Click Import product catalogto open the Import Datapanel.
    2. Choose Product catalogas your data source.
    3. Select the branch you will upload your catalog to.
    4. Choose Retail Product Catalogs Schemaas the schema.
    5. Enter the Cloud Storage location of your data.
    6. If you do not have search enabled, select the product levels.

      You must select the product levels if this is the first time you are importing your catalog or you are re-importing the catalog after purging it. Learn more about product levels. Changing product levels after you have imported any data requires a significant effort.

      Important:You can't turn on search for projects with a product catalog that has been ingested as variants.
    7. Click Import.

    BigQuery

    1. Click Import product catalogto open the Import Datapanel.
    2. Choose Product catalog.
    3. Select BigQueryas your data source.
    4. Select the branch you will upload your catalog to.
    5. Choose one of the following schemas:
    6. Enter the BigQuery table where your data is located.
    7. Optional: Under Show advanced options, enter the location of a Cloud Storage bucket in your project as a temporary location for your data.

      If not specified, a default location is used. If specified, the BigQuery and Cloud Storage bucket have to be in the same region.
    8. If you do not have search enabled and you are using the Merchant Center schema, select the product level.

      You must select the product level if this is the first time you are importing your catalog or you are re-importing the catalog after purging it. Learn more about product levels. Changing product levels after you have imported any data requires a significant effort.

      Important:You can't turn on search for projects with a product catalog that has been ingested as variants.
    9. Click Import.

    Import your historical user events

    To import your historical user events, complete the set of steps for your data source. For more information on historical user events, see Importing historical user events .

    Cloud Storage

    1. Click Import user eventsto open the Import Datapanel.
    2. Choose User events.
    3. Select Google Cloud Storageas the data source.
    4. Choose Retail User Events Schemaas the schema.
    5. Enter the Cloud Storage location of your data.
    6. Click Import.

    BigQuery

    1. Click Import user eventsto open the Import Datapanel.
    2. Choose User events.
    3. Select BigQueryas the data source.

    4. Select the data schema.

    5. Enter the BigQuery table where your data is located.
    6. Optional: Enter the location of a Cloud Storage bucket in your project as a temporary location for your data.
      If not specified, a default location is used. If specified, the BigQuery and Cloud Storage bucket have to be in the same region.
    7. Optional: Under Show advanced options, enter the location of a Cloud Storage bucket in your project as a temporary location for your data.

      If not specified, a default location is used. If specified, the BigQuery and Cloud Storage bucket have to be in the same region.
    8. Click Import.

    Create a serving config

    A serving config is a serving entity that associates a model or a set of controls that are used to generate your search or recommendation results.

    To create a serving config, complete the following steps:

    1. In the Serving configspanel, click Create serving config.
    2. On the Create Serving Configpage, choose Searchas the product the serving configuration will be used for.
    3. Provide a name for your serving configuration.

      The name must be 1024 characters or less, and can contain only alphanumeric characters, underscores, hyphens, and spaces.
    4. Optional: If needed, update the ID.

      The ID is generated from the name you provide, and must be unique across your project. It must be 50 characters or less, and cannot contain spaces.
    5. Click Continue.
    6. Choose whether to enable dynamic faceting for this serving configuration.
    7. Choose or create serving controls to optimize your searches with.

      For more information on controls, see Creating and managing controls.

    Manage resources and monitor activity

    When you have completed your initial configuration of your project, the Google Cloud console dashboard displays the system state of your Vertex AI Search for commerce project. The console dashboard lets you manage resources and monitor activity.

    Go to the Search for commerce console

    Create an API key

    An API key is required if you use a JavaScript pixel or a Tag Manager tag to capture user events from users' browsers. For more information about ways to capture user events, see Record real-time user events .

    To create an API key for calls to the userEvents.Collect method, complete the following steps:

    1. Go to the Google Cloud console Credentials page.

    2. In the project drop-down at the top of the Google Cloud console page, select your project (the project may already be selected).

    3. Click Create credentialsand then select API key. Do not add any website application restrictions . Some user privacy settings are known to not pass the referrer URL.

      • Take note of the generated API key, which you use when calling user event logging.

    4. For increased security, add an API restriction to your API Key to restrict access to the Vertex AI Search for commerce service at https://retail.googleapis.com/* .

    What's next
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: