创建推荐模型

本页面介绍了如何创建新的推荐模型。

注意： 您无需为搜索手动配置或创建模型。

如果您已具有正确类型的推荐模型，并且想要从网站中的其他位置获取该模型，则可以为其创建新的投放配置而无需创建新模型。了解详情。

简介

当您希望使用新的推荐类型来获取预测时，您必须创建新的推荐模型并提供足够的用户事件数据以用于训练。您可以为新模型创建投放配置，然后在模型完成训练后，向这些投放配置请求预测。

如需简要了解使用 Vertex AI Search 商务解决方案的流程，请参阅实现 Vertex AI Search 商务解决方案。

创建推荐模型

使用搜索商业控制台或 models.Create API 方法添加新的推荐模型。

每个项目最多可以有 20 个模型，并且其中最多有 10 个模型一直处于活跃状态（未暂停）。详细了解如何暂停模型。

每分钟最多可以启动 5 个模型操作。受限制的模型操作包括创建、删除、暂停和继续。

在创建新模型之前，请注意以下事项：

• 查看并选择可用的推荐模型类型和模型业务目标。这些数据决定了应训练此模型来提供哪种类型的推荐。
• 确定调整模型的频率。如需了解调优和训练费用详情，请参阅价格。
• 请确保您已上传足够的数据，以满足创建新模型的要求。部分要求取决于您选择的模型类型。

• 如果您计划创建网页级优化模型，请执行以下操作：

  • 检查您是否已拥有附加了已训练模型的建议投放配置。您必须提供一系列建议投放配置，以便网页级优化在优化网页的建议时从中进行选择。

  • 为 detail-page-view 事件以及与您将部署网页级优化模型的网页类型相符的事件设置事件记录（例如，如果您将模型部署在首页上，请确保您为 home-page-view 事件设置了记录）。为了改进个性化推荐，我们还建议记录 purchase 和 add-to-cart 事件。

  • 如果您选择“转化率 (CVR)”业务目标，则必须记录 add-to-cart 事件。

  • 请确保在创建网页级优化模型后，您会继续查询该模型以生成推荐展示。这些展示次数用于训练网页级优化模型，并改进其提供的建议。

如需创建新模型，请执行以下操作：

Google Cloud 控制台

1. 前往 Search for Commerce 控制台中的模型页面。
   
   前往“模型”页面

2. 点击创建模型。

3. 为模型输入名称。

   名称不得超过 1024 个字符，并且只能包含字母数字字符、下划线、连字符、空格。

4. 选择建议类型。

5. 如果您选择了网页级优化模型类型：

   1. 选择“网页级优化”模型将为您优化的网页类型。

   2. 选择在各个面板中限制类似服务配置的投放程度：

      • 模型类型唯一：不允许将具有相同模型类型的多个服务配置显示在不同的面板上。

      • 唯一模型：不允许将含有相同模型的多个投放配置显示在不同面板上。

      • 独特的服务配置：不允许将同一服务配置显示在多个面板上。

      • 无限制：允许将任意服务配置显示在任意数量的面板上。

   3. 对于您计划使用此模型显示的每个推荐面板：

      1. 输入面板 ID。

      2. 选择网页级优化模型可将哪些投放配置视为相应面板的选项。

         例如，在“添加到购物车”页面上，您可能希望在某个建议面板中显示“经常一起购买的产品”或“其他可能感兴趣的商品”建议。在这种情况下，请选择一个使用“经常一起购买”模型的服务配置，以及另一个使用“您可能喜欢的其他商品”模型的服务配置，以便在此面板上进行考虑。当您向页面级优化模型发出预测调用时，该模型会根据最终用户的事件历史记录，选择您应在该面板中展示的推荐类型。

      3. 选择默认服务配置。

         如果 Google 服务器发生中断，网页级优化模型仍可根据默认投放配置提供结果。

   4. 如果您需要创建其他面板，请针对每个新面板点击添加面板，然后输入新面板的详细信息。

6. 选择业务目标（如果所选模型类型支持此选项）。

7. 如果您选择了“经常一起购买”模型类型，请选择情境商品类型：

   • 多个上下文商品：使用一项或多项内容作为上下文来根据此模型提供建议。
   • 单个上下文商品：使用一项内容作为上下文来根据此模型提供建议。

8. 查看是否满足数据要求？列表，确认您已为所选模型类型上传足够的数据。

   如果未满足的数据要求导致您无法创建模型，相应要求旁边会显示 X 图标，并且创建推荐模型窗格底部的创建按钮会处于停用状态。

   如果您需要上传更多数据，请仔细查看列出的数据要求，确保满足该模型的部分或全部要求，然后导入创建模型所需的用户事件或商品

   如需了解如何导入，请参阅导入历史用户事件和导入目录信息。

9. 选择模型调参的频率。如需了解调整费用详情，请参阅价格。

   • 每 3 个月：模型每 3 个月自动调整一次。
   • 仅限手动调参：模型仅在您手动调参时进行调参。

