管理投放配置

本页介绍了如何删除、修改和列出投放配置，以及查看每个配置的统计信息。

如需有关创建新的投放配置的帮助，请参阅创建投放配置。

无需配置服务配置，搜索即可正常运行。任何 serving_config_id 都可以作为搜索请求的一部分放置，在这种情况下，它默认为空或未配置的投放控制。然后，系统会使用 Vertex AI Search for Commerce 的默认搜索功能搜索目录。

如果您已有展示位置，或创建新的展示位置，Vertex AI Search for Commerce 会自动创建与每个展示位置关联的投放配置。创建服务配置不会创建相应的展示位置。删除投放配置会删除其相应的展示位置，而删除展示位置将会删除其相应的投放配置。

修改投放配置

您可以使用“面向商业的搜索”控制台或 API 修改投放配置。

在控制台中修改投放配置

您可以在“投放配置”页面上查看和修改每项投放配置的控件。点击投放配置以查看其详细信息页面，该页面列出了该配置的所有投放控件和网站级控件。

在此页面上，您可以修改控件、创建新控件或将现有控件应用于配置。

新建或更新的投放配置可能需要几分钟时间才能处理实时流量。您可以立即在评估页面上测试更改。

内嵌修改服务配置

您可以使用 API 方法以内嵌方式更新投放配置字段、添加投放控制变量和移除投放控制变量。

内嵌式修补服务配置

如需更新服务配置中的字段，请使用 ServingConfig.patch，并在请求正文中包含 ServingConfig 的实例。使用 updateMask 参数指定要更新的字段，或将其留空以更新所有支持的字段。

如需详细了解此方法，请参阅 ServingConfig.patch API 参考文档。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID",
      "FIELD_NAME_1": "NEW_FIELD_VALUE_1"
      "FIELD_NAME_2": "NEW_FIELD_VALUE_2"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

内嵌式地向服务配置添加控件

如需向投放配置添加控制变量，请使用 ServingConfig.addControl。 该控件会添加到其所属控件列表的最后一个位置。 例如，facetSpec 控制变量应用于 servingConfig.facetSpecIds 的最后一个位置。

如需详细了解此方法，请参阅 ServingConfig.addControl API 参考文档。

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "controlID": "CONTROL_ID"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:addControl'

内嵌式从服务配置中移除控件

如需从投放配置中移除控件，请使用 ServingConfig.removeControl。

如需详细了解此方法，请参阅 ServingConfig.removeControl API 参考文档。

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "controlID": "CONTROL_ID"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:removeControl'

查看服务配置

您可以使用“面向商业的搜索”控制台或 API 查看投放配置。

在控制台中查看服务配置

您可以在“投放配置”页面上看到所有投放配置。

内嵌查看服务配置

如需内嵌查看单个投放配置，请使用 ServingConfig.get。

如需详细了解此方法，请参阅 ServingConfig.get API 参考文档。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID'

如需内嵌列出所有投放配置，请使用 ServingConfig.list。

（可选）您可以使用参数 pageSize 设置要返回的最大结果数。如果还有更多结果，list 响应会包含页面令牌。您可以在 list 请求的 pageToken 参数中传递页面令牌，以检索下一页结果。

如需详细了解此方法，请参阅 ServingConfig.list API 参考文档。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN'

删除服务配置

您可以使用 Search for Commerce 控制台或 API 删除投放配置。

在控制台中删除投放配置

如需在控制台中删除服务配置，请执行以下操作：

  1. 前往商业搜索控制台中的投放配置页面。

    前往“投放配置”页面

  2. 点击要删除的投放配置以打开其详情页面。

  3. 点击页面顶部按钮栏中的 删除。

  4. 如果投放配置被视为有效，您必须重新键入其 ID，然后点击确认完成删除。

内嵌删除服务配置

如需内嵌删除单个投放配置，请使用 ServingConfig.delete。

如需详细了解此方法，请参阅 ServingConfig.delete API 参考文档。

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID'

查看投放配置统计信息

您可以在“投放配置”页面上查看每项投放配置的详细信息。对于该表中的任何配置，点击查看分析可查看其统计信息。

点击率会显示针对该投放配置的每次搜索的点击次数。 转化率表示该配置每次搜索的购买次数。