设置前提条件

在为新项目设置 Vertex AI Search for Retail 之前，您必须满足以下条件：

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

创建 Google Cloud 项目

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

   转到“管理资源”页面

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

设置 Vertex AI Search for Retail

如需使用 Vertex AI Search for Retail，请按以下步骤操作。此外，如果您启用 Vertex AI Search for Retail 并使用推荐功能，请注意费用是根据查询次数计算的。如需详细了解 Vertex AI Search 零售解决方案的价格，请参阅 Vertex AI Search 零售解决方案的费用。

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

对于新项目

如需设置 Vertex AI Search for Retail，请执行以下操作：

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

   前往“Search for Retail”页面

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

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

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

5. 如果您只想使用包含建议的项目，请点击开始使用。

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

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

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

对于现有项目

如需继续处理现有项目，请完成以下步骤：

1. 在 Google Cloud 控制台中，前往项目的 Search for Retail（搜索 Retail）页面。

   前往“Search for Retail”页面

2. 在数据使用条款页面上，阅读发现解决方案数据使用条款，如果您同意这些条款，请点击接受。

3. 如果您只想使用包含建议的项目，请点击开始使用。

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

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

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

关闭搜索功能

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

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

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

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

停用 Vertex AI Search for Retail

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

如需停用 Vertex AI Search for Retail，请完成以下步骤：

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

   前往“Vertex AI Search for Retail API 服务详情”页面

2. 点击停用 API。

3. 在 Disable Vertex AI Search for retail API? 框中，点击 Disable。

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

Vertex AI Search for Retail 使用入门

为新项目设置 Vertex AI Search 零售解决方案时，Google Cloud 控制台会显示以下三个面板，以帮助您配置 Vertex AI Search 零售解决方案项目：

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

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

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

您可以使用这些面板导入数据，并为 Vertex AI Search 零售解决方案项目创建初始配置。

导入商品清单

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

Merchant Center 同步

1. 点击导入商品目录以打开导入数据面板。
2. 选择商品清单。
3. 选择 Merchant Center Sync 作为数据源。
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. 选择以下架构之一：
   • 零售产品目录架构：适用于 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 用户事件架构作为架构。
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 导入“首页浏览”事件（在这种情况下，请使用零售用户事件架构）。
   • 零售业用户事件架构：用于从 Google Analytics 以外的来源导入事件，以及从 Google Analytics 360 导入仅包含网页浏览的事件。
5. 输入数据所在的 BigQuery 表格。
6. 可选：输入项目中 Cloud Storage 存储桶的位置作为数据的临时位置。
   如果未指定，系统会使用默认位置。如果指定，BigQuery 和 Cloud Storage 存储桶必须位于同一区域内。
7. 可选：在显示高级选项下，输入项目中 Cloud Storage 存储桶的位置作为数据的临时位置。
   
   如果未指定，则使用默认位置。如果指定，BigQuery 和 Cloud Storage 存储桶必须位于同一区域内。
8. 点击导入。

创建服务配置

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

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

如需创建投放配置，请完成以下步骤：

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

管理资源和监控活动

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

前往 Search for Retail 控制台

创建 API 密钥

如果您使用 JavaScript Pixel 或跟踪代码管理器代码从用户的浏览器中捕获用户事件，则必须使用 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 进行身份验证
• 身份和访问权限管理 (IAM)
• 实现 Vertex AI Search 零售解决方案