10. （公开试用功能）选择是否自动生成用于过滤的标记。

    • 自动生成标记：启用此选项后，您可以过滤此模型的推荐结果。启用此选项可能会增加训练时间。如需了解训练费用详情，请参阅价格。
    • 不生成标记：如果此选项处于关闭状态，您将无法从该模型获得过滤后的推荐。

11. 点击创建以创建新的推荐模型。

    如果您上传了所需类型的足够用户事件数据，则初始模型训练和调整会开始执行。初始模型训练和调整需要 2-5 天才能完成，但对于大型数据集，可能需要更长时间。

    您可以在训练完成之前为新模型创建展示位置，但在初始训练和调整完成以及模型生效之前，这些展示位置将仅提供“试运行”预测。

curl

向 v2 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 天才能完成，但对于大型数据集，可能需要更长时间。

您可以在训练完成之前为新模型创建投放配置，但在初始训练和调整完成以及模型生效之前，这些投放配置将仅提供“试运行”预测。

创建新推荐模型的要求

首次为网站使用特定建议类型时，您正在训练一种新的机器学习模型，该模型需要足够的训练数据，以及训练和调整模型的时间。如要开始使用新的推荐类型，您需要按以下步骤操作：

1. 将目录导入 Vertex AI Search 商务解决方案（如果尚未执行此操作），并实现使上传的目录保持最新状态的流程。
2. 开始将用户事件记录到 Vertex AI Search for Commerce 中（如果您尚未这样做），请务必遵循记录用户事件数据的最佳实践。
3. 确定您要使用的建议类型和优化目标。
4. 确定您所选的推荐类型和目标的用户事件数据要求。
5. 导入历史用户事件数据以满足最低事件数据要求，或等到用户事件数据收集满足最低要求。

6. 创建模型和投放配置。

   此时，Vertex AI Search for Commerce 会启动模型训练和微调。初始模型训练和调整需要 2-5 天才能完成，但对于大型数据集，可能需要更长时间。

7. 使用预测预览确认您的模型可正常运行。

8. 创建 A/B 实验。

模型类型最低数据要求

您导入的用户事件类型和所需数据量取决于您的推荐（模型）类型和优化目标。达到最低数据要求后，您就可以开始训练模型。

数据收集窗口表示用户事件的时间段；导入更多历史数据不会影响模型质量。

请务必使用真实的用户事件和真实的目录数据。无法基于合成数据构建优质模型。

