设置前提条件

在为新项目设置 Vertex AI Search for Retail 之前，您必须：

  1. 创建新项目或设置现有项目
  2. 启用面向零售业的 Vertex AI Search
  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，请执行以下操作：

  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 控制台发来的确认消息。

  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. 点击开始使用。

关闭搜索功能

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

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

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

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

停用 Vertex AI Search for Retail

您可以随时停用面向零售业的 Vertex AI Search。 这会同时关闭推荐和搜索功能。

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

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

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

  2. 点击停用 API。

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

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

为新项目设置适用于零售业务的 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. 选择以下架构之一：
  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. 选择数据架构。

  5. 输入数据所在的 BigQuery 表格。
  6. 可选：输入 Cloud Storage 存储桶的位置 作为数据的临时位置。
    如果未指定，则默认位置为 。如果指定，BigQuery 和 Cloud Storage 存储桶必须位于同一地区内。
  7. 可选：在显示高级选项下，输入项目中 Cloud Storage 存储桶的位置作为数据的临时位置。

    如果未指定，则使用默认位置。如果已指定，BigQuery 和 Cloud Storage 存储桶必须位于同一区域。
  8. 点击导入。

创建服务配置

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

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

  1. 在投放配置面板中，点击创建投放配置。
  2. 在创建服务配置页面上，选择搜索作为供应配置的商品。
  3. 为您的投放配置提供名称。

    名称不得超过 1024 个字符，并且只能包含字母数字字符、下划线、连字符和空格。
  4. 可选：如果需要，请更新该 ID。

    该 ID 是根据 该名称，并且在您的项目中必须是唯一的。名称不能超过 50 个字符，并且不能包含空格。
  5. 点击继续。
  6. 选择是否为此投放配置启用动态构面。
  7. 选择或创建投放控件来优化搜索。

    如需详细了解控件，请参阅创建和管理控件。

管理资源并监控活动

完成项目的初始配置后，Google Cloud 控制台信息中心会显示 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 限制 以限制对 Vertex AI Search for Retail 服务的访问权限 https://retail.googleapis.com/*。

后续步骤