管理投放控制

本页面介绍了如何查看、修改、删除、导出和导入服务控件。

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

查看和修改投放控件

您可以使用控制台和 API 查看 Vertex AI Search for Commerce 的服务控制。

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

“控件”页面的投放控件标签页列出了所有投放控件及其相关投放配置。点击控件的修改控件图标,即可在修改控件面板中更改其设置和关联的投放配置。点击某个控件对应的 删除控件图标即可删除该控件,同时也会将其从所有服务配置中移除。

您还可以在投放配置页面上查看和修改特定投放配置的控件。点击投放配置以查看其详细信息页面,该页面列出了该配置的所有投放控件。点击某个控件的修改控件图标,即可在修改控件面板中更改其设置。点击移除控件图标,将控件与投放配置解除关联(这不会删除控件)。

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

内嵌查看投放控件

如需内嵌显示单个广告投放控件,请使用 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 commerce 控制台中的控件页面。

    转到“控件”页面

  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 存储桶中的文件。

您可能出于以下两种原因需要导出和导入服务控件:

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

  • 对所有或部分投放控件执行批量修改。导出服务控件,修改导出的文件,然后导入该文件以更改或添加服务控件。

您可以通过“面向商业的搜索”控制台导出和导入数据。 导出服务控件时,您会导出项目中的所有服务控件。

如需导出服务控件,请执行以下操作:

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

    转到“控件”页面

  2. 投放控件标签页上,点击导出控件

  3. 导出服务控件窗口中,选择要将控件文件导出到的 Cloud Storage 存储桶。

  4. 点击导出

    导出的控制变量会保存到所选存储桶中的 NDJSON 文件中,文件名采用以下格式:

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

导入服务控件

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

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

  • 如果服务控制文件同时包含搜索服务控制和推荐服务控制,您将无法导入该文件。

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

如需导入投放控制设置,请执行以下操作:

  1. 修改并查看导出的投放控制文件,然后将该文件放入 Cloud Storage 存储桶中。(如需导出服务控件,请参阅上一个任务导出服务控件。)

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

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

    转到“控件”页面

  3. 投放控件标签页上,点击导入控件

  4. 导入服务控件窗口中:

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

    2. 选择要与导入的投放控件相关联的投放配置。

    3. 查看“导入预览”计划。将要创建的控件显示在 New 标签页上,将要修改的控件显示在 Modified 标签页上。

  5. 点击导入

    系统会启动一项长时间运行的操作,以导入新的和修改后的控制措施。

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