模型类型	优化目标	支持的用户事件类型	最低数据要求	数据收集时段
为您推荐	点击率	detail-page-view home-page-view	过去 90 天内有 7 天发生了 detail-page-view 事件，并且每个目录项平均发生了 10 次 detail-page-view 事件（90 天时间段），或者过去 90 天内有 60 天发生了 detail-page-view 事件 过去 90 天内，detail-page-view 事件有 100 个不重复的目录项 过去 90 天内发生了 10,000 次 detail-page-view 事件 且 过去 90 天内有 7 天的 home-page-view 事件 过去 90 天内发生了 10,000 次 home-page-view 事件	3 个月
为您推荐	转化率	add-to-cart detail-page-view home-page-view	过去 90 天内有 7 天的 add-to-cart 事件数据，并且每个目录项平均有 10 次 add-to-cart 事件数据（90 天时间段）或者过去 90 天内有 60 天的 add-to-cart 事件数据 过去 90 天内，add-to-cart 事件有 100 个不重复的目录项 过去 90 天内发生了 10,000 次 add-to-cart 事件 且 过去 90 天内有 7 天发生了 detail-page-view 事件，并且每个目录项平均发生了 10 次 detail-page-view 事件（90 天时间段），或者过去 90 天内有 60 天发生了 detail-page-view 事件 过去 90 天内，detail-page-view 事件有 100 个不重复的目录项 过去 90 天内发生了 10,000 次 detail-page-view 事件 且 过去 90 天内有 7 天的 home-page-view 事件 过去 90 天内发生了 10,000 次 home-page-view 事件	3 个月
为您推荐	每次会话的收入	add-to-cart detail-page-view home-page-view	过去 90 天内有 7 天发生了 add-to-cart 事件，并且每个目录项平均发生了 10 次 add-to-cart 事件（90 天时间段），或者过去 90 天内有 60 天发生了 add-to-cart 事件 过去 90 天内， add-to-cart 事件有 100 个不重复的目录项 过去 90 天内发生了 10,000 次 add-to-cart 事件 且 过去 90 天内有 7 天的 home-page-view 事件 过去 90 天内发生了 10,000 次 home-page-view 事件	3 个月
您可能喜欢的其他类型	点击率	detail-page-view	过去 90 天内有 7 天发生了 detail-page-view 事件，并且每个目录项平均发生了 10 次 detail-page-view 事件（90 天时间段）；或者过去 90 天内有 60 天发生了 detail-page-view 事件 过去 90 天内，detail-page-view 事件有 100 个不重复的目录项 过去 90 天内发生了 10,000 次 detail-page-view 事件	3 个月
您可能喜欢的其他类型	转化率	add-to-cart detail-page-view	过去 90 天内有 7 天发生了 add-to-cart 事件，并且每个目录项平均有 10 次 add-to-cart 事件（90 天时间段），或者过去 90 天内有 60 天发生了 add-to-cart 事件 过去 90 天内，add-to-cart 事件有 100 个不重复的目录项 过去 90 天内发生了 10,000 次 add-to-cart 事件 且 过去 90 天内有 7 天发生了 detail-page-view 事件，并且每个目录项平均发生了 10 次 detail-page-view 事件（90 天时间段），或者过去 90 天内有 60 天发生了 detail-page-view 事件 过去 90 天内，detail-page-view 事件有 100 个不重复的目录项 过去 90 天内发生了 10,000 次 detail-page-view 事件	3 个月
您可能喜欢的其他类型	每次会话的收入	add-to-cart detail-page-view	过去 90 天内有 7 天发生了 add-to-cart 事件，并且每个目录项平均有 10 次 add-to-cart 事件（90 天时间段），或者过去 90 天内有 60 天发生了 add-to-cart 事件 过去 90 天内，add-to-cart 事件有 100 个不重复的目录项 过去 90 天内发生了 10,000 次 add-to-cart 事件 且 过去 90 天内有 7 天发生了 detail-page-view 事件，并且每个目录项平均发生了 10 次 detail-page-view 事件（90 天时间段），或者过去 90 天内有 60 天发生了 detail-page-view 事件 过去 90 天内，detail-page-view 事件有 100 个不重复的目录项 过去 90 天内发生了 10,000 次 detail-page-view 事件	3 个月
经常一起购买的商品	每次会话的收入	purchase-complete	每个目录项平均有 10 次（1 年内有 purchase-complete 事件）或者过去 1 年内有 90 天有 purchase-complete 事件 过去 1 年内，purchase-complete 事件至少有 100 个非重复目录项 过去 1 年内有 1,000 次 purchase-complete 事件	3 个月 我们建议您至少每天上传一次事件，以保持良好的数据质量。在导入历史事件期间，请确保数据分布偏向最近的时间戳。最后一个时间戳日期的事件数应等于或大于平均每日事件数。
上架销售	点击率	detail-page-view home-page-view	过去 90 天内有 7 天发生了 detail-page-view 事件，并且每个目录项平均发生了 10 次 detail-page-view 事件（90 天时间段），或者过去 90 天内有 60 天发生了 detail-page-view 事件 过去 90 天内，detail-page-view 事件有 100 个不重复的目录项 过去 90 天内发生了 10,000 次 detail-page-view 事件 且 过去 90 天内有 7 天的 home-page-view 事件 过去 90 天内发生了 10,000 次 home-page-view 事件	3 个月
上架销售	转化率	add-to-cart detail-page-view home-page-view	过去 90 天内有 7 天发生了 add-to-cart 事件，并且每个目录项平均发生了 10 次 add-to-cart 事件（90 天时间段），或者过去 90 天内有 60 天发生了 add-to-cart 事件 过去 90 天内，add-to-cart 事件有 100 个不重复的目录项 过去 90 天内发生了 10,000 次 add-to-cart 事件 且 过去 90 天内有 7 天发生了 detail-page-view 事件，并且每个目录项平均发生了 10 次 detail-page-view 事件（90 天时间段），或者过去 90 天内有 60 天发生了 detail-page-view 事件 过去 90 天内，detail-page-view 事件有 100 个不重复的目录项 过去 90 天内发生了 10,000 次 detail-page-view 事件 且 过去 90 天内有 7 天的 home-page-view 事件 过去 90 天内发生了 10,000 次 home-page-view 事件	3 个月
类似商品	不适用	不需要。	必须至少有 100 个商品 SKU 存在于某个分支中	不适用
页面级优化	不限	detail-page-view add-to-cart purchase-complete home-page-view	网页级优化通过在多个可能的模型之间进行选择来优化推荐面板。请参阅您选择作为网页级优化选项的模型的相应数据要求。	不适用
再次购买	不适用	purchase-complete	每个目录项平均有 10 次（90 天时间段内有 purchase-complete 事件）或过去 90 天内有 60 天有 purchase-complete 事件 过去 90 天内，purchase-complete 事件有 100 个不重复的目录项 过去 90 天内发生了 1,000 次 purchase-complete 事件 必须至少有 100 个商品 SKU 存在于某个分支中	不适用 我们建议您至少每天上传一次事件，以保持良好的数据质量。在导入历史事件期间，请确保数据分布偏向最近的时间戳。最后一个时间戳日期的事件数应等于或大于平均每日事件数。

后续步骤

• 为模型创建投放配置。
• 了解如何为模型暂停和恢复训练。
• 模型训练完成后，开始请求推荐。