设置前提条件

如需为新项目设置 AI Commerce Search，您必须执行以下操作：

1. 创建新项目或设置现有项目
2. 启用 AI Commerce Search
3. 导入商品清单和用户事件

创建 Google Cloud 项目

1. 在 Google Cloud 控制台的管理资源页面上，选择或 创建项目 Google Cloud 。

   转到“管理资源”页面

2. 确保您的云项目已启用结算功能。了解如何 检查项目是否已启用结算功能。

设置 AI Commerce Search

如需使用 AI Commerce Search，请按以下步骤操作。此外，如果您启用 AI Commerce Search 并使用推荐功能，请注意，费用取决于查询次数。如需详细了解 AI Commerce Search 的价格，请参阅 AI Commerce Search 费用。

重要提示： 对于要与 AI Commerce Search 搭配使用的每个项目，您必须接受 Vertex AI Search for Industry 条款。

对于新项目

如需设置 AI Commerce Search，请执行以下操作：

1. 前往AI Commerce Search页面，在 Google Cloud 控制台中。

   前往 Gemini Enterprise for Customer Experience 中的 AI Commerce Search 页面

2. 在设置 AI Commerce Search 页面上，点击启用 API 。

3. 当 AI Commerce Search 和 Recommendations AI 显示为 已启用 时，点击 继续。

4. 阅读 Vertex AI Search for Industry 数据使用条款，如果您同意这些条款，请点击 接受 。控制台会在接受搜索条款后向您发送确认消息。 Google Cloud

5. 如果您只想将该项目用于推荐功能，请点击开始使用 。

6. 如需在推荐功能之外启用搜索功能，请执行以下操作：

   1. 点击继续 ，然后在启用搜索（可选） 页面上点击启用 。
   2. 点击开始使用 。

   控制台会显示您已启用的 AI Commerce Search 组件。 Google Cloud 现在，您可以 配置项目的初始设置。

对于现有项目

如需在现有项目上继续操作，请完成以下步骤：

1. 前往 Google Cloud 控制台中项目的 Gemini Enterprise for Customer Experience 中的 AI Commerce Search 页面。

   前往 Gemini Enterprise for Customer Experience 中的 AI Commerce Search 页面

2. 在数据使用条款 页面上，阅读 Discovery Solutions 数据使用条款，如果您同意这些条款，请点击接受 。

3. 如果您只想将该项目用于推荐功能，请点击开始使用 。

4. 如需在推荐功能之外启用搜索功能，请执行以下操作：

   1. 点击继续 ，然后在启用搜索（可选） 页面上点击启用 。
   2. 点击开始使用 。

重要提示： 在接受数据使用条款之前，请确保您拥有项目的 Retail 管理员或所有者角色。

关闭搜索功能

如果您不想再使用搜索功能，可以通过提交支持服务工单将其关闭。

如需将工单设置为正确的组件，请选择以下字段：

• 类别：机器学习
• 组件：AI Commerce Search：搜索和浏览
• 子组件：账号管理和结算

如需详细了解如何创建支持服务工单， 请参阅获取支持。

关闭 AI Commerce Search

您可以随时通过停用 AI Commerce Search 来将其关闭。 这会同时关闭推荐功能和搜索功能。

如需关闭 AI Commerce Search，请完成以下步骤：

1. 前往 Google Cloud 控制台中的 AI Commerce Search API /服务详细信息 页面。

   前往 AI Commerce Search API 服务详情页面

2. 点击停用 API 。

3. 在要停用 AI Commerce Search API 吗？ 框中，点击停用 。

注意： 停用 AI Commerce Search API 后，系统需要几个小时才能为项目停用 Vertex AI Search for Industry 数据使用条款。

AI Commerce Search 使用入门

为新项目设置 AI Commerce Search 时， Google Cloud 控制台会显示以下三个面板，以帮助您配置 AI Commerce Search 项目：

• 数据 > 目录：显示您的商品清单以及用于导入 清单的链接。

• 数据 > 事件：显示您的用户事件以及用于导入 历史用户事件的链接。

• 投放配置：包含投放配置的详细信息以及用于创建新投放配置的 链接。

您可以使用这些面板导入数据，并为 AI Commerce Search 项目创建初始配置。

导入商品清单

如需导入商品清单，请完成数据源的一组步骤。 如需详细了解商品清单，请参阅 导入目录信息。

**已弃用：** Merchant Center 连接器已弃用，仅供当前用户使用。新用户必须使用 Catalog API 或 BigQuery 导入目录。

Merchant Center 同步

1. 点击导入商品清单 以打开导入数据 面板。
2. 选择商品清单 。
3. 选择 Merchant Center 同步 作为数据源。
4. 选择您的 Merchant Center 账号。如果您没有看到自己的账号，请检查用户访问权限。
5. 可选：选择 Merchant Center Feed 过滤条件 ，仅导入所选 Feed 中的商品。
   
   如果未指定，系统会导入所有 Feed（包括未来的 Feed）中的商品。
6. 可选：如需仅导入面向特定国家/地区或语言的商品，请展开显示高级选项 ，然后选择 Merchant Center 目标销售国家/地区和语言以进行过滤。
7. 选择您要将目录上传到的分支。
8. 点击导入 。

Cloud Storage

1. 点击导入商品清单 以打开导入数据 面板。
2. 选择 Cloud Storage 作为数据源。
3. 选择您要将目录上传到的分支。
4. 选择 Retail Product Catalogs Schema 作为架构。
5. 输入数据的 Cloud Storage 位置。
6. 如果您未启用搜索功能，请选择商品级别。
   
   如果您是首次导入目录，或者在完全清除后重新导入目录，则必须 选择商品级别。详细了解 商品级别。更改 商品级别在导入任何数据后需要花费大量精力。
   
   重要提示： 对于已作为商品款式/规格注入的商品清单，您无法为项目启用搜索功能。
