管理投放控制

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

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

查看和修改投放控件

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

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

“控件”页面的投放控件标签页列出了所有投放控件及其相关投放配置。点击控件的 Edit control（修改控件）图标，即可在 Edit control（修改控件）面板中更改其设置和关联的投放配置。点击控件的 Delete control（删除控件）图标可将其删除，这也会将其从所有投放配置中移除。

您还可以在投放配置页面上查看和修改特定投放配置的控件。点击投放配置可查看其详细信息页面，该页面列出了该配置的所有投放控件。点击控件的 Edit control 图标，即可在 Edit control 面板中更改其设置。点击 Remove 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. 导出操作完成后，您可以在导出活动窗口的批量导入、导出、删除活动列表中查看操作状态。点击消息窗口中的显示，或按照查看特定集成操作的状态中的说明操作，打开导出活动窗口。

导入服务控件

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

关于导入服务控件的注意事项：

  • 如果服务控件文件同时包含搜索和推荐服务控件，则无法导入。

  • 导入服务控件后，文件中的所有服务控件都会与您在导入时指定的服务配置相关联。如果服务控件已与项目中的其他服务配置相关联，系统也会保留该关联。

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

  1. 修改和查看导出的分发控制文件，并将该文件放入 Cloud Storage 存储桶中。（如需导出服务控件，请参阅上一个任务导出服务控件。）

    确保该文件仅包含搜索广告投放控制或推荐广告投放控制。您无法导入同时包含这两种类型的文件。

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

    前往“控件”页面

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

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

    1. 浏览并选择包含要导入的控件的 Cloud Storage 存储桶和 NDJSON 文件。

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

    3. 查看“导入预览”方案。将要创建的控件会显示在 New 标签页中，而要修改的控件会显示在 Modified 标签页中。

  5. 点击导入。

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

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