创建服务配置

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

准备工作

推荐和搜索广告投放配置有不同的要求和选项：

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

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

您稍后可以切换模型，前提是该模型的类型与原来相同。
搜索广告可以使用投放控件，但这并非强制性要求。如果您打算将现有控件附加到新的投放配置，请获取您打算使用的控件的 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：必填。Search for Retail 控制台中显示的易于理解的 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：必填。Search for Retail 控制台中显示的易于理解的 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` 创建服务配置