7. 点击导入 。

BigQuery

1. 点击导入商品清单 以打开导入数据 面板。
2. 选择商品清单 。
3. 选择 BigQuery 作为数据源。
4. 选择您要将目录上传到的分支。
5. 选择以下架构之一：
   • Retail Product Catalogs Schema：AI Commerce Search 的商品架构
   • Merchant Center：用于从 Merchant Center 批量导入的架构
6. 输入数据所在的 BigQuery 表。
7. 可选：在显示高级选项下，输入项目中 Cloud Storage 存储桶的位置作为数据的临时位置。
   
   如果未指定，系统会使用默认位置。如果指定，BigQuery 和 Cloud Storage 存储桶必须位于同一区域内。
8. 如果您未启用搜索功能，并且使用的是 Merchant Center 架构，请选择商品级别。
   
   如果您是首次导入目录，或者在完全清除后重新导入目录，则必须 选择商品级别。详细了解 商品级别。更改 商品级别在导入任何数据后需要花费大量精力。
   
   重要提示： 对于已作为商品款式/规格注入的商品清单，您无法为项目启用搜索功能。
9. 点击导入 。

导入历史用户事件

如需导入历史用户事件，请完成数据源的一组步骤。 如需详细了解历史用户事件，请参阅 导入历史用户事件。

注意： 您还可以记录实时用户事件，以生成推荐内容和 搜索结果。如需了解详情，请参阅记录实时用户事件。

Cloud Storage

1. 点击导入用户事件 以打开导入数据 面板。
2. 选择用户事件 。
3. 选择 Google Cloud Storage 作为数据源。
4. 选择 Retail User Events Schema 作为架构。
5. 输入数据的 Cloud Storage 位置。
6. 点击导入 。

BigQuery

1. 点击导入用户事件 以打开导入数据 面板。
2. 选择用户事件 。
3. 选择 BigQuery 作为数据源。

4. 选择数据架构。

   • Google Analytics 4：用于 Google Analytics（分析）4 事件。
   • Google Analytics 360：用于 Google Analytics 360 事件，除非您仅从 Google Analytics 360 导入事件首页浏览量（在这种情况下，请使用 Retail User Events Schema）。
   • Retail User Events Schema：用于从 Google Analytics 以外的来源导入事件，以及仅从 Google Analytics 360 导入事件首页浏览量。
5. 输入数据所在的 BigQuery 表。
6. 可选：输入项目中 Cloud Storage 存储桶的位置作为数据的临时位置。如果未指定，系统会使用默认位置。
   如果指定，BigQuery 和 Cloud Storage 存储桶必须位于同一区域内。
7. 可选：在显示高级选项下，输入项目中 Cloud Storage 存储桶的位置作为数据的临时位置。
   
   如果未指定，系统会使用默认位置。如果指定，BigQuery 和 Cloud Storage 存储桶必须位于同一区域内。
8. 点击导入 。

创建服务配置

投放配置是一种投放实体，它关联模型或一组 用于生成搜索或建议结果的控件。

**注意：** AI Commerce Search 会创建默认投放配置，因此如果您想创建自定义投放配置，则此 过程是可选的。

如需创建服务配置，请完成以下步骤：

1. 在投放配置 面板中，点击创建投放配置 。
2. 在创建投放配置 页面上，选择搜索 作为投放配置的商品。
3. 为投放配置提供名称。
   
   名称不得超过 1024 个字符，并且只能包含字母数字字符、 下划线、连字符、空格。
4. 可选：如果需要，请更新 ID。
   
   ID 是根据您提供的 名称生成的，并且在您的项目中必须是唯一的。ID 不得超过 50 个字符，并且不能包含空格。
5. 点击继续 。
6. 选择是否为此投放配置启用动态构面。
7. 选择或创建投放控件来优化搜索。
   
   如需详细了解控件，请参阅创建和管理控件。

管理资源和监控活动

完成项目的初始配置后， Google Cloud 控制台信息中心会显示您的 AI Commerce Search 项目的系统状态。借助控制台信息中心，您可以管理资源和监控活动。

前往 Gemini Enterprise for Customer Experience 控制台中的 AI Commerce Search

创建 API 密钥

如果您使用 JavaScript 像素或跟踪代码管理器代码从用户的浏览器捕获用户事件，则需要 API 密钥。如需详细了解捕获用户事件的方式，请参阅记录实时用户事件。

如需为对 userEvents.Collect 方法的调用创建 API 密钥，请完成以下步骤：

1. 前往 Google Cloud 控制台的“凭据” 页面。

2. 在 Google Cloud 控制台页面顶部的项目下拉菜单中，选择 您的项目（该项目可能已被选中）。

3. 点击创建凭据 ，然后选择 API 密钥 。 请勿添加任何网站应用限制。已知部分用户隐私 设置不会传递引荐来源网址。

   • 记下生成的 API 密钥，您将在调用 用户事件日志记录时使用。

4. 为提高安全性，请向您的 API 密钥添加 API 限制 ，以限制对 AI Commerce Search 服务 的访问权限（网址为 https://retail.googleapis.com/*）。

注意： API 密钥仅用于对 userEvents.Collect 方法进行身份验证。 其他 API 方法需要通过服务帐号或用户账号使用 OAuth 2.0。

后续步骤

• 限制 API 密钥
• 向 AI Commerce Search 进行身份验证
• 身份和访问权限管理 (IAM)
• 实现 AI Commerce Search