Console
    Start free

    Setup prerequisites

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

    1. Create a new project or set up your existing project
    2. Enable AI Commerce Search
    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 AI Commerce Search

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

    For your new project

    To set up AI Commerce Search:

    1. Go to the AI Commerce Searchpage in the Google Cloud console.

      Go to the AI Commerce Search in Gemini Enterprise for Customer Experience page

    2. On the Set up AI Commerce Searchpage, click Turn on API.

    3. When AI Commerce Searchand Recommendations AIdisplay as On, click Continue.

    4. Read the Agent 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 AI Commerce Search 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 AI Commerce Search in Gemini Enterprise for Customer Experiencepage in the Google Cloud console for your project.

      Go to the AI Commerce Search in Gemini Enterprise for Customer Experience 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: AI Commerce Search: search & browse
    • Subcomponent: Account Administration & Billing

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

    Turn off AI Commerce Search

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

    To turn off AI Commerce Search, complete the following steps:

    1. Go to the AI Commerce Search API /Service Detailspage in the Google Cloud console.

      Go to AI Commerce Search API Service Details page

    2. Click Disable API.

    3. In the Disable AI Commerce Search API?box, click Disable.

    Get started with AI Commerce Search

    When you set up AI Commerce Search for a new project, the Google Cloud console displays the following three panels to help you configure your AI Commerce Search 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 AI Commerce Search 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 AI Commerce Search project. The console dashboard lets you manage resources and monitor activity.

    Go to the AI Commerce Search in Gemini Enterprise for Customer Experience 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 AI Commerce Search service at https://retail.googleapis.com/* .

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