适用于效果最大化广告系列的批处理

批量处理提供了一种方法,可将 一组操作(这些操作可能相互依赖)分派给多个服务,而无需 同步等待操作完成。您可以使用批量处理来创建和管理效果最大化广告系列。

本指南详细介绍了在使用批量处理时与效果最大化广告系列相关的具体信息。通用 批量处理指南提供了有关批量处理的通用 信息,而 构建请求指南则详细介绍了如何构建请求以创建或管理效果最大化 广告系列。

如需使用批量处理来创建效果最大化广告系列,请按以下步骤操作:

创建新的批量作业

按照创建 BatchJob资源的一般批处理 作业创建步骤进行操作。

准备变动操作列表

效果最大化广告系列需要执行操作来创建多个相关 资源,这些资源在 构建请求指南中进行了详细介绍。为应包含在批量作业中的每个资源创建一个 MutateOperation。

CampaignOperation 和 CampaignAssetOperation 要求

如果广告系列启用了品牌规范(请参阅 品牌规范),您必须使用 CampaignAsset 资源将 品牌资产关联到广告系列。此外,在批量作业中,必须在创建 Campaign 资源本身后立即创建这些 CampaignAsset 资源。如果未在创建 Campaign 资源后立即创建 CampaignAsset 资源(在启用品牌规范时 - 请参阅问题排查),请求将失败并返回 CampaignError,指明缺少素材资源。稍后在同一操作列表中添加 CampaignAsset 创建操作不会阻止此错误。

AssetGroupOperation 和 AssetGroupAssetOperation 要求

由于在处理时这些 操作的分组方式,在批处理作业中创建 AssetGroup 和 AssetGroupAsset 资源的 MutateOperation 类型的操作必须 是连续的,中间不能有其他操作。否则,即使稍后在操作列表中添加了满足最低素材资源要求所需的操作,请求也会抛出 AssetGroupError,指明缺少某些素材资源, 即使满足最低素材资源要求所需的操作 稍后包含在操作列表中。

AssetGroupListingGroupFilterOperation 最佳实践

在产品信息组过滤条件的上下文中处理 AssetGroupListingGroupFilter时,我们 建议将以同一 AssetGroup 为目标的 AssetGroupListingGroupFilterOperation 操作连续添加到 批量作业中,以便在批量拆分期间将这组操作视为原子操作 。如需详细了解批处理拆分以及影响产品信息组的其他因素,请参阅 产品信息组批量处理指南。

将变动操作添加到作业

将 第 2 步中的变动操作添加到列表中,然后调用 AddBatchJobOperations ,将变动列表添加到在 第 1 步中创建的批量作业。按照通用批量处理指南中的添加操作步骤 添加变动操作列表。

运行批处理作业

调用 RunBatchJob,允许上传的作业开始运行。如需查看示例,请参阅通用批量处理指南中的 运行批处理作业 步骤。

检索作业的状态

批量作业以长时间运行的操作开始,通常需要一段时间才能完成。启动作业后,使用长时间运行的操作的 GetOperation 方法轮询作业的状态 ,直到作业完成。

当所有批量作业都完成后,调用 ListBatchJobResults,按照 通用批处理指南中的 列出所有批量作业结果步骤 打印其状态和响应。