管理投放配置

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

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

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

修改投放配置

您可以使用 Search for Retail 控制台或 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。控件会添加到其所属控件列表的最后位置。例如，在 servingConfig.facetSpecIds 的最后一个位置应用 facetSpec 控件。

如需详细了解此方法，请参阅 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'

查看服务配置

您可以使用 Retail Search 控制台或 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'

删除服务配置

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

在控制台中删除服务配置

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

前往 Search for Retail 控制台中的投放配置页面。

前往“投放配置”页面
点击要删除的投放配置以打开其详情页面。
点击页面顶部按钮栏中的删除。
如果投放配置被视为有效，您必须重新键入其 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'

查看投放配置统计信息

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

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