本頁面說明 Google 發布商廣告代碼 (GPT) 程式庫的正式版更新。您可以定期查看本頁的公告,瞭解新版或全新功能、修正的錯誤、已知問題和淘汰的功能。
如要接收更新資訊,請將本頁的網址新增至您所選擇的動態消息閱讀器,或是使用版本資訊動態消息的直接連結,可用的格式有:Atom 1.0 或 RSS 2.0
。
關於發布日期
所有 GPT 程式庫的變更都會經過全面測試,才會發布。此外,我們也會逐步向使用者推出版本,進一步防範非預期的回歸。如果在發布期間發現任何回歸問題,您可以在全面發布前快速放棄整個版本。
因此,發布日期並非確切日期,發布作業可能需要幾天到幾週的時間才能完成。也就是說,使用者會在不同時間看到變更。這些版本資訊中提供的日期,代表變更完成並向所有使用者推出的當週開始。
2025 年 10 月 6 日當週
2025 年 7 月 28 日當週
許多現有的網頁和廣告空間層級設定已遷移至新的統一 GPT 設定 API。這項遷移作業帶來多項改善:
- 改善探索體驗:設定會分組顯示在說明文件和型別定義中。
- 更直覺:您可以使用單一介面,個別或一次設定所有設定。
- 更清楚的錯誤訊息:設定錯誤訊息會提供更多詳細資料,並使用標準化語言簡化疑難排解程序。
舊版設定方法仍可運作,但會更新為在內部使用新的設定架構。因此,即使使用舊版方法,您也可能會看到參照新設定 API 屬性的錯誤訊息。
SafeFrameConfig 物件已從 googletag 命名空間移至 googletag.config 命名空間。
下表列出已淘汰的舊版設定方法,以及建議使用的設定 API 替代方案。
| 舊版設定方法 | 取代 GPT 設定 API |
|---|---|
PubAdsService.set() |
PageSettingsConfig.adsenseAttributes
|
PubAdsService.clearCategoryExclusions()PubAdsService.setCategoryExclusion()
|
PageSettingsConfig.categoryExclusion
|
PubAdsService.setCentering() |
PageSettingsConfig.centering
|
PubAdsService.collapseEmptyDivs() |
PageSettingsConfig.collapseDiv
|
PubAdsService.disableInitialLoad() |
PageSettingsConfig.disableInitialLoad
|
PubAdsService.enableLazyLoad() |
PageSettingsConfig.lazyLoad
|
PubAdsService.setLocation() |
PageSettingsConfig.location
|
PubAdsService.setForceSafeFrame()PubAdsService.setSafeFrameConfig()
|
PageSettingsConfig.safeFrame
|
PubAdsService.enableSingleRequest() |
PageSettingsConfig.singleRequest
|
PubAdsService.clearTargeting()PubAdsService.setTargeting()
|
PageSettingsConfig.targeting
|
PubAdsService.enableVideoAds()PubAdsService.setVideoContent()
|
PageSettingsConfig.videoAds
|
PubAdsService.isInitialLoadDisabled()PubAdsService.get()PubAdsService.getAttributeKeys()PubAdsService.getTargeting()PubAdsService.getTargetingKeys()
|
googletag.getConfig()
|
Slot.set() |
SlotSettingsConfig.adsenseAttributes
|
Slot.clearCategoryExclusions()Slot.setCategoryExclusion()
|
SlotSettingsConfig.categoryExclusion
|
Slot.setClickUrl() |
SlotSettingsConfig.clickUrl
|
Slot.setCollapseEmptyDiv() |
SlotSettingsConfig.collapseDiv
|
Slot.setForceSafeFrame()Slot.setSafeFrameConfig()
|
SlotSettingsConfig.safeFrame
|
Slot.clearTargeting()Slot.setTargeting()Slot.updateTargetingFromMap()
|
SlotSettingsConfig.targeting
|
Slot.get()Slot.getAttributeKeys()Slot.getCategoryExclusions()Slot.getTargeting()Slot.getTargetingKeys()
|
Slot.getConfig()
|
2025 年 7 月 21 日當週
threadYield 功能已更新,現在系統也會在產生廣告請求網址前,先產生 JS 執行緒,適用於只包含首頁下方廣告空間的要求。研究顯示,這項做法可有效提升網站體驗核心指標,且不會對曝光次數造成負面影響。
| 已在 GPT 中更新 | |
|---|---|
| 屬性 |
googletag.config.PageSettingsConfig.threadYield
|
2025 年 6 月 2 日當週
網站插頁式廣告現已全面支援單頁應用程式 (SPA)
GPT 使用者現在可以在支援 SPA 的網站中,流暢顯示網站插頁式廣告,無須重新載入整個網頁。這項改良項目可以:
- 提升使用者體驗:在 SPA 的自然中斷點放送廣告,確保轉換流程順暢,減少干擾。
- 提高營利成效:在動態 SPA 導向內容中有效放送插頁式廣告,發掘新的收益商機。
- 維持廣告體驗提升標準:持續提供優質廣告體驗,提供明確的退出選項和可設定的展示頻率上限,並遵守業界最佳做法。
您不需要對現有 SPA 導入方式做任何變更。GPT 會自動偵測 SPA 中的頁面變更,並管理插頁式廣告的顯示情形。如要進一步瞭解如何導入 GPT 管理的網站插頁式廣告和選用插頁式廣告觸發條件,請參閱「 顯示網站插頁式廣告 」範例。
2025 年 5 月 26 日當週
插頁式 H5 遊戲廣告的展示頻率上限已從 120 秒調降為 30 秒。
2025 年 4 月 28 日當週
| GPT 最新消息 | |
|---|---|
| 屬性 |
SlotRenderEndedEvent.responseIdentifier
|
2025 年 1 月 27 日當週
為配合
Protected Audience API
規格,下列
ComponentAuctionConfig.auctionConfig屬性已重新命名。
| 舊房源名稱 | 新資源名稱 |
|---|---|
decisionLogicUrl |
decisionLogicURL |
trustedScoringSignalsUrl |
trustedScoringSignalsURL |
2024 年 10 月 21 日當週
修改 threadYield,盡可能使用 Scheduler.yield 而非 Scheduler.postTask。詳情請參閱收益說明文件。
| 已在 GPT 中更新 | |
|---|---|
| 屬性 |
googletag.config.PageSettingsConfig.threadYield
|
2024 年 9 月 2 日當週
新增支援插頁式遊戲廣告。
2024 年 8 月 19 日當週
控制 GPT 執行緒收益行為的設定已從 adYield 重新命名為 threadYield,以明確指出這項功能著重於產生 JS 執行緒,而非最佳化廣告收益。這項功能及其相關聯 API (名稱除外) 的行為維持不變。adYield 屬性將在日後推出的 GPT 版本中移除。
您可以使用 googletag.setConfig({threadYield: 'DISABLED'}); 停用預設的執行緒產生行為,也可以使用 googletag.setConfig({threadYield: 'ENABLED_ALL_SLOTS'}); 將該行為套用至所有版位,無論版位相對於檢視區塊的位置為何。
| 已在 GPT 中更新 | |
|---|---|
| 屬性 |
googletag.config.PageSettingsConfig.threadYield
|
2024 年 7 月 29 日當週
GPT 現在會使用 Scheduler.postTask (如適用) 產生 JS 執行緒,並在算繪素材前將優先順序設為「user-blocking」。研究顯示,這項做法對曝光次數的影響極小,但可大幅提升網站體驗核心指標。根據預設,只有在廣告空間位於可視區域外時,GPT 才會產生廣告。
您可以使用 googletag.setConfig({adYield: 'DISABLED'}); 停用預設行為,或使用 googletag.setConfig({adYield: 'ENABLED_ALL_SLOTS'}); 將預設行為套用至所有版位,不論版位相對於檢視區塊的位置為何。
| GPT 最新消息 | |
|---|---|
| 屬性 |
googletag.config.PageSettingsConfig.adYield
|
2024 年 2 月 12 日當週
新增支援功能,可設定 發布商提供的信號 (PPS)。
修正 SlotRenderEndedEvent.slotContentChanged 一律為 true 的錯誤。日後,只有在廣告空間的內容變更時,這個屬性才會是 true,否則為 false (例如廣告未填滿空間)。
2024 年 1 月 29 日當週
廣告請求的聯播網失敗會模擬沒有廣告可供應的情況,方法是觸發 googletag.events.SlotRenderEndedEvent,並將 isEmpty 設為 true。如需監聽這項事件的範例,請參閱廣告事件監聽器。變更包括在使用 collapseEmptyDivs 時自動摺疊插槽。
新增支援功能,可在電腦/平板電腦和行動版網站 (部分畫面) 上設定廣告展開功能。
| GPT 最新消息 | |
|---|---|
| 物件 |
googletag.config.AdExpansionConfig |
| 屬性 |
googletag.config.AdExpansionConfig.enabledgoogletag.config.PageSettingsConfig.adExpansiongoogletag.config.SlotSettingsConfig.adExpansion
|
2023 年 12 月 11 日當週
開始支援 側邊欄錨定廣告。
| GPT 最新消息 | |
|---|---|
| 列舉 |
OutOfPageFormat.LEFT_SIDE_RAILOutOfPageFormat.RIGHT_SIDE_RAIL
|
2023 年 11 月 13 日當週
開始支援設定發布商隱私權處理方式。
新增對 Chrome 預先算繪的支援。 如果 GPT 偵測到網頁處於預先算繪狀態,系統會延遲發出廣告請求,直到使用者看到網頁為止。
2023 年 10 月 23 日當週
新增對選用網站插頁式廣告觸發條件的支援。
| GPT 最新消息 | |
|---|---|
| 物件 |
googletag.config.InterstitialConfig
|
| 屬性 |
googletag.config.SlotSettingsConfig.interstitial
|
| 類型 |
googletag.config.InterstitialTrigger
|
2023 年 7 月 24 日當週
Protected Audience API (舊稱 FLEDGE) 將於 7 月發布 Chrome 時正式推出。因此,GPT 中與元件競價相關的功能現在可視為穩定。
| 已從實驗版改為穩定版 | |
|---|---|
| 物件 |
googletag.config.ComponentAuctionConfig
|
| 屬性 |
googletag.config.SlotSettingsConfig.componentAuction
|
2023 年 6 月 19 日當週
更新:自 2023 年 7 月 5 日起,GPT 將不再提供舊版 JavaScript 程式庫,也不會向這些版本放送廣告。詳情請參閱先前的公告。
從 www.googletagservices.com/tag/js/gpt.js 放送廣告的發布商可以繼續這麼做。不過,我們建議改用偏好的網域,因為這樣可能可以提升效能,而且未來可能會停止在 www.googletagservices.com 放送 gpt.js。
2023 年 6 月 6 日當週
自 2023 年 7 月 5 日起,GPT 將不再放送舊版 JavaScript 程式庫。如果發布商是從官方網址載入 GPT,則不會受到影響。如果發布商放送的是 gpt.js、pubads_impl.js 或任何載入程式庫的快取版本,就必須更新網頁,改用官方網址。詳情請參閱「開始使用」指南。
2023 年 5 月 22 日當週
系統現在會自動移除提供給 googletag.defineSlot() 和 SizeMappingBuilder.addSize() 的負值和零大小值,因為這些值無效。因此,如果現有整合功能提供這類無效值,發布商控制台訊息可能會增加。不過,這不會影響現有的有效廣告請求。
2023 年 5 月 18 日當週
GPT 現在會在執行時提早安裝安全信號競價工具指令碼。這有助於提升廣告請求的信號涵蓋率。
2023 年 5 月 1 日當週
修正錯誤:重新整理多尺寸錨定位置時,廣告素材可能會遭到截斷。
2023 年 3 月 27 日當週
如果瀏覽器不支援 Intersection Observer API,GPT 將無法在該瀏覽器上提供以可視度為準的功能。請注意,所有支援的瀏覽器都原生支援這項 API。
| 方法或事件 | |
|---|---|
googletag.events.ImpressionViewableEvent
|
|
googletag.events.SlotVisibilityChangedEvent
|
|
googletag.pubads().enableLazyLoad()
|
|
2023 年 2 月 6 日當週
新增共用安全信號的支援功能。
| GPT 最新消息 | |
|---|---|
| 物件 |
BidderSignalProviderPublisherSignalProviderSecureSignalProvidersArray
|
| 類型 |
SecureSignalProvider
|
| 變數 |
googletag.secureSignalProviders
|
2023 年 1 月 30 日當週
Service.addEventListener() 的行為已變更,因此發生事件時,系統會先執行所有相關聯的接聽程式,再處理後續事件。在此變更前,相同廣告空間的廣告空間算繪開始和結束事件監聽器可能會依序執行。
2022 年 8 月 15 日當週
Service.removeEventListener() 的傳回型別已從 boolean 變更為 void。
2022 年 7 月 25 日當週
新增對 FLEDGE 元件競價的實驗支援,以便提早測試多個賣方參與的 FLEDGE 競價。
| GPT 最新消息 | |
|---|---|
| 方法 |
Slot.setConfig()
|
| 物件 |
ComponentAuctionConfigSlotSettingsConfig
|
2022 年 7 月 18 日當週
ContentService API 已淘汰。呼叫 googletag.content().setContent 現在只會記錄警告,不會產生其他影響。googletag.content 屬性很快就會完全移除,之後嘗試呼叫該屬性會擲回例外狀況。請改用瀏覽器內建的 DOM API 直接將內容新增到 div 元素中。
2022 年 5 月 23 日當週
新增支援設定廣告請求流量來源。
| 支援流量來源的 GPT | |
|---|---|
| 列舉 |
TrafficSource.ORGANICTrafficSource.PURCHASED
|
| 屬性 | PrivacySettingsConfig.trafficSource |
2022 年 3 月 7 日當週
網站獎勵廣告已推出。詳情請參閱 Ad Manager 說明中心。
| 網站獎勵廣告的 GPT 支援 | |
|---|---|
| 列舉 | OutOfPageFormat.REWARDED |
| 事件 | RewardedSlotClosedEvent |
| 事件 | RewardedSlotGrantedEvent |
| 事件 | RewardedSlotReadyEvent |
| 物件 | RewardedPayload |
2022 年 2 月 28 日當週
CommandArray.push 現在會將提供的函式明確繫結至 globalThis,而不是自己的 arguments 物件。
2021 年 12 月 8 日當週
列舉現在也會公開值到鍵的反向對應,以符合 TypeScript 列舉的行為。接受列舉值的 API 不會變更,且不應使用這些新的反向對應。
2021 年 8 月 9 日當週
新增 removeEventListener 方法。
現在,使用相同的 eventType 和回呼函式例項多次呼叫 addEventListener 會變成無運算。換句話說,如果針對相同的事件類型註冊單一回呼函式例項 n 次,事件發生時只會執行一次,而不是 n 次。
2021 年 7 月 29 日當週
GPT 的可視度事件:ImpressionViewableEvent
和 SlotVisibilityChangedEvent
現在會在長時間的網頁工作階段中持續觸發。先前,這些廣告會在網頁載入後一小時關閉。
2021 年 5 月 3 日當週
GPT 不會再於擷取廣告前為廣告空間設定版位。這項變更可減少網站上的累計版面配置位移 (CLS),但前提是網站未使用 CSS 保留空間。如要進一步減少網站的 CLS,建議使用 CSS 為廣告預留非零區域。瞭解詳情
2021 年 3 月 22 日當週
更新 enableLazyLoad() 的行為,延遲顯示背景分頁的首頁下方廣告空間。
2021 年 2 月 23 日當週
現在可以在 display 或 refresh 之前隨時呼叫 googletag.pubads().set 和 Slot.set 方法。先前 set 僅適用於在 googletag.enableServices 之前呼叫的情況。
2021 年 2 月 16 日當週
現在隨時可以呼叫 googletag.pubads().setPublisherProvidedId API。先前只有在 googletag.enableServices 之前呼叫時,這項功能才會運作。
2021 年 1 月 4 日當週
現在可以重複呼叫 googletag.pubads().collapseEmptyDivs API 來變更設定。先前重複的呼叫會遭到忽略。
2020 年 10 月 12 日當週
推出網站插頁式廣告公開測試版,詳情請參閱說明中心。
2020 年 8 月 31 日當週
淘汰了 definePassback() 和 defineOutOfPagePassback()。如要瞭解如何正確建立回傳,請參閱回傳說明文件。
2020 年 6 月 15 日當週
更新 enableLazyLoad() 的行為,使其與 collapseEmptyDivs(true) 相容。
2020 年 5 月 25 日當週
GPT 將不再支援發布商設定的精確 GPS 位置。具體來說,googletag.pubads().setLocation() 不再支援緯度、經度或半徑參數,而是會採用任意格式的地址。
2020 年 4 月 27 日當週
GPT 顯示邏輯不再模組化為個別檔案。這表示 GPT 在執行時擷取的檔案會減少,因此延遲時間會稍微縮短,但不會對使用者頻寬造成影響。
在 GPT 中觸發請求時 (呼叫 googletag.display() 或 googletag.pubads().refresh()),我們會凍結所有發布商提供的狀態,確保請求傳送前不會發生變化。因此,要求觸發時,系統只會使用該時間點之前新增的狀態。之後修改的任何狀態只會套用至後續要求。
2019 年 11 月 11 日當週
現在有一個新的建議程式碼片段,可用於建立 GPT 回傳式曝光。我們不建議使用 definePassback() 和 defineOutOfPagePassback(),因為這些函式會同步運作,而且可能遭到某些瀏覽器封鎖。瞭解詳情。
已新增 PubAdsService.setPrivacySettings(),做為啟用隱私權設定的新方法,日後這裡會提供其他設定。
2019 年 3 月 25 日當週
現在呼叫 googletag.enableServices() 後,Pubads 服務會立即全面運作,而不是以非同步方式初始化。也就是說,呼叫 googletag.enableServices() 後,googletag.pubadsReady 現在保證為 true。不再需要輪詢來檢查 googletag.pubadsReady 的值。
2019 年 2 月 4 日當週
更新 enableLazyLoad() 的行為,允許在呼叫 enableServices() 後變更延遲載入設定,並在顯示每個廣告空間時凍結該廣告空間的延遲載入設定。
2019 年 1 月 21 日當週
新增支援的事件 SlotResponseReceived,會在接收到插槽的廣告回應時觸發。
在 googleTag.ResponseInformation 中新增了 creativeTemplateId 欄位。
2019 年 1 月 14 日當週
新增支援的事件 SlotRequestedEvent,會在為廣告空間提出廣告請求時觸發。
2018 年 8 月 27 日當週
修改 googletag.display(),以接受 googletag.Slot 做為引數。
2018 年 8 月 6 日當週
在 GPT 中新增 googletag.PubAdsService.enableLazyLoad(),延遲載入廣告。
2018 年 6 月 18 日當週
修正導致 googletag.events.SlotOnloadEvent 無法觸發的錯誤。
2018 年 4 月 30 日當週
新增 googletag.PubAdsService.setTagForUnderAgeOfConsent(),用於控管向未滿規定年齡使用者放送的廣告;新增 googletag.PassbackSlot.setTagForUnderAgeOfConsent(),用於將回傳廣告空間標示為來自未滿規定年齡的使用者。
2018 年 4 月 23 日當週
新增 googletag.PubAdsService.setRequestNonPersonalizedAds(),可控管廣告個人化設定。
2018 年 3 月 12 日當週
如果內容並非由 GPT 放置,則在重新整理前,系統不會移除該內容。內容將清除。
2018 年 2 月 19 日當週
使用非同步顯示模式時:盡可能使用 XMLHttpRequest 和 HTTP GET 方法請求所有廣告,但不得超過 8,192 個字元的限制。先前,如果廣告請求超過 4,096 個字元,但未達 8,192 個字元的上限,就會使用 HTTP POST 方法。
如果內容並非由 GPT 放置,則在重新整理前,系統不會再移除插槽內的現有內容。 這則附註有誤,請參閱 2018 年 3 月 12 日當週的項目。
2018 年 1 月 8 日當週
在多大小陣列中,支援 [..., ['fluid'], ...] 的替代語法 (NamedSized)。先前只有 [..., 'fluid', ...] 會被視為有效。
2017 年 7 月 10 日當週
從 googleTag.ResponseInformation 移除 labelIds 欄位。
2017 年 6 月 5 日當週
修改 googletag.display() 和 googletag.pubads().display,以接受 div 元素和 div ID。這樣一來,您就能在 shadow DOM 中的 div 內轉譯插槽。
2017 年 2 月 27 日當週
2016 年 11 月 7 日當週
發布 Service 的 getSlots() API,可擷取與服務相關聯的時段清單。
2016 年 10 月 17 日當週
修改 Slot.clearTargeting() 和 PubAdsService.clearTargeting(),以採用選用的金鑰參數。
2016 年 9 月 5 日當週
googletag.cmd.push() 中擷取的錯誤不再會隱藏,而是會列印到控制台。
2016 年 8 月 8 日當週
發布 SlotOnloadEvent API,允許監聽廣告素材是否已完成載入。
2016 年 7 月 25 日當週
在 PubAdsService 上發布 getTargeting() 和 getTargetingKeys() API,用於擷取自訂服務層級指定目標參數。
2016 年 6 月 20 日當週
發布 openConsole() API,可開啟 Google 發布商控制台,不必重新整理頁面。
2016 年 6 月 6 日當週
發布 getTargeting() 和 getTargetingKeys() API,用於擷取自訂指定目標參數。
新增設定選項,讓 SafeFrame 允許透過推送內容展開:allowPushExpansion。
2016 年 5 月 16 日當週
支援多重大小廣告請求中的自動調整大小。
2016 年 4 月 18 日當週
發布 getResponseInformation API,可傳回廣告空間的廣告回應資訊。
發布 setAdIframeTitle API,可將輸入內容設為之後建立的任何廣告容器 iframe 的標題。
2016 年 4 月 4 日當週
HTTP GET 廣告請求長度上限增加至 4,096 個字元。
2016 年 3 月 28 日當週
新增設定選項,讓 SafeFrame 允許透過重疊內容展開:allowOverlayExpansion。
新增設定選項,讓 SafeFrame 使用 HTML5 sandbox 屬性來禁止頂層導覽:sandbox。
2016 年 2 月 22 日當週
新增設定廣告容器 iframe 標題的功能:setAdIframeTitle()。
新增 API,在網頁和版位層級設定 SafeFrame 屬性:setSafeFrameConfig()。
2016 年 2 月 15 日當週
新增毀損位置並重複使用 div 的功能:destroySlots()。
新增 API,強制在廣告空間使用 SafeFrame,並進行精細控制:setForceSafeFrame()。
2015 年 12 月 7 日當週
新增版位曝光事件 (SlotVisibilityChangedEvent)。
2015 年 10 月 26 日當週
新增曝光可視度 (ImpressionViewableEvent)。
從 JSON 對應 (Passback.updateTargetingFromMap()) 更新回傳指定目標。
2015 年 10 月 12 日當週
支援非頁內回傳。
2015 年 8 月 31 日當週
將 GPT 架構重組為精簡的載入器和較大的實作項目。
支援 GPT 中的自動調整大小。