创建服务配置

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

准备工作

推荐和搜索服务配置有不同的要求和选项：

推荐服务配置需要模型。如果您计划将现有模型附加到新的服务配置，请获取您计划使用的模型的 ID（使用 ServingConfig.create 方法时必需）。

如果使用控制台创建服务配置，您可以创建新的而不是附加现有模型。

您可以稍后切换模型，只要模型类型相同即可。
Google 搜索可以使用服务控件，但不是必需的。如果您打算将现有控件附加到新的投放配置，请获取您打算使用的控件的 ID。

如果使用控制台创建服务配置，您还可以创建一些新控件

之后，您可以在服务配置中切换或添加服务配置。

创建服务配置

您可以使用以下工具来创建服务配置：

Search for Retail 控制台。
ServingConfig.create API。

每个目录最多允许 100 项服务配置。

如果您已有展示位置，或创建新的展示位置，系统会自动创建与每个展示位置关联的投放配置。创建投放配置不会创建相应的展示位置。删除服务配置会删除相应的展示位置，同时删除一个展示位置删除其相应的服务配置

在控制台中创建服务配置

在 Search for Retail 控制台中的“投放配置”页面上添加新的投放配置。

如需创建新的服务配置，请执行以下操作：

前往 Search for Retail 控制台中的服务配置页面。

前往“投放配置”页面
点击 创建投放配置。
建议
1. 选择建议作为供应配置的商品。
2. 为服务配置提供一个名称。
  
  名称不得超过 1024 个字符，并且只能包含字母数字字符、下划线、连字符、空格。
3. 可选：如果需要，请更新 ID。
  
  该 ID 通过您提供的名称生成，并且在项目中必须是唯一的。名称不能超过 50 个字符，并且不能包含空格。
4. 选择或创建您希望此服务配置使用的模型提供建议。
  
  详细了解如何创建新模型。
5. 选择价格重排序应会对推荐结果的影响程度（如果您选择的模型支持此设置）。
  
  启用这项功能后，推荐概率相近的推荐产品会按价格进行排序，价格最高的商品列在第一位。相关性仍会用于订购商品，因此启用价格重排序与按价格排序不同。
6. 选择使用基于规则的多样化还是数据驱动的多样化：
  - 基于规则：基于规则的多样化会影响单个预测请求返回的结果来自不同类别的产品。
  - 以数据为依据：利用机器学习技术实现数据驱动的多样化在预测中平衡类别多样性和相关性结果。
  如需了解详情，请参阅多元化。
7. 选择建议结果的多样化程度。
8. 如果您为此服务配置选择了“类似商品”模型，请选择是否启用类别匹配。
  
  启用类别匹配后，系统只会返回与情境商品至少具有一个类别的商品结果。类别匹配可与其他过滤功能结合使用例如价格、库存状况和过滤代码
搜索
1. 在创建服务配置页面上，选择搜索作为供应配置的商品。
2. 为您的投放配置提供名称。
  
  名称不得超过 1024 个字符，并且只能包含字母数字字符、下划线、连字符和空格。
3. 可选：如果需要，请更新 ID。
  
  该 ID 通过您提供的名称生成，并且在项目中必须是唯一的。必须为 50 个字符或更少，且不能包含空格。
4. 点击继续。
5. 选择是否为此服务配置启用动态分面。
6. 选择或创建投放控件来优化搜索。
  
  了解详情如需了解控件，请参阅创建和管理控件。
点击创建，以新建配置文件。

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

配置可能需要几分钟才能用于搜索请求。它可以立即用于推荐。
可选：在“投放配置”页面上，点击投放配置名称并转到其评估标签页，以预览为此配置返回的产品。

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

使用 `ServingConfig.create` 创建服务配置

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

使用哪些字段取决于您要为以下对象创建服务配置：建议或搜索。

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

建议

发出 ServingConfig.create 请求，其中包含请求正文中的广告投放配置 ID 和 ServingConfig 实例。

servingConfigId：必填。为 ServingConfig 创建 ID。此值应为 4-63 个字符。有效字符为 /[a-z][0-9]-_/。
displayName：必填。显示直观易懂的 ServingConfig 名称。
modelID：必填。应用时使用的模型的 ID。
priceRerankingLevel：可选。设置价格重排序应会对推荐结果的影响程度。允许的值为 no-price-reranking （如果未设置则为默认值）、low-price-raranking、medium-price-reranking 和 high-price-reranking。
diversityLevel：可选。设置在多大程度上实现推荐的多样化程度结果。允许的值为 no-diversity（默认）、low-diversity、 medium-diversity、high-diversity 和 auto-diversity。如果未设置 diversityLevel，则多样性功能会被停用。
diversityType：可选。设置为 RULE_BASED_DIVERSITY 可根据商品类别多样化推荐结果。设置为 DATA_DRIVEN_DIVERSITY，根据学习情况提供多样化的推荐来平衡相关性和类别多样性。如果设置了 diversityLevel 但未设置 diversityType，则 diversityType 默认为基于规则。如需了解详情，请参阅多元化。
enableCategoryFilterLevel：可选。设置是否在“类似商品”模型中添加其他类别过滤条件。允许的值包括 relaxed-category-match（如果未设置，则为默认值）和 no-category-match。
solutionTypes：必填。对于推荐内容投放配置，请将其设为 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",
              "diversityType": "DIVERSITY_TYPE",
              "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"

搜索

发出 ServingConfig.create 请求，其中包含请求正文中的广告投放配置 ID 和 ServingConfig 实例。

servingConfigId：必填。为 ServingConfig 创建 ID。此值应为 4-63 个字符。有效字符为 /[a-z][0-9]-_/。
displayName：必填。显示直观易懂的 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：必填。针对以下时长设为 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"

后续步骤

从新的展示位置请求预测。

创建服务配置

准备工作

创建服务配置

在控制台中创建服务配置

建议

搜索

使用 ServingConfig.create 创建服务配置

建议

搜索

后续步骤

使用 `ServingConfig.create` 创建服务配置