在为新项目设置 Vertex AI Search for Commerce 之前,您必须:
创建 Google Cloud 项目
在 Google Cloud 控制台的管理资源页面上,选择或创建 Google Cloud 项目。
确保您的 Cloud 项目已启用结算功能。了解如何检查项目是否已启用结算功能。
设置 Vertex AI Search 商务解决方案
如需使用 Vertex AI Search for Commerce,请按以下步骤操作。另请注意,如果您启用 Vertex AI Search 商务解决方案并使用推荐功能,费用将根据查询次数计算。如需详细了解 Vertex AI Search 商务解决方案的价格,请参阅 Vertex AI Search 商务解决方案的费用。
对于新项目
如需设置 Vertex AI Search for Commerce,请执行以下操作:
前往 Google Cloud 控制台中的 Vertex AI Search for commerce 页面。
在设置 Vertex AI Search for Commerce 页面上,点击启用 API。
当 Vertex AI Search 商务解决方案和 Recommendations AI 显示为开启时,点击继续。
阅读数据使用方面的 Vertex AI Search for Industry 条款,然后点击接受(如果您同意数据使用条款)。接受条款后,您会收到来自 Google Cloud 控制台的确认消息,表明条款已接受。
如果您只想使用包含建议的项目,请点击开始。
如需在推荐之外还启用搜索功能,请执行以下操作:
- 点击继续,然后在开启搜索(可选)页面上点击开启。
- 点击开始使用。
Google Cloud 控制台会显示您已启用的 Vertex AI Search for Commerce 组件。您现在可以配置项目的初始设置。
对于现有项目
如需继续处理现有项目,请完成以下步骤:
前往项目对应的 Google Cloud 控制台中的搜索商业页面。
在数据使用条款页面上,阅读 Discovery Solutions 数据使用条款,如果您同意这些条款,请点击接受。
如果您只想使用包含建议的项目,请点击开始。
如果您想在接收建议的同时开启搜索功能,请执行以下操作:
- 点击继续,然后在开启搜索(可选)页面上点击开启。
- 点击开始使用。
关闭搜索功能
如果您不想再使用搜索功能,可以提交支持服务工单来将其关闭。
如需将支持请求设置为正确的组件,请选择以下字段:
- 类别:机器学习
- 组件:Vertex AI Search 商务解决方案:搜索和浏览
- 子组件:账号管理和结算
如需详细了解如何创建支持服务工单,请参阅获取支持。
停用 Vertex AI Search 商务解决方案
您可以随时停用 Vertex AI Search for Commerce。 这会同时关闭推荐功能和搜索功能。
如需关闭 Vertex AI Search for Commerce,请完成以下步骤:
前往Google Cloud 控制台中的 Vertex AI Search for Retail API/服务详细信息页面。
点击停用 API。
在停用 Vertex AI Search for commerce API?框中,点击停用。
Vertex AI Search for Commerce 使用入门
为新项目设置 Vertex AI Search for Commerce 时,Google Cloud 控制台会显示以下三个面板,帮助您配置 Vertex AI Search for Commerce 项目:
数据 > 目录:显示您的产品目录以及用于导入目录的链接。
数据 > 事件:显示用户事件以及用于导入历史用户事件的链接。
服务配置:包含服务配置的详细信息以及用于创建新服务配置的链接。
您可以使用这些面板导入数据,并为 Vertex AI Search 商务解决方案项目创建初始配置。
导入商品清单
如需导入商品目录,请完成适用于您的数据源的一组步骤。 如需详细了解商品目录,请参阅导入目录信息。
Merchant Center 同步
- 点击导入产品目录以打开导入数据面板。
- 选择商品清单。
- 选择 Merchant Center Sync 作为数据源。
- 选择您的 Merchant Center 账号。如果您没有看到自己的账号,请检查用户访问权限。
- 可选:选择 Merchant Center Feed 过滤条件,仅导入所选 Feed 中的商品。
如果未指定,则会导入所有 Feed 中的商品(包括未来的 Feed)。 - 可选:如需仅导入面向特定国家/地区或语言的商品,请展开显示高级选项,然后选择要过滤的 Merchant Center 目标销售国家/地区和语言。
- 选择您要将目录上传到的分支。
- 点击导入。
Cloud Storage
BigQuery
- 点击导入产品目录以打开导入数据面板。
- 选择商品清单。
- 选择 BigQuery 作为数据源。
- 选择您要将目录上传到的分支。
- 选择以下任一架构:
- 零售商品目录架构:Vertex AI Search 商务解决方案的商品架构
- Merchant Center:用于从 Merchant Center 批量导入的架构
- 输入数据所在的 BigQuery 表格。
- 可选:在显示高级选项下,输入项目中 Cloud Storage 存储桶的位置作为数据的临时位置。
如果未指定,则使用默认位置。如果指定,BigQuery 和 Cloud Storage 存储桶必须位于同一区域内。 - 如果您未启用搜索功能,并且使用的是 Merchant Center 架构,请选择商品级别。
如果这是您第一次导入目录,或者在完全清除后重新导入目录,则必须选择商品级别。详细了解商品级别。在导入任何数据后更改商品级别需要花费大量精力。
重要提示:对于已注入商品款式/规格的商品清单,您无法为相应项目启用搜索功能。 - 点击导入。
导入历史用户事件
如需导入历史用户事件,请完成适用于您数据源的一组步骤。如需详细了解历史用户事件,请参阅导入历史用户事件。
Cloud Storage
- 点击导入用户事件以打开导入数据面板。
- 选择用户事件。
- 选择 Google Cloud Storage 作为数据源。
- 选择零售用户事件架构作为架构。
- 输入数据的 Cloud Storage 位置。
- 点击导入。
BigQuery
- 点击导入用户事件以打开导入数据面板。
- 选择用户事件。
- 选择 BigQuery 作为数据源。
-
选择数据架构。
- Google Analytics 4:用于 Google Analytics 4 事件。
- Google Analytics 360:用于 Google Analytics 360 事件,除非您仅从 Google Analytics 360 导入首页浏览事件(在这种情况下,请使用零售用户事件架构)。
- 零售用户事件架构:用于从 Google Analytics 以外的来源导入事件,以及仅从 Google Analytics 360 导入首页浏览事件。
- 输入数据所在的 BigQuery 表格。
- 可选:输入项目中 Cloud Storage 存储桶的位置作为数据的临时位置。
如果未指定,系统会使用默认位置。如果指定,BigQuery 和 Cloud Storage 存储桶必须位于同一区域内。 - 可选:在显示高级选项下,输入项目中 Cloud Storage 存储桶的位置作为数据的临时位置。
如果未指定,则使用默认位置。如果指定,BigQuery 和 Cloud Storage 存储桶必须位于同一区域内。 - 点击导入。
创建服务配置
投放配置是一种投放实体,它关联模型或一组用于生成搜索或建议结果的控件。
如需创建投放配置,请完成以下步骤:
- 在投放配置面板中,点击创建投放配置。
- 在创建服务配置页面上,选择搜索作为服务配置的商品。
- 为您的投放配置提供一个名称。
名称不得超过 1024 个字符,并且只能包含字母数字字符、下划线、连字符、空格。 - 可选:如果需要,请更新 ID。
该 ID 通过您提供的名称生成,并且在项目中必须是唯一的。名称不能超过 50 个字符,并且不能包含空格。 - 点击继续。
- 选择是否为此投放配置启用动态构面。
- 选择或创建服务控件来优化搜索。
如需详细了解控件,请参阅创建和管理控件。
管理资源和监控活动
完成项目的初始配置后,Google Cloud 控制台信息中心会显示 Vertex AI Search 商务解决方案项目的系统状态。借助控制台信息中心,您可以管理资源和监控活动。
创建 API 密钥
如果您使用 JavaScript Pixel 或跟踪代码管理器代码从用户浏览器中捕获用户事件,则需要 API 密钥。如需详细了解如何捕获用户事件,请参阅记录实时用户事件。
如需为对 userEvents.Collect
方法的调用创建 API 密钥,请完成以下步骤:
前往 Google Cloud 控制台中的凭据页面。
在 Google Cloud 控制台页面顶部的项目下拉菜单中,选择您的项目(该项目可能已被选中)。
点击创建凭据,然后选择 API 密钥。请勿添加任何网站应用限制。部分用户隐私设置不会传递引荐来源网址。
- 请记下生成的 API 密钥,将用于调用用户事件日志记录。
为提高安全性,请向您的 API 密钥添加 API 限制,以限制对
https://retail.googleapis.com/*
的 Vertex AI Search for Commerce 服务的访问权限。
后续步骤
- 限制 API 密钥
- 向 Vertex AI Search 商务解决方案进行身份验证
- Identity and Access Management (IAM)
- 实现 Vertex AI Search 商务解决方案