Google Ads API 將於 2026 年 1 月淘汰廣告共用功能

2025 年 7 月 9 日，星期三

異動內容

Google 將淘汰 Google Ads API 的廣告共用功能。

2026 年 1 月推出第 23 版後，2026 年 1 月 28 日起，所有支援版本將無法建立共用廣告。

  • 異動內容「共用廣告」功能將於 2026 年第 2 季停用。
  • 影響為何？原始共用廣告將停止在「共用」廣告群組中放送。
  • 解決方案是什麼？為確保廣告能繼續放送，系統會自動為每則廣告建立新的個別副本。這些新副本會繼續以一般廣告的形式放送。
  • 何時？確切日期尚未決定，日後會再通知。

這項異動會影響大量建立及管理廣告的方式，因此請務必瞭解相關影響，並據此調整系統。以下將詳細說明情況、重要性，以及您需要採取的行動。

什麼是廣告分享？

簡單來說，「廣告共用」是指建立一則廣告，並在多個廣告群組中使用完全相同的廣告。

您不必為每個廣告群組重複建立相同的廣告，只要建立一次，然後連結到所有需要的地方即可。

異動原因

這項異動是為了配合素材資源廣告的推出。Google Ads 的未來發展將以素材資源廣告格式為核心，例如回應式搜尋廣告和最高成效廣告活動。在這些格式中，「廣告」是從素材資源集區 (廣告標題、說明、圖片) 動態組合而成，因此靜態、可共用的廣告物件概念較不實用。

如何做好準備

您有充裕的時間可以因應，但我們強烈建議您立即開始，以免廣告作業中斷。請按照下列步驟操作，確保順利轉換。

步驟 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 中建立為不同的廣告物件。

如果仍有共用的舊版延展型文字廣告在放送，請務必轉換為回應式搜尋廣告，並將每個共用例項指派給單一廣告群組。

步驟 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 並通過編輯審查 (狀態為 ENABLED) 後，即可停用所有共用廣告。

  1. 找出舊 AdGroupAd (共用廣告與廣告群組之間的連結) 的資源名稱。
  2. 使用 AdGroupAdService 執行異動。在這個服務中，您將建構 AdGroupAdOperation。這個作業物件有一個移除欄位，您可以在其中提供要移除的 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 年第 2 季自動為您分隔共用廣告。

自動化程序的運作方式如下：

  • 一個廣告群組保留原始廣告：原始廣告只會保留在其中一個廣告群組 (具體來說，是廣告群組 ID 最低的群組)。
  • 其他廣告群組會取得副本：系統會為共用原始廣告的所有其他廣告群組建立新的廣告副本。
  • 自動生成內容將重新產生：系統會複製「素材資源自動化」等功能的設定。但實際由機器生成的素材資源 (例如自動建立的廣告標題或圖片) 不會轉移。系統會為每個複製的廣告建立全新組合，這可能會影響初期成效。

如有任何問題，請前往論壇與我們聯絡。

Google Ads API 團隊 Bob Hancock

標籤： google-ads-api