管理投放控制

本页介绍了如何查看、修改、删除、导出和导入投放控制。

如需了解投放控件的一般信息以及有关如何创建投放控件的说明，请参阅投放控件简介和创建投放控件。

查看和修改投放控件

您可以使用控制台和 API 查看 Vertex AI Search for Retail 的广告投放控制功能。

在控制台中查看和修改投放控件

通过 服务控件标签页 其中列出了所有投放控件及其关联的 服务配置点击 用于更改控件的修改控件图标 修改控件中关联的服务配置 面板。点击控件的 Delete control（删除控件）图标可将其删除，这也会将其从所有投放配置中移除。

您还可以在以下位置查看和修改特定服务配置的控件： 服务配置页面。 点击一项服务配置以查看其详细信息页面，其中列出了 服务控件点击 用于更改控件的修改控件图标 在修改控件面板中修改其设置。点击 移除控件图标 将控件与服务配置分离（这不会删除 控制）。

新创建的或更新的控件需要几分钟时间才能准备好传送实时流量。您可以在控制台的评估页面上测试更改是否已应用。

查看内嵌的投放控件

如需在线内查看单个投放控制，请使用 Control.get。

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

如需内嵌列出多个投放控件，请使用 Controls.list。

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

如需仅列出与特定服务配置关联的控件，请使用 filter 查询参数指定服务配置 ID。

如需详细了解此方法，请参阅 Control.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/controls?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=servingConfig=SERVING_CONFIG_ID

内嵌补丁服务控件

如需更新服务控件中的字段，请使用 Controls.patch 并在请求正文中包含 Control 的实例。使用 updateMask 参数指定要更新的字段，或将其保持未设置状态以更新所有受支持的字段。

有关此方法的详细信息，请参阅 Controls.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/controls/CONTROL_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/controls/CONTROL_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

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

如需向投放配置添加控件，请使用 ServingConfig.addControl。

有关此方法的详细信息，请参阅 ServingConfig.addControl API 参考文档。

如需查看此方法的示例，请参阅管理投放配置。

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

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

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

如需查看此方法的示例，请参阅管理投放配置。

删除投放控件

您可以从控制台删除投放控制，也可以使用 Controls.delete 方法在代码中删除。

在控制台中删除服务控件

删除投放控件，从正在使用它的所有投放配置中移除该控件。

  1. 前往 Search for Retail 控制台中的控件页面。

    前往“控件”页面

  2. 在计划要移除的控件的表行中，点击 删除。

  3. 在确认窗口中，点击删除以完成删除。

以内嵌方式删除服务控件

如需以内嵌方式删除服务控件，请使用 Controls.delete。

有关此方法的详细信息，请参阅 Controls.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/controls/SERVING_CONTROL_ID'

导出服务控件

您可以将服务控件导出到 Cloud Storage 存储桶中的一个文件。

您可能需要导出和导入服务控件的原因有以下两种：

  • 将投放控制功能从一个项目移至另一个项目。

  • 对所有或部分投放控件执行批量修改。导出传送内容 编辑导出的文件，然后导入该文件以更改或添加 投放控件

您可以通过 Search for Retail 控制台进行导出和导入。导出服务控件时，您将导出 项目。

如需导出服务控件，请执行以下操作：

  1. 前往 Search for Retail 控制台中的控件页面。

    前往“控件”页面

  2. 在投放控件标签页上，点击导出控件。

  3. 在 Export Serving Controls 窗口中，选择要将控制文件导出到的 Cloud Storage 存储桶。

  4. 点击导出。

    导出的控件会保存到所选存储桶中的 NDJSON 文件中，文件名采用以下格式：

    projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson

  5. 导出操作完成后，您可以在以下位置查看操作状态： 导出中的批量导入、导出、删除活动列表 activity 窗口中。点击消息窗口中的显示，或按照查看特定集成操作的状态中的说明操作，打开导出活动窗口。

导入服务控件

要批量添加投放控件或修改现有投放控件，您可以将 导出的控件文件中的更改然后，您可以将其导入原始项目或其他项目。

关于导入投放控件的注意事项：

  • 如果投放控制文件同时包含这两种文件，则无法导入 搜索和建议投放控件。

  • 导入服务控件后，文件中的所有服务控件都会与您在导入时指定的服务配置相关联。如果 服务控件已与以下服务配置中的另一项服务配置相关联： 项目，那么这种关联也会保持下去。

如需导入投放控制功能，请执行以下操作：

  1. 修改并查看导出的服务控制文件，并将该文件放在 Cloud Storage 存储桶。（如需导出服务控件，请参阅上述任务 导出服务控件。）

    确保该文件仅包含搜索广告投放控制或推荐广告投放控制。您无法导入 文件。

  2. 前往 Search for Retail 控制台中的控件页面。

    转到“控件”页面

  3. 在投放控件标签页上，点击导入控件。

  4. 在导入服务控件窗口中：

    1. 浏览并选择 Cloud Storage 存储桶和 NDJSON 文件，其中包含您要创建的控件 导入的数据。

    2. 选择要将导入的服务控件与之相关联的服务配置。

    3. 查看“导入预览”方案。将创建的控件包括 新建标签上显示的具体控件以及 显示在“已修改”标签页中。

  5. 点击导入。

    系统会启动一个长时间运行的操作来导入新控件和修改后的控件。

  6. 导入操作完成后，您可以在 活动状态窗口的控件标签页。点击消息窗口中的显示，或按照查看特定集成操作的状态中的说明操作，打开活动状态窗口。