2026 年 1 月 29 日，星期四
Google Ads API 23 版已於昨日推出，我們很高興能進一步介紹其中一項最受期待的功能：最高成效廣告活動的管道層級報表。
這項更新可讓開發人員和廣告主清楚掌握最高成效廣告的放送位置，進一步最佳化廣告，並取得更精細的成效洞察資料。
管道細目資訊更公開透明
從第 23 版開始，您可以擷取按管道細分的成效資料，例如 Google 搜尋、搜尋夥伴、Gmail、YouTube、多媒體廣告聯播網、探索和地圖。這項功能適用於廣告活動、素材資源群組和素材資源層級，可讓您瞭解特定廣告素材資源在不同環境中的成效。
在舊版 API 中，對最高成效廣告活動使用 ad_network_type 區隔，通常會傳回 MIXED 列舉值。第 23 版推出後，API 將傳回特定管道細目。
開發人員注意事項：這項行為有重大變更。將查詢升級至第 23 版後，您會看到比舊版更詳細的結果。請確保報表系統已準備好處理這些特定列舉值，而非一般 MIXED 結果。
其他可考慮的區隔
雖然管道細目是 v23 的新功能，但可與 v22 推出的強大區隔欄位搭配使用：ad_using_product_data 和 ad_using_video。
ad_using_product_data：使用這個區隔，區分採用 Merchant Center 產品動態饋給的廣告與未採用廣告的成效。ad_using_video：這個區隔可讓您區隔出包含影片元件的廣告曝光成效資料。
只要將這些區隔與新的 v23 管道報表結合，就能取得更精確的洞察資料，例如瞭解影片廣告在 YouTube 頻道和多媒體廣告聯播網上的轉換價值。如果您是零售商，則可使用 ad_using_product_data 區隔，查看搜尋聯播網購物廣告、多媒體廣告聯播網動態再行銷廣告，以及在 YouTube 宣傳產品的影片廣告資料。
實作詳情
如要開始使用這些新報表功能，請將用戶端程式庫更新至 v23。如需詳細的技術說明文件和查詢範例，請參閱最高成效廣告活動報表指南。
重要事項：
- 成效報表只會傳回 2025 年 6 月 1 日當天或之後的管道層級資料。
- 雖然您可以透過 API 取得廣告活動、素材資源群組和素材資源層級的管道報表，但素材資源群組層級報表僅限透過 API 取得，無法在 Google Ads 網頁介面中查看。
如有任何問題或想討論這篇文章，請與 Google Ads API 支援團隊聯絡，或是在 Google 廣告與評估社群 Discord 伺服器上發起討論。