准备工作

创建 Google Cloud 项目

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

   转到“管理资源”页面

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

设置面向零售业的 Vertex AI Search

如需使用 Vertex AI Search for Retail 以及建议，您必须启用 Vertex AI Search for Retail 并接受适用于数据使用条款的 Vertex AI Search for Industry 条款。如果您还使用搜索功能，则必须将其启用。使用搜索会产生额外费用，具体取决于查询数量。如需了解详情，请参阅搜索费用。

如需设置面向零售业的 Vertex AI Search，请完成以下步骤：

1. 前往 Google Cloud 控制台中的 Vertex AI Search for Retail 页面。

   前往 Search for Retail 页面

2. 在为零售业设置 Vertex AI Search 页面上，点击启用 API。

3. 当 Vertex AI Search for Retail 和 Recommendations AI 显示为开启时，点击继续。

4. 阅读 Vertex AI Search for Industry 数据使用条款，如果您同意数据使用条款，请点击 Accept。

   如果您接受数据使用条款，Google Cloud 控制台会指示您接受 Vertex AI Search for Retail 数据使用条款。

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

5. 如果您只想将项目与建议搭配使用，请点击开始使用。

6. 如果除了推荐功能之外，您还想开启搜索功能，请执行以下操作：

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

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

为现有项目进行设置

如果您在数据使用条款于 2022 年 4 月 4 日生效之前为 Google Cloud 项目设置了适用于零售的 Vertex AI Search，则必须接受 Vertex AI Search for Industry 条款，才能继续在该项目中使用 Vertex AI Search for Retail。如果需要，您还必须为该项目启用搜索功能。

重要提示 ：对于要使用 Vertex AI Search for Retail 的每个项目，您必须接受数据使用条款。

如需为现有项目接受 Vertex AI Search for Industry 条款，请完成以下步骤：

1. 在 Google Cloud 控制台中，前往您的项目对应的 Search for Retail 页面。

   前往 Search for Retail 页面

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

   重要提示 ：仅当您拥有项目的 Retail Admin 或 Owner 角色时，才能接受数据使用条款。

3. 如果您只想将项目与建议搭配使用，请点击开始使用。

4. 如果除了推荐功能之外，您还想开启搜索功能，请执行以下操作：

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

关闭适用于零售业的 Search 或 Vertex AI Search

关闭搜索功能

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

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

• 类别：机器学习
• 组件：适用于零售业的 Vertex AI Search：搜索和浏览
• 子组件：帐号管理和结算

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

关闭 Vertex AI Search for Retail

您可以随时通过停用 Vertex AI Search for Retail 来关闭它。这会同时关闭推荐和搜索功能。

如需停用适用于零售业的 Vertex AI Search，请完成以下步骤：

1. 前往 Google Cloud 控制台中的 Vertex AI Search for Retail API/服务详情页面。

   转到 Vertex AI Search for Retail API 服务详情页面

2. 点击停用 API。

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

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

面向零售业的 Vertex AI Search 使用入门

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

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

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

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

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

导入您的商品清单

如需导入商品清单，请完成适用于您的数据源的一系列步骤。如需详细了解商品清单，请参阅导入清单信息。

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. 选择商品清单作为数据源。
3. 选择您要将目录上传到的分支。
4. 选择 Retail Product Catalogs Schema 架构。
5. 输入数据的 Cloud Storage 位置。
6. 如果未启用搜索功能，请选择产品级别。
   
   如果这是您首次导入清单，或者在完全清除清单后又要重新导入清单，则必须选择产品级别。详细了解商品级别。在导入任何数据后更改产品级别需要执行大量操作。
   
   重要提示：如果项目包含的商品清单已作为变体注入，您将无法为其启用搜索功能。
7. 点击导入。

BigQuery

1. 点击导入商品清单，打开导入数据面板。
2. 选择商品清单。
3. 选择 BigQuery 作为数据源。
4. 选择您要将目录上传到的分支。
5. 选择以下架构之一：
   • Retail Product Catalogs Schema：Vertex AI Search for Retail 的商品架构
   • 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 用户事件架构：用于从 Google Analytics（分析）以外的来源导入事件，以及仅从 Google Analytics 360 导入首页视图。
5. 输入数据所在的 BigQuery 表格。
6. 可选：输入项目中 Cloud Storage 存储桶的位置，作为数据的临时位置。
   如果未指定，则使用默认位置。如果指定，BigQuery 和 Cloud Storage 存储桶必须位于同一区域。
7. 可选：在显示高级选项下，输入项目中 Cloud Storage 存储桶的位置，作为数据的临时位置。
   
   如果未指定，则使用默认位置。如果指定，BigQuery 和 Cloud Storage 存储桶必须位于同一区域。
8. 点击导入。

创建服务配置

服务配置是一种服务实体，与用于生成搜索或推荐结果的模型或一组控件相关联。

注意 ：零售专用 Vertex AI Search 会创建一个默认服务配置，因此，如果您要创建自定义服务配置，则此步骤是可选的。

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

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

信息中心

完成项目的初始配置后，Search for Retail 控制台会显示 Vertex AI Search for Retail 项目的系统状态。通过该控制台，您可以管理资源并监控活动。

前往 Search for Retail 控制台

创建 API 密钥

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

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

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

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

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

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

4. 为了提高安全性，请为您的 API 密钥添加 API 限制，以限制对位于 https://retail.googleapis.com/* 的 Vertex AI Search for Retail 服务的访问权限。

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

后续步骤

• 限制 API 密钥
• 向 Vertex AI Search for Retail 进行身份验证
• Identity and Access Management (IAM)
• 实现面向零售业的 Vertex AI Search