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

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

本指南详细介绍了使用批处理时效果最大化广告系列特有的细节。通用批处理指南提供了有关批处理的一般信息,结构化请求指南包含有关构建请求以创建或管理效果最大化广告系列的详细信息。

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

创建新的批量作业

按照常规批处理作业创建步骤创建 BatchJob 资源。

准备一个 mutate 操作列表

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

CampaignOperation 和 CampaignAssetOperation 要求

为广告系列启用品牌规范(请参阅品牌规范)后,您必须使用 CampaignAsset 资源将品牌资产与广告系列相关联。此外,在批量作业中,必须在创建 Campaign 资源本身后立即创建这些 CampaignAsset 资源。如果 CampaignAsset 资源未在 Campaign 资源之后立即创建(启用品牌规范时 - 请参阅问题排查),请求将失败并返回 CampaignError,表示缺少素材资源。即使在同一操作列表的后面包含 CampaignAsset 创建操作,也无法避免此错误。

AssetGroupOperation 和 AssetGroupAssetOperation 要求

在批量作业中创建 AssetGroup 和 AssetGroupAsset 资源的 MutateOperation 类型操作必须按顺序执行,中间不能有其他操作,因为这些操作在处理时会分组在一起。否则,请求会抛出 AssetGroupError,指示缺少某些素材资源,即使满足最低素材资源要求所需的操作稍后包含在操作列表中也是如此。

AssetGroupListingGroupFilterOperation 最佳实践

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

将 mutate 操作添加到作业

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

运行批量作业

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

检索作业的状态

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

当所有批量作业完成后,请按照常规批处理指南中的列出所有批量作业结果步骤,调用 ListBatchJobResults 来输出其状态和响应。