这是 Recommendations AI、Retail Search 和新的 Retail 控制台的文档。

创建服务配置

本页面介绍如何创建投放配置。投放配置是一种模型实体,它关联模型或一组用于生成搜索或建议结果的控件。

准备工作

Recommendations AI 和 Retail Search 服务配置具有不同的要求和选项:

  • Recommendations AI 服务配置需要模型。如果您计划将现有模型附加到新的服务配置,请获取计划使用的模型的 ID(使用 ServingConfig.create 方法时需要)。

    如果使用控制台创建应用配置,您可以在创建过程中创建新模型,而不是附加现有模型。

    您可以稍后切换模型,只要模型类型相同即可。

  • Retail Search 可以使用服务控制,但这并非强制性要求。如果您计划将现有控件附加到新的服务配置,请获取您计划使用的控件的 ID。

    如果使用控制台创建服务配置,则还可以在创建过程中创建新控件。

    创建服务配置后,您可以在服务配置中切换或添加服务控件。

创建投放配置

您可以通过以下方式创建服务配置:

每个目录最多可以有 100 个服务配置。

如果您已有展示位置或创建新的展示位置,Retail API 会自动创建与每个展示位置关联的投放配置。创建投放配置不会创建对应的展示位置。删除投放配置会删除其相应的展示位置,而删除展示位置会删除其相应的投放配置。

在控制台中创建服务配置

在 Google Cloud Console 的服务配置页面上添加新的服务配置。

要创建新的投放配置,请执行以下操作:

  1. 转到 Google Cloud Console 中的“零售服务配置”页面。

    转到“投放配置”页面

  2. 点击 创建投放配置

    Recommendations AI

    1. 选择建议作为供应配置的商品。

    2. 为您的投放配置提供名称。

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

    3. (可选)如果需要,请更新 ID。

      该 ID 通过您提供的名称生成,并且在项目中必须是唯一的。名称不能超过 50 个字符,并且不能包含空格。

    4. 选择或创建您希望此投放配置为之提供建议的模型。

      详细了解如何创建新模型。

    5. 选择价格重排序应会对推荐结果的影响程度。

      启用这项功能后,推荐概率相近的推荐产品会按价格进行排序,价格最高的商品列在第一位。相关性仍会用于订购商品,因此启用价格重排序与按价格排序不同。

    6. 选择建议结果的多样化程度。

      多样性会影响单个预测请求返回的结果是否来自商品清单的不同类别。

    7. 如果您为此投放配置选择了“类似商品”模型,请选择是否启用类别匹配。

      启用类别匹配后,Retail API 只会返回与上下文产品共享至少一个类别的商品结果。类别匹配可以与其他过滤选项(例如价格、库存状况和过滤标记)结合使用。

    1. 创建服务配置页面上,选择搜索作为服务配置将使用的产品。
    2. 为您的服务配置提供名称。

      名称不得超过 1024 个字符,并且只能包含字母数字字符、下划线、连字符和空格。
    3. (可选)根据需要更新该 ID。

      该 ID 是系统根据您提供的名称生成的,并且在整个项目中必须是唯一的。不得超过 50 个字符,且不能包含空格。
    4. 点击继续
    5. 选择是否为此投放配置启用动态构面。
    6. 选择或创建服务控件以优化您的搜索。

      如需详细了解控件,请参阅创建和管理控件
  3. 点击创建,以新建配置文件。

    新配置会显示在“投放配置”页面中。

    配置可能需要几分钟才能用于搜索请求。它可以立即用于推荐。

  4. (可选)在“投放配置”页面上,点击投放配置名称并转到其评估标签页,以预览为此配置返回的产品。

    评估预览可帮助您确认配置是否按预期运行。

使用 ServingConfig.create 创建应用配置

您可以使用 ServingConfig.create API 方法创建服务配置。如需查看此方法的 API 参考文档,请参阅 ServingConfig.create

具体使用哪些字段取决于您是为 Recommendations AI 还是 Retail Search 创建服务配置。

如需详细了解 ServingConfig 字段,请参阅 ServingConfigs API 参考文档

Recommendations AI

