将智能广告系列转换为效果最大化广告系列

在 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_id
    
  • validate_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 时与生成的实体资源名称一起填充)。

如需转换智能广告系列,请使用以下工作流程:

  1. 生成广告系列草稿:仅使用必需的 resource_name 集调用 SmartCampaignSettingService.GeneratePMaxDraftCampaign(将 gbp_enabled 和 image_enabled 保留为未设置状态或设置为 false)。保存返回的 pmax_campaign、campaign_budget、asset_group 和 assets 资源名称。
  2. 查看并自定义广告系列:由于草稿效果最大化广告系列是使用 status = PAUSED 创建的,因此请检查并配置其预算、素材资源组和素材资源。
  3. 启用新广告系列并暂停原广告系列:当您准备好投放广告时,请将效果最大化广告系列的status更新为ENABLED,然后将原智能广告系列的status更新为PAUSED,以防止重复投放。