批量处理提供了一种将一组可能相互依赖的操作分派给多个服务的方法,而无需同步等待操作完成。您可以使用批量处理功能来制作和管理效果最大化广告系列。
本指南介绍了在使用批量处理功能时,适用于效果最大化广告系列的具体详情。通用批量处理指南提供了有关批量处理的一般信息,请求结构指南则详细介绍了如何构建请求以制作或管理效果最大化广告系列。
如需使用批量处理功能制作效果最大化广告系列,请按以下步骤操作:
创建新的批量作业
准备更改操作列表
效果最大化广告系列需要通过操作来创建多个相关资源,详情请参阅请求结构指南。为应包含在批处理作业中的每项资源创建一个 MutateOperation
。
CampaignOperation
和 CampaignAssetOperation
要求
为广告系列启用品牌推广指南(请参阅品牌推广指南)后,您必须使用 CampaignAsset
资源将品牌素材资源与广告系列相关联。此外,在批处理作业中,必须在创建 Campaign
资源本身后立即创建这些 CampaignAsset
资源。如果 CampaignAsset
资源未在 Campaign
资源之后立即创建(启用品牌推广指南时 - 请参阅问题排查),请求将失败并返回 CampaignError
,表示缺少素材资源。在同一操作列表的后面添加 CampaignAsset
创建操作无法防止此错误。
AssetGroupOperation
和 AssetGroupAssetOperation
要求
在批处理作业中创建 AssetGroup
和 AssetGroupAsset
资源的 MutateOperation
类型操作必须是顺序的,中间不得有其他操作,因为这些操作在处理时会组合在一起。否则,请求会抛出 AssetGroupError
来指明缺少某些素材资源,即使操作列表中稍后包含满足最低素材资源要求所需的操作也是如此。
AssetGroupListingGroupFilterOperation
最佳实践
在 AssetGroupListingGroupFilter
上下文中使用商家信息组过滤条件时,我们建议将定位到同一 AssetGroup
的 AssetGroupListingGroupFilterOperation
操作依次添加到批量作业中,以便在批量拆分期间以原子方式处理这组操作。如需详细了解批量拆分和影响商品详情群组的其他因素,请参阅商品详情群组批量处理指南。
将更改操作添加到作业
将第 2 步中的更改操作添加到列表中,然后调用 AddBatchJobOperations
将更改列表添加到第 1 步中创建的批处理作业。按照常规批量处理指南中的添加操作步骤添加更改操作列表。
运行批量作业
调用 RunBatchJob
以允许上传的作业开始运行。如需查看示例,请参阅常规批量处理指南中的运行批处理作业步骤。
检索作业的状态
批量作业会以长时间运行的操作的形式启动,通常需要一些时间才能完成。启动作业后,使用长时间运行的操作的 GetOperation
方法轮询作业的状态,直到作业完成。
当所有批处理作业都完成后,请按照常规批处理指南中的列出所有批处理作业结果步骤调用 ListBatchJobResults
以输出其状态和响应。