在 v25(从 v25.2开始),您可以使用 SmartCampaignSettingService.GeneratePMaxDraftCampaign 方法将智能广告系列转换为效果最大化广告系列。此方法在 v24 及更低版本中不可用。
转换的运作方式
当您调用 SmartCampaignSettingService.GeneratePMaxDraftCampaign 时,API 会根据智能广告系列的配置生成效果最大化广告系列草稿。
生成的效果最大化广告系列草稿的 status 会初始化为 PAUSED(其投放资格也会反映在 primary_status 中)。如果所有功能转换器都未能通过智能广告系列的验证,则请求会失败并显示 SmartCampaignError.GENERATE_PMAX_CONVERTERS_FAIL 错误。
这样,您就可以在启用广告系列以投放广告之前,检查、修改和改进生成的效果最大化广告系列、预算、素材资源组和素材资源。生成效果最大化广告系列草稿不会修改或暂停原智能广告系列,后者会一直处于有效状态,直到您手动将其暂停。
请求参数
GeneratePMaxDraftCampaignRequest 消息接受以下字段:
resource_name(必需):要转换的智能广告系列的SmartCampaignSetting的资源名称,格式如下:customers/customer_id/smartCampaignSettings/campaign_idvalidate_only(可选):如果为true,则系统会验证请求,但不会执行请求。只有验证错误、警告或可能的转化问题才会返回到响应的validated_info字段中,而不会创建草稿实体。gbp_enabled(不支持):可选。是否转换与效果最大化广告系列相关联的 Google 商家资料 (GBP) 营业地点。将此字段留空或设置为false;在v25中,将此字段设置为true尚未实现,并且会返回SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED错误。image_enabled(不支持):可选。 是否生成必需的效果最大化广告系列图片(例如横向、方形和徽标图片类型)。将此字段留空或设置为false;v25中未实现将其设置为true,并且会返回SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED错误。
回答详情
GeneratePMaxDraftCampaignResponse 消息会返回生成的效果最大化广告系列草稿及其关联实体的资源名称:
pmax_campaign:生成的草稿效果最大化广告系列的Campaign资源名称。campaign_budget:与生成的效果最大化广告系列相关联的CampaignBudget资源名称。asset_group:与生成的效果最大化广告系列相关联的AssetGroup资源名称。assets:与生成的效果最大化广告系列相关联的Asset资源名称列表。validated_info:转化检查返回的验证信息或可能的转化问题(当validate_only设置为true时填充,当validate_only为false时与生成的实体资源名称一起填充)。
推荐的工作流程
如需转换智能广告系列,请使用以下工作流程:
- 生成广告系列草稿:仅使用必需的
resource_name集调用SmartCampaignSettingService.GeneratePMaxDraftCampaign(将gbp_enabled和image_enabled保留为未设置状态或设置为false)。保存返回的pmax_campaign、campaign_budget、asset_group和assets资源名称。 - 查看并自定义广告系列:由于草稿效果最大化广告系列是使用
status = PAUSED创建的,因此请检查并配置其预算、素材资源组和素材资源。 - 启用新广告系列并暂停原广告系列:当您准备好投放广告时,请将效果最大化广告系列的
status更新为ENABLED,然后将原智能广告系列的status更新为PAUSED,以防止重复投放。