创建推荐模型

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

注意： 您无需为 搜索

手动配置或创建模型。

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

简介

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

如需简要了解 AI Commerce Search 的使用流程，请参阅 实现 AI Commerce Search。

创建推荐模型

使用 Gemini Enterprise for Customer Experience 中的 AI Commerce Search 控制台 或 models.Create API 方法添加新的推荐模型。

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

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

在创建新模型之前，请执行以下操作：

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

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

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

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

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

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

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

Google Cloud 控制台

1. 在 Gemini Enterprise for Customer Experience 控制台中，前往 AI Commerce Search 的“模型”页面。
   
   转到“模型”页面

2. 点击创建模型。

3. 为模型输入名称。

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

4. 选择推荐类型。

5. 如果您选择了页面级优化模型类型，请执行以下操作：

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

   2. 选择在不同面板中限制类似投放配置的投放程度：

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

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

      • 唯一投放配置 ：不允许将同一投放配置显示在多个面板上。

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

   3. 对于您计划使用此模型显示的每个推荐面板，请执行以下操作：

      1. 输入面板 ID。

      2. 选择页面级优化模型可考虑作为该面板选项的投放配置。

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

      3. 选择默认投放配置。

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

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

6. 选择业务目标（如果适用于您选择的模型类型）。

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

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

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

   如果未满足的数据要求阻止您创建模型，则该要求旁边会显示 X 图标，并且创建 按钮在创建 推荐模型 窗格底部处于停用状态。

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

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

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

   • 每三个月：模型每三个月自动调整一次。
   • 仅限手动调整：仅当您手动调整模型时，模型才会进行调整 。

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

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

   此时，AI Commerce Search 会启动模型训练和调整。 初始模型训练和调整需要 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 次 purchase-complete 事件（1 年时间段）；或在过去 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 次 purchase-complete 事件（90 天时间段）；或在过去 90 天内，至少要有 60 天的 purchase-complete 事件数据 在过去 90 天内，purchase-complete 事件至少有 100 个不重复的目录项 在过去 90 天内，至少要有 1,000 次 purchase-complete 事件 必须至少有 100 个商品 SKU 存在于某个分支中	不适用 我们建议您至少每天上传一次事件，以保持良好的数据 质量。在导入历史事件期间，请确保数据 分布偏向最近的时间戳。最后一个时间戳当天的事件数应等于或大于每日平均事件数。

后续步骤

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