Google Ads API 中的广告共享功能将于 2026 年 1 月弃用

2025 年 7 月 9 日，星期三

有何变化？

Google 将弃用 Google Ads API 中的广告共享功能。

随着 v23 于 2026 年 1 月发布，我们将于 2026 年 1 月 28 日从所有受支持的版本中移除制作共享广告的功能。

  • 发生了什么？“共享广告”功能将于 2026 年第 2 季度停用。
  • 有何影响？您原有的共享广告将停止在其“共享”广告组中投放。
  • 解决方案是什么？为确保您的广告继续正常投放，我们会自动为每个广告制作一个新的单独副本。这些新副本将继续作为普通广告投放。
  • 何时？确切日期尚未确定，日后会另行通知。

此项变更将影响大规模制作和管理广告的方式，因此请务必了解其影响并相应地准备好您的系统。我们来详细了解一下具体情况、其重要性以及您需要采取的行动。

什么是广告共享？

简单来说，“广告共享”是指制作一个广告，并在多个广告组中使用该广告。

您无需为每个广告组重复制作相同的广告，只需制作一次，然后将其关联到需要它的所有位置即可。

为何变化？

此项变更与基于素材资源的广告的发展趋势相符。Google Ads 的未来发展方向是基于素材资源的广告格式，例如自适应搜索广告 (RSA) 和效果最大化广告系列。在这些格式中，“广告”是从素材资源池（标题、广告内容描述、图片）中动态组合而成的，因此静态、可共享的广告对象概念效率较低。

如何做准备

虽然时间表为您提供了充足的适应时间，但我们强烈建议您立即开始此流程，以免广告运营受到任何干扰。请按照以下步骤操作，确保顺利过渡。

第 1 步：审核应用

第一步是确定您的应用是否使用广告共享模式。

检查您的代码库，尤其是与 AdGroupAdService 交互的所有逻辑。查找您通过指向已在其他广告组中使用的现有广告的资源名称来创建 AdGroupAd 的所有实例。

从概念上讲，您当前即将弃用的逻辑可能如下所示：

  1. 创建包含 Ad 的 AdGroupAd。
  2. 创建 AdGroup。
  3. 使用第 1 步中嵌入的 Ad 和第 2 步中的 AdGroup 创建另一个 AdGroupAd。（此功能将被移除）。

第 2 步：更新广告制作逻辑

您必须重构代码，为每个广告组创建新的唯一广告。您的新工作流不应共享广告，而应是一个循环，为每个目标广告组制作一个不同的广告。您将无法再制作独立广告。而是在创建 AdGroup 时指定广告参数。

新的合规逻辑应如下所示：

  1. 对于 AdGroup_1：
    • 使用 ad for ad_group_1 创建 AdGroupAd。
  2. 对于 AdGroup_2：
    • 使用 ad for ad_group_2 创建 AdGroupAd。

即使广告文案完全相同，也必须在 API 中将这些广告创建为单独的广告对象。

如果您仍有共享的旧版加大型文字广告 (ETA) 在投放，则必须将其转换为自适应搜索广告，并将每个共享实例分配给单个广告组。

第 3 步：了解对报告的影响

如果您停止共享单个广告，并开始为每个广告组制作专属广告，效果历史记录将会受到影响。

重要提示：效果统计信息（展示次数、点击次数、转化次数）与唯一广告相关联。您制作的新广告最初没有任何效果历史记录。旧的共享广告的历史数据会保留，但不会转移到新广告中。

请务必将此信息传达给您的团队或客户。在切换之前，请计划导出和归档历史效果数据，以便进行长期的广告级分析。

迁移现有共享广告

第 1 步：确定共享广告

首先，您需要一份明确的列表，其中列出当前在多个广告组中共享的所有广告。 

SELECT
  ad_group_ad.ad.id,  -- This is the unique ID of the 'Ad' itself
  ad_group.id,        -- This is the unique ID of the 'AdGroup'
  ad_group_ad.status,
  ad_group_ad.ad.type,
  campaign.id,
  campaign.name,
  ad_group.name
FROM
  ad_group_ad
WHERE
  ad_group_ad.status IN ('ENABLED', 'PAUSED')
ORDER BY
  ad_group_ad.ad.id, ad_group.id

如果您在结果中发现某个 ad_group_ad.ad.id 关联的 ad_group.ids 集合包含多个条目，则表示该特定广告（由 ad_group_ad.ad.id 标识）关联到多个广告组（每个广告组由集合中的唯一 ad_group.id 标识）。

如果任何 ad_group.id 与多个不同的 ad_group.id 相关联，则该广告会被视为“共享”广告。

