本页面介绍了如何创建新的推荐模型。
如果您已拥有正确类型的推荐模型，并且希望从您网站中的其他位置获取预测结果，则可以为该模型创建新的服务配置，而不是创建新模型。了解详情。
简介
当您希望使用新的推荐类型来获取预测时，您必须创建新的推荐模型并提供足够的用户事件数据以用于训练。您可以为新模型创建服务配置，并在模型完成训练后向这些服务配置请求预测。
如需简要了解使用适用于零售业的 Vertex AI Search 的流程，请参阅为零售业实现 Vertex AI Search。
创建推荐模型
使用 Search for Retail 控制台或 models.Create API 方法添加新的推荐模型。
每个项目最多可以有 20 个模型，并且其中最多有 10 个模型一直处于活跃状态（未暂停）。详细了解如何暂停模型。
每分钟最多可以启动 5 个模型操作。受限制的模型操作包括创建、删除、暂停和继续。
创建新模型之前，请执行以下操作：
- 查看可用的推荐模型类型和为业务目标建模，并从中进行选择。这些因素决定了此模型应进行训练以提供哪种类型的建议。
- 决定调整模型的频率。如需详细了解调整和训练费用，请参阅价格。
- 请确保您已上传足够的数据，以满足创建新模型的要求。一些要求取决于您选择的模型类型。
如果您计划创建网页级优化模型：
检查您是否已有附加了经过训练的模型的推荐服务配置。您必须提供一系列推荐服务配置，以供页面级优化在优化页面推荐时从中进行选择。
为与要部署页面级优化模型的
detail-page-view事件和事件匹配的detail-page-view事件和事件设置事件记录（例如，如果您在首页上部署模型，请确保为home-page-view事件设置记录）。为了改进个性化推荐，我们还建议记录purchase和add-to-cart事件的事件。如果您选择转化率 (CVR) 业务目标，则必须针对
add-to-cart事件记录事件。请确保在创建网页级优化模型后，继续查询该模型，以创建推荐展示次数。这些展示会用于训练网页级优化模型并改进其提供的建议。
如需创建新模型，请执行以下操作：
Google Cloud 控制台
前往 Search for Retail 控制台中的型号页面。
转到“模型”页面点击创建模型。
为模型输入名称。
名称不得超过 1024 个字符，并且只能包含字母数字字符、下划线、连字符、空格。
选择建议类型。
如果您选择了网页级优化模型类型：
选择“网页级优化”模型将为您优化的网页类型。
选择要在多大程度上限制跨面板提供类似服务配置：
唯一模型类型：不允许将模型类型相同的多项服务配置显示在不同的面板上。
唯一模型：不允许将具有相同模型的多项服务配置显示在不同的面板上。
唯一的服务配置：不允许同一服务配置显示在多个面板上。
无限制：允许在任意数量的面板上显示任何服务配置。
对于计划随此模型一起显示的每个建议面板，请执行以下操作：
输入面板 ID。
选择页面级优化模型可以考虑将哪些服务配置作为该面板的选项。
例如，“添加到购物车”页面可能有一个推荐面板，您希望在该面板中显示“经常一起购买”或“您可能喜欢的其他商品”建议。在这种情况下，请选择一个使用“经常一起购买”模型的服务配置，以及另一个使用“您可能喜欢的其他人”模型的服务配置，以供此面板参考。当您对页面级优化模型进行预测调用时，该模型将根据最终用户的事件历史记录选择应在该面板中显示哪种类型的建议。
选择默认服务配置。
如果 Google 服务器发生中断，网页级优化模型仍然可以传送默认服务配置的结果。
如果您需要创建其他面板，请针对每个新面板点击添加面板，然后输入新面板的详细信息。
选择业务目标（如果适用于您选择的模型类型）。
如果您选择了“经常一起购买”模型类型，请选择上下文产品类型：
- 多个上下文产品：使用一个或多个项作为此模型中的推荐上下文。
- 单个上下文产品：使用一项内容作为上下文来根据此模型提供建议。
查看已满足数据要求？列表，确认您已针对所选模型类型上传足够的数据。
如果未满足的数据要求阻止您创建模型，该要求旁边会显示 X cancel 图标，并且创建推荐模型窗格底部的创建按钮会被停用。
如果您需要上传更多数据，请仔细查看列出的数据要求，以确保需要满足该模型的部分或全部要求，然后导入创建模型所需的用户事件或产品
选择调整模型的频率。如需详细了解调整费用，请参阅价格。
- 每三个月：模型每三个月自动调整一次。
- 仅限手动调参：仅当您手动调整模型时，模型才会进行调参。
（公开预览版功能）选择是否自动生成用于过滤的标记。
- 自动生成标记：启用此选项可让您过滤此模型的推荐结果。启用此选项可以增加训练时间。如需详细了解训练费用，请参阅价格。
- 不生成标记：如果停用此选项，您将无法从此模型中获得被滤除的建议。
点击创建以创建新的推荐模型。
如果您已上传足够所需类型的用户事件数据，即会开始进行初始模型训练和调整。初始模型训练和调整需要 2-5 天才能完成，但对于大型数据集，可能需要更长时间。
curl
向 v2beta API 发出 Models.create 请求，并在请求正文中添加 Model 实例。请参阅 Models.create API 参考文档。
如需详细了解所有 Models 字段，请参阅 Models API 参考文档。
curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
--data '{
"name": "FULL_MODEL_NAME",
"displayName": "DISPLAY_NAME",
"trainingState": "TRAINING_STATE",
"type": "MODEL_TYPE",
"optimizationObjective": "OPTIMIZATION_OBJECTIVE",
"periodicTuningState": "TUNING_STATE",
"filteringOption": "FILTERING_STATE",
"modelTypeConfig" {
"contextProductsType": "CONTEXT_PRODUCTS_TYPE"
}
}' \
"https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models"
如果您已上传足够所需类型的用户事件数据，即会开始进行初始模型训练和调整。 初始模型训练和调整需要 2-5 天才能完成，但对于大型数据集，可能需要更长时间。
创建新推荐模型的要求
首次为网站使用特定建议类型时，您正在训练一种新的机器学习模型，该模型需要足够的训练数据，以及训练和调整模型的时间。如要开始使用新的推荐类型，您需要按以下步骤操作：
- 将您的目录导入面向零售业的 Vertex AI Search（如果尚未导入），并实施相关流程以及时更新上传的目录。
- 开始向零售专用 Vertex AI Search 记录用户事件（如果尚未记录），请务必遵循记录用户事件数据的最佳实践。
- 确定您要使用的建议类型和优化目标。
- 确定您所需的推荐类型和目标的用户事件数据要求。
- 导入历史用户事件数据以满足最低事件数据要求，或等到用户事件数据收集满足最低要求。
-
此时，零售专用 Vertex AI Search 会启动模型训练和调优。初始模型训练和调整需要 2-5 天才能完成，但对于大型数据集，可能需要更长时间。
使用预测预览确认您的模型可正常运行。
创建 A/B 实验。
模型类型数据要求
您导入的用户事件类型和所需数据量取决于您的推荐（模型）类型和优化目标。达到最低数据要求后，您就可以开始训练模型。
数据收集时段表示用户事件的时间段；导入更多历史数据不会影响模型质量。
请务必使用真实用户事件和真实目录数据。优质模型无法基于合成数据构建而成。
| 模型类型 | 优化目标 | 支持的用户事件类型 | 最低数据要求 | 数据收集时段 |
|---|---|---|---|---|
| 为您推荐 | 点击率 |
detail-page-viewpurchase-completehome-page-view
|
10,000 个
至少 7 天的
10,000 个 且
（1 周，每个联接目录项平均有 10 个 或
60 天，至少有 1 个联接的 |
3 个月 |
| 为您推荐 | 转化率 |
detail-page-viewadd-to-cartpurchase-completehome-page-view
|
10,000 个
10,000 个
至少 7 天的
10,000 个 且
（1 周，每个加入的目录项平均有 10 个 或
60 天内，每天至少包含一个 |
3 个月 |
| 为您推荐 | 每次会话的收入 |
detail-page-viewadd-to-cartpurchase-completehome-page-view
|
10,000 个
10,000 个
至少 7 天的
10,000 个 且
（1 周，每个加入的目录项平均有 10 个 或
60 天内，每天至少包含一个 |
3 个月 |
| 您可能喜欢的其他类型 | 点击率 |
detail-page-view
|
10,000 个 且
（1 周，每个加入的产品平均有 10 个 或
60 天，至少有 1 个联接的 |
3 个月 |
| 您可能喜欢的其他类型 | 转化率 |
add-to-cartdetail-page-view
|
10,000 个
10,000 个 且
（1 周，每个加入的产品平均有 10 个 或
60 天，至少有 1 个联接的 |
3 个月 |
| 您可能喜欢的其他类型 | 每次会话的收入 |
add-to-cartdetail-page-view
|
10,000 个
10,000 个 且
（1 周，每个加入的产品平均有 10 个 或
60 天，至少有 1 个联接的 |
3 个月 |
| 经常一起购买的商品 | 不限 |
purchase-completedetail-page-view
|
1,000 个 且
（每个加入的商品平均 10 个 或
90 天 |
12 个月 我们建议您至少每天上传一次事件，以保持良好的数据质量。在导入历史事件期间，请确保数据分布偏向于最近的时间戳。最后一个时间戳日上的事件数量应等于或大于平均每日事件数。 |
| 促销中 | 点击率 |
detail-page-viewadd‑to‑cartpurchase-completehome-page-viewshopping-cart-page-viewcategory-page-view
|
Active Catalog 分支有超过 100 件促销商品（产品的
10,000 个
至少 7 天的
10,000 个
（1 周，每个联接目录项平均有 10 个 或
60 天内，每天至少加入一个 |
3 个月 |
| 促销中 | 转化率 |
detail-page-viewadd-to-cartpurchase-completehome-page-viewcategory-page-viewshopping-cart-page-view
|
Active Catalog 分支有超过 100 件促销商品（产品的
10,000 个
10,000 个
10,000 个 且
（1 周，每个加入的目录项平均有 10 个 或
60 天内，每天至少包含一个 |
3 个月 |
| 类似商品 | 点击率 | 不需要。 |
有效目录分支中必须至少有 100 个有货产品 SKU。不需要设置用户事件。 |
不适用 |
| 页面级优化 | 不限 |
detail-page-viewadd-to-cartpurchase-completehome-page-view
|
页面级优化通过在多个可能的模型之间进行选择，来优化推荐面板。请参阅您选作页面级优化选项的模型的数据要求。 |
不适用 |
| 再次购买 | 不适用 |
purchase-complete
|
1,000 个 且
为期 60 天的 且 有效目录分支中必须至少有 100 个有货产品 SKU。 |
90 天 我们建议您至少每天上传一次事件，以保持良好的数据质量。在导入历史事件期间，请确保数据分布偏向于最近的时间戳。最后一个时间戳日上的事件数量应等于或大于平均每日事件数。 |