结构请求

本指南详细介绍了制作和更新效果最大化广告系列的请求结构的许多复杂过程。在设计集成时,它可以是一项有用的资源。本指南介绍了转变效果最大化广告系列的请求的处理方式,并且可以作为效果最大化广告系列问题排查指南的配套资源。

制作效果最大化广告系列

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

标准效果最大化广告系列

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

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

在设计制作效果最大化广告系列的请求结构时,有多种不同的选择。有关如何对操作进行分组和设计请求结构的决定在很大程度上取决于您的目标和基础架构。

  • 在创建 AssetGroupAssetGroupAsset 资源之前,请先在单独的请求中创建 CampaignBudgetCampaignAsset 资源。
  • 将所有这些资源添加到单个 mutate 请求中。

虽然您可以在之前的单独请求中成功创建 CampaignBudgetCampaignAsset 资源,但在创建 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 使用效果最大化广告系列时,无效状态和无效请求之间存在重要区别。

无效状态
广告系列因配置方式不当而无法投放。例如,您可以创建 advertising_channel_typePERFORMANCE_MAX 的独立 Campaign 资源。虽然制作广告系列的请求会成功,但您必须向广告系列添加至少一个 AssetGroup,才能投放广告系列。如果您的请求成功,但您的广告系列或素材资源组未投放,您可以使用 CampaignPrimaryStatusCampaignPrimaryStatusReasonAssetGroupPrimaryStatusAssetGroupPrimaryStatusReason 确定原因,详情请参阅问题排查指南
请求无效
不会成功的请求,因为它会使广告系列或资源处于无效状态。例如,如果您试图为非零售广告系列创建 AssetGroup,但未添加所需的最少量素材资源,Google Ads API 就会抛出错误。因此,您必须在同一请求中包含 AssetGroup 及其 AssetGroupAsset 资源。这也意味着,您的所有 AssetGroupAsset 资源都必须符合给定 field_type 的正确规范,以防止整个请求失败。

使用 mutate 请求对操作进行分组

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

除非您成功创建本指南中提到的所有必需资源,否则您的广告系列无法投放。发出单独的请求时,请在后续请求中使用所引用资源的实际资源名称。发出包含多个操作的批量 mutate 请求时,请使用由使用临时 ID 构成的资源名称。

操作顺序

无论您是否使用批量 mutate 请求制作效果最大化广告系列,都必须对您的请求和操作进行排序,以免在创建资源之前引用该资源。对于批量更改请求,这意味着对操作进行排序时,所引用的资源列在引用它们的资源之前。

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

图片

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

更新素材资源组

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

对于在制作零售广告系列中没有关联任何素材资源的素材资源组,这一点尤为重要。只有满足所有资源要求的后续请求才会通过创建 AssetGroupAsset 资源向 AssetGroup 添加资源。换言之,您无法逐步向这些素材资源组添加素材资源。