第 2 步：收集广告内容和关联的广告组

对于您在第 1 步中确定的每个共享广告，您需要检索两项内容：

  1. 广告内容（标题和广告内容描述）。
  2. 当前有效的所有广告组的列表。

第 3 步：在每个广告组中创建一个新的、唯一的 ResponsiveSearchAd

对于迁移的核心部分，请遍历您在第 2 步中确定的每个广告组，并在其中创建一个新的 ResponsiveSearchAd。

最佳实践：如果您的共享广告是加大型文字广告，请不要只复制 3 个标题和 2 条广告内容描述。您可以将这些素材资源作为起点，并添加更多素材资源。ResponsiveSearchAds 的强大功能源自其拥有丰富的标题和广告内容描述，可供 Google 进行测试。建议提供 5 个短标题、1 个长标题和 5 条广告内容描述。

以下是 ResponsiveSearchAds 限制的简要总结：

素材资源类型 允许的最大值 字符数限制 最佳实践
短标题 最多 5 个 30 个字符 提供全部 5 项
长标题 1 90 个字符 始终提供 1
说明 最多 5 个 90 个字符 提供全部 5 个

以下是使用 AdGroupAdService 的 mutate 操作的概念性概述：

  1. 循环遍历第 2 步结果中的每个 ad_group.resource_name。
  2. 在循环内，构造一个新的 AdGroupAd 对象。
  3. 将 ad_group 字段设置为当前 ad_group.resource_name。
  4. 在 AdGroupAd 中创建一个 Ad 对象。
  5. 使用您的素材资源填充 responsive_search_ad 字段：
    • 为标题创建 AdTextAsset 对象列表。
    • 为您的说明创建 AdTextAsset 对象列表。
    • 使用旧广告中的数据设置 final_urls、path1 和 path3。
  6. 执行 MutateAdGroupAds() 请求。

此过程可确保每个广告组现在都有自己独特的 ResponsiveSearchAds，随时可以投放。

第 4 步：移除旧的共享广告

创建新的 ResponsiveSearchAds 并通过编辑审核（status 为 ENABLED）后，就可以停用所有共享广告了。

  1. 确定旧 AdGroupAd（共享广告与广告组之间的关联）的资源名称。
  2. 使用 AdGroupAdService 执行更改。在此服务中，您将构建一个 AdGroupAdOperation。此操作对象有一个 remove 字段，您可以在其中提供要移除的 AdGroupAd 的资源名称。
  3. 最后，对 AdGroupAdService 调用 mutateAdGroupAds 方法。

逐步停用共享广告的时间表

我们强烈建议您自行手动迁移共享广告

  • 这是最佳方法。您可以制作新广告，并使用专门针对每个广告组中的受众群体量身定制的独特图片和标题。相关广告可带来更好的效果。

第 1 阶段：自 2026 年 1 月 28 日起

  • 您无法再制作新的共享广告。
  • 任何将单个广告关联到新广告组的尝试都会被阻止，并返回错误。如果您使用自动化工具或脚本来执行此操作，这些工具或脚本将停止运行。

第 2 阶段：2026 年 1 月 28 日至 2027 年第 1 季度

  • 您现有的共享广告将继续正常投放。
  • 对于已共享的广告，您无需立即采取任何行动；在此期间，这些广告不会受到影响。

第 3 阶段：2027 年第 1 季度

  • 我们会自动转换所有剩余的共享广告。
  • 对于仍处于共享状态的所有广告，我们将在其所属的每个广告组中创建单独的副本。

我们建议您参阅官方 Google Ads API 文档，并密切关注 Google Ads 开发者博客，以便在日期临近时了解更多详情。

立即开始审核，并与您的开发团队分享此帖子，确保您已做好准备，能够顺利完成过渡。

2026 年第 2 季度的自动流程

如果您不采取任何行动，我们将在 2026 年第二季度自动为您拆分共享广告。

我们的自动化流程将按以下方式运作：

  • 一个广告组保留原始广告：您的原始广告将仅保留在其中一个广告组（具体而言，是广告组 ID 最小的那个广告组）中。
  • 其他广告组会获得副本：我们会为共享原始广告的所有其他广告组创建新的副本。
  • 自动生成的内容将重新生成：系统会复制您对“素材资源自动化”等功能的设置。不过，实际由机器生成的素材资源（例如自动制作的标题或图片）不会转移。我们的系统会为每个复制的广告创建一组全新的素材资源，这可能会影响初始效果。

如有任何疑问，请在论坛上与我们联系。

Bob Hancock，Google Ads API 团队

标签： google-ads-api