结构请求

本指南详细介绍了构建用于制作和更新效果最大化广告系列的请求的许多复杂性。在设计集成时,该文档可用作实用资源。本指南介绍了如何处理会更改效果最大化广告系列的请求,可作为效果最大化广告系列问题排查指南效果最大化广告系列批量处理指南的补充资源。

制作效果最大化广告系列

在 Google Ads API 中,效果最大化广告系列实体表示为多个唯一资源的组合。

标准效果最大化广告系列

标准效果最大化广告系列需要至少包含一组资源才能投放。

对于启用了品牌推广指南的广告系列,创建 Campaign 的操作和所需的 CampaignAsset 资源必须包含在单个请求中,并且 CampaignAsset 资源必须满足最低素材资源要求和规范。

请务必注意,创建 AssetGroupAssetGroupAsset 实体的操作必须包含在单个请求中,并且 AssetGroupAsset 资源必须组合起来才能满足所有最低素材资源要求和规范;请参阅零售广告系列中这方面的不同之处。如果创建 AssetGroup 的请求不包含所有必需的 AssetGroupAsset 实体,则会导致错误;如需了解更多背景信息,请参阅无效状态与无效请求

在构建用于制作效果最大化广告系列的请求时,您可以选择不同的方法。如何对操作进行分组和构建请求的结构,在很大程度上取决于您的目标和基础架构。

  • 请先在单独的请求中创建 CampaignBudgetCampaignAssetCampaignAsset 资源,然后再创建 AssetGroupAssetGroupAsset 资源。(对于启用了品牌推广指南的广告系列,必须在单个请求中同时包含 Campaign 和所需的 CampaignAsset 资源)
  • 在单个更改请求中包含所有这些资源。

虽然您可以在之前的单独请求中成功创建 CampaignBudgetCampaignAssetCampaignAsset 资源,但只有在 AssetGroupAssetGroupAsset 资源也创建完毕后,效果最大化广告系列才有资格投放。

有效投放效果最大化广告系列的最低要求

图片

您可以创建其他素材资源(如图所示),进一步对效果最大化广告系列进行自定义。

您可以在创建 AssetGroupAssetGroupAsset 资源的同一请求中添加用于创建 AssetGroupSignal 资源的操作。或者,您也可以在创建 AssetGroup 后在单独的请求中创建 AssetGroupSignal 实体。

包含更多选项的效果最大化广告系列

图片

零售专用效果最大化广告系列

购物广告系列的独特之处在于,您可以通过两种不同的方式创建素材资源组,从而制作可正常投放的广告系列:

  • 没有任何素材资源的素材资源组
  • 包含所有必需素材资源的素材资源组(首选)

当您选择从素材资源组中排除素材资源时,Google 会自动使用您关联的 Merchant Center 账号中提供的素材资源来制作广告。不过,我们建议您提供可覆盖所有广告资源的素材资源。 零售业效果最大化广告系列至少需要具备以下资源才能投放。

  • CampaignBudget
  • Campaign(已填充 ShoppingSettings
  • AssetGroup
  • AssetGroupListingGroupFilter

请务必注意,零售广告系列中必须填充 Campaign.shopping_settings 字段。此外,每个 AssetGroup 中列出的 final_urls 必须与 Campaign.shopping_settings 中指定的 Merchant Center 账号 ID 关联的网址一致。最后,每个 AssetGroup 都必须有一个由一个或多个 AssetGroupListingGroupFilter 资源组成的关联有效商品详情群组树。您至少必须创建一个节点树,以涵盖指定 Merchant Center Feed 中的所有商品。

您可以单独创建这些资源,也可以在单个请求中创建。不过,在所有这些资源都正确创建后,广告系列才可以投放。

有效投放零售效果最大化广告系列的最低要求

图片

零售广告系列可以使用标准效果最大化广告系列提供的所有选项,包括创建素材资源组信号、广告系列转化目标和广告系列条件。如果您在创建 AssetGroup 资源时选择向 AssetGroup 添加资产,则 AssetGroup 必须满足最低资产要求。换句话说,您可以不添加任何资源,也可以添加所有必需的资源。

包含更多选项的零售专用效果最大化广告系列

图片

无效状态与无效请求

在 Google Ads API 中处理效果最大化广告系列时,无效状态与无效请求之间存在重要区别。

无效的州/省
由于配置方式,广告系列不符合投放条件。例如,您可以创建一个 Campaign 独立资源,其 advertising_channel_typePERFORMANCE_MAX。虽然创建广告系列的请求会成功,但在您向广告系列添加至少一个 AssetGroup 之前,该广告系列将不符合投放条件。如果您的请求成功,但您的广告系列或素材资源组未投放,您可以使用 CampaignPrimaryStatusCampaignPrimaryStatusReasonAssetGroupPrimaryStatusAssetGroupPrimaryStatusReason 来确定原因,如问题排查指南中所详述。
请求无效
请求无法成功,因为它会将广告系列或资源置于无效状态。例如,如果您尝试为非零售广告系列创建 AssetGroup,但未添加最低必需的素材资源,Google Ads API 会抛出错误。因此,您必须在同一请求中包含 AssetGroup 及其 AssetGroupAsset 资源。这也意味着,您的所有 AssetGroupAsset 资源都必须符合给定 field_type 的正确规范,以免整个请求失败。

使用更改请求对操作进行分组

效果最大化广告系列由多个资源组成,您可以选择在单独的请求中或在单个批量更改请求中创建这些单独的资源。不过,如前所述,标准效果最大化广告系列中的 AssetGroups 和关联的 AssetGroupAssets 必须在单个原子请求中创建。

在您成功创建本指南中提及的所有必需资源之前,您的广告系列不符合投放条件。发出单独的请求时,请在后续请求中使用引用资源的实际资源名称。发出包含多个操作的批量更改请求时,请使用使用临时 ID 构成的资源名称。

操作顺序

无论您是使用批量更改请求还是使用其他请求来制作效果最大化广告系列,都必须对请求和操作进行排序,以确保您绝不会在资源创建之前引用该资源。对于批量更改请求,这意味着应按如下方式对操作进行排序,即将被引用的资源列在引用它们的资源之前。

如果您选择在创建 AssetGroup 及其 AssetGroupAsset 资源的同一批量更改请求中创建资产资源,则所有 AssetOperations 都应位于所有 AssetGroupAssetOperations 之前,如图所示。

图片

Google Ads 服务器会将连续的 AssetGroupAssetOperations 批量处理,并在该组中的最后一次操作之后评估 AssetGroup 是否符合最低素材资源要求。如果您在请求中交替使用 AssetOperationsAssetGroupAssetOperations,API 服务器将在第一个 AssetGroupAssetOperation 之后评估最低资产要求,并返回错误,而不会继续执行请求中的其余操作。因此,请求中的任何素材资源都不会添加到您的 Google Ads 账号中。此外,系统不会创建 AssetGroup 或任何关联的 AssetGroupAsset 资源。

更新素材资源组

创建有效的 AssetGroup 后,您无法发出会导致状态无效(不再满足最低资源要求)的后续请求。任何此类请求都会抛出错误。例如,如果您创建的 AssetGroup 只有一个 MARKETING_IMAGE(最低要求),则任何移除与该 MARKETING_IMAGE 关联的 AssetGroupAsset 的请求都会返回错误。

对于在创建时没有任何关联素材资源的零售广告系列中的素材资源组,这一点尤为重要。之后通过创建 AssetGroupAsset 资源向 AssetGroup 添加素材资源的请求只有在满足所有素材资源要求的情况下才能成功。也就是说,您无法逐步向这些素材资源组添加素材资源。