使用传送配置 ID 和请求正文中包含的 ServingConfig 实例发出 ServingConfig.create 请求。

  • servingConfigId:必填。为您的 ServingConfig 创建 ID。此值应为 4-63 个字符。有效字符为 /[a-z][0-9]-_/
  • displayName:必填。Retail Console 中显示的简单易懂的 ServingConfig 名称。
  • modelID:必填。服务时使用的模型 ID。
  • priceRerankingLevel:可选。设置价格重排序将在多大程度上影响推荐结果。允许的值为 no-price-reranking(如果未设置,则使用默认值)、low-price-rarankingmedium-price-rerankinghigh-price-reranking
  • enableCategoryFilterLevel:可选。设置是否要为“相似商品”模型添加其他类别过滤条件。允许的值为 relaxed-category-match(如果未设置,则为默认值)和 no-category-match
  • solutionTypes:必填。对于 Recommendations AI 服务配置,应设置为 SOLUTION_TYPE_RECOMMENDATION
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "modelId": "MODEL_ID",
              "priceRerankingLevel": "PRICE_RERANKING_LEVEL",
              "diversityLevel": "DIVERSITY_LEVEL",
              "enableCategoryFilterLevel": "CATEGORY_FILTER_LEVEL",
              "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ]
            }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"
  

Retail Search

使用传送配置 ID 和请求正文中包含的 ServingConfig 实例发出 ServingConfig.create 请求。

  • servingConfigId:必填。为您的 ServingConfig 创建 ID。此值应为 4-63 个字符。有效字符为 /[a-z][0-9]-_/
  • displayName:必填。Retail Console 中显示的简单易懂的 ServingConfig 名称。
  • facetControlIds:可选。仅设置了 FacetSpec 的控件的 ID。
  • dynamicFacetSpec.mode:可选。DynamicFacet 功能的模式。 允许的值为 DISABLED(如果未设置,则为默认值)和 ENABLED
  • boostControlIds:可选。推广活动呈现控件的 ID。
  • filterControlIds:可选。过滤器投放控件的 ID。
  • redirectControlIds:可选。重定向服务控件的 ID。
  • twowaySynonymsControlIds:可选。双向同义词服务控制的 ID。
  • onewaySynonymsControlIds:可选。单向同义词服务控制的 ID。
  • doNotAssociateControlIds:可选。不关联服务控件的 ID。
  • replacementControlIds:可选。替换投放控件的 ID。
  • ignoreControlIds:可选。忽略投放控件的 ID。
  • solutionTypes:必填。对于 Retail Search 服务配置,应设置为 SOLUTION_TYPE_SEARCH
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "facetControlIds": [
                "FACET_CONTROL_ID_1",
                "FACET_CONTROL_ID_2"
              ],
              "dynamicFacetSpec": {
                "mode": "DYNAMIC_FACET_MODE"
              },
              "boostControlIds": [
                "BOOST_CONTROL_ID_1",
                "BOOST_CONTROL_ID_2"
              ],
              "filterControlIds": [
                "FILTER_CONTROL_ID_1",
                "FILTER_CONTROL_ID_2"
              ],
              "redirectControlIds": [
                "REDIRECT_CONTROL_ID_1",
                "REDIRECT_CONTROL_ID_2"
              ],
              "twowaySynonymsControlIds": [
                "TWO_WAY_SYNONYM_CONTROL_ID_1",
                "TWO_WAY_SYNONYM_CONTROL_ID_2"
              ],
              "onewaySynonymsControlIds": [
                "ONE_WAY_SYNONYM_CONTROL_ID_1",
                "ONE_WAY_SYNONYM_CONTROL_ID_2"
              ],
              "doNotAssociateControlIds": [
                "DO_NOT_ASSOCIATE_CONTROL_ID_1",
                "DO_NOT_ASSOCIATE_CONTROL_ID_2"
              ],
              "replacementControlIds": [
                "REPLACEMENT_CONTROL_ID_1",
                "REPLACEMENT_CONTROL_ID_2"
              ],
              "ignoreControlIds": [
                "IGNORE_CONTROL_ID_1",
                "IGNORE_CONTROL_ID_2"
              ],
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ]
    }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"
  

后续步骤