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

在 v25 及更高版本中，您可以使用 SmartCampaignSettingService.GeneratePMaxDraftCampaign 方法将智能广告系列转换为效果最大化广告系列。此方法在 v24 及更低版本中不可用。

转换的工作原理

当您调用 SmartCampaignSettingService.GeneratePMaxDraftCampaign时， API 会根据请求中提供的智能广告系列的配置生成效果最大化广告系列草稿、预算、素材资源组和素材资源。生成后，您应先检查、修改和优化新资源，然后再启用广告系列来投放广告。

生成的效果最大化广告系列草稿会使用以下状态值进行初始化：

• status 设置为 PAUSED。
• 其投放资格反映在 primary_status 中。
• contains_eu_political_advertising 默认情况下设置为 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING （如果智能广告系列中尚未指定）。如果您的广告系列包含欧盟政治广告，请验证并更新此字段。

这样，您就可以在启用广告系列来投放广告之前，检查、修改和优化生成的效果最大化广告系列、预算、素材资源组和素材资源。

草稿素材资源

新广告系列附带一组占位图片，需要在启用新广告系列之前替换这些图片。当请求中支持 image_enabled 字段并将其设置为 true 时，API 会自动生成图片，而不是使用占位图片。您可以在响应的 assets 字段中检查新素材资源，并按照以下步骤替换它们：

1. 查看素材资源要求指南。
2. 按照上传图片素材资源 示例上传新图片。
3. 按照 将素材资源组关联到素材资源指南，将新素材资源关联到广告系列草稿的素材资源组，然后移除占位图片的 AssetGroupAsset链接（可以在同一 原子突变请求中移除，也可以在关联新素材资源后移除，以确保满足最低素材资源 要求）。

请求参数

The GeneratePMaxDraftCampaignRequest 消息接受 以下字段：

• resource_name（必需）：您要转换的智能广告系列的 SmartCampaignSetting 的资源名称，格式如下：

  customers/customer_id/smartCampaignSettings/campaign_id
  

• validate_only （可选 ）：如果为 true，则系统会验证请求，但不会执行请求。系统仅会在响应的 validated_info `validated_info` 字段中返回验证错误、警告或 可能的转换问题，而不会创建草稿 实体。

• gbp_enabled （不受支持 ）：可选。是否转换与效果最大化广告系列关联的 Google 商家资料 (GBP) 营业地点。请将此字段保留为未设置状态或 false；不支持将其设置为 true，否则会返回 SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED 错误。

• image_enabled （不受支持 ）：可选。 是否生成所需的效果最大化广告系列图片（例如横向、方形和徽标图片类型）。请将此字段保留为未设置状态或 false；不支持将其设置为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. 生成广告系列草稿：调用 SmartCampaignSettingService.GeneratePMaxDraftCampaign ，仅设置必需的 resource_name（将 gbp_enabled 和 image_enabled 保留为未设置状态或设置为 false）。保存返回的 pmax_campaign、 campaign_budget、asset_group 和 assets 资源名称。
2. 审核和自定义广告系列：由于效果最大化 广告系列草稿是使用 status = PAUSED 和 creation_status = INCOMPLETE 创建的，因此请检查并配置其预算、素材资源 组和素材资源。
3. 启用广告系列并暂停原始广告系列：当您准备好投放 广告时，请将效果最大化广告系列的 status 更新为 ENABLED，然后 将原始智能广告系列的 status 更新为 PAUSED，以防止 重复投放。