管理投放配置

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

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

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

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

修改投放配置

您可以使用 Gemini Enterprise for Customer Experience 控制台或 API 中的 AI Commerce Search 修改投放配置。

在控制台中修改投放配置

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

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

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

内嵌修改投放配置

您可以使用 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'

查看投放配置

您可以使用 Gemini Enterprise for Customer Experience 控制台或 API 中的 AI Commerce Search 查看投放配置。

在控制台中查看投放配置

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

内嵌查看投放配置

如需内嵌查看单个投放配置，请使用 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'

删除投放配置

您可以使用 Gemini Enterprise for Customer Experience 控制台或 API 中的 AI Commerce Search 删除投放配置。

在控制台中删除投放配置

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

  1. 在 Gemini Enterprise for Customer Experience 控制台中，前往 AI Commerce Search 的“投放配置”页面。

    前往“投放配置”页面

  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'

查看投放配置统计信息

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

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