本頁面說明 Google 發布商廣告代碼 (GPT) 程式庫的正式版更新。您可以定期查看本頁面，瞭解各種新型或更新功能、修正的錯誤、已知問題及已淘汰的功能。
如要接收更新資訊，請將本頁的網址新增至您所選擇的動態消息閱讀器，或是使用版本資訊動態消息的直接連結，可用的格式有：Atom 1.0
或 RSS 2.0。
瞭解發布日期
我們會在發布前徹底測試 GPT 程式庫的所有變更。此外，我們會逐步向使用者推出版本，進一步防範非預期的回歸現象。如果在推出期間的任何時間點發現回歸現象，可以迅速放棄整個版本，避免影響所有使用者。
因此，發布日期並非精確的時間點，因為發布作業可能需要幾天至幾週的時間才能完成。也就是說，使用者會在不同時間看到變更。下方提供的日期，是指變更完成向所有使用者推出的週期開始日期。
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 執行緒，優先順序為「使用者阻斷」。這項做法對曝光次數的影響極小，但對 Core Web Vitals 有顯著助益。根據預設，只有在廣告位於可視區域之外時，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 日當週
GPT 不再支援在未原生支援 Intersection Observer API 的瀏覽器上，使用可視度為基礎的功能。請注意，所有支援的瀏覽器都原生支援這個 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 日當週
Enums 現在也會公開值與鍵的反向對應，以便與 TypeScript 列舉的行為相符。使用列舉值的 API 仍維持不變，且不應使用這些新的反向對應項目。
2021 年 8 月 9 日當週
新增 removeEventListener 方法。
如今，使用相同的 eventType 和回呼函式執行個體多次呼叫 addEventListener 會導致無操作。換句話說，如果單一回呼函式執行個體針對相同事件類型註冊 n 次，則在事件發生時，該函式只會執行一次，而非 n 次。
2021 年 7 月 29 日當週
GPT 的可視度事件：ImpressionViewableEvent 和 SlotVisibilityChangedEvent 現已可繼續觸發長網頁工作階段。先前，這些 cookie 會在網頁載入後一小時關閉。
2021 年 5 月 3 日當週
GPT 不再在擷取廣告前設定版位空間。這項變更可在未使用 CSS 保留空間的網站上，減少累積的版面配置位移 (CLS)。如要進一步降低網站的 CLS，建議您使用 CSS 為廣告保留非零值區域。瞭解詳情
2021 年 3 月 22 日當週
更新 enableLazyLoad() 的行為，以便延遲背景分頁中下折顯示區塊的轉譯作業。
2021 年 2 月 23 日當週
googletag.pubads().set 和 Slot.set 方法現在可在 display 或 refresh 之前的任何時間呼叫。先前 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 日當週
Pubads 服務現在會在呼叫 googletag.enableServices() 後立即完全運作，而非以非同步方式進行初始化。也就是說，現在只要呼叫 googletag.enableServices()，系統就保證 googletag.pubadsReady 會立即設為 true。您應該不再需要輪詢來檢查 googletag.pubadsReady 的值。
2019 年 2 月 4 日當週
更新 enableLazyLoad() 的行為，以便在呼叫 enableServices() 後變更延遲載入設定，並在顯示每個插槽時凍結該插槽的延遲載入設定。
2019 年 1 月 21 日當週
新增支援的事件 SlotResponseReceived，會在接收廣告單元廣告回應時觸發。
2019 年 1 月 14 日當週
新增支援的事件 SlotRequestedEvent，會在廣告單元發出廣告要求時觸發。
2018 年 8 月 27 日當週
修改 googletag.display()，以便接受 googletag.Slot 做為引數。
2018 年 8 月 6 日當週
新增 googletag.PubAdsService.enableLazyLoad()，用於在 GPT 中延遲載入廣告。
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 日當週
使用非同步顯示模式時：請盡可能使用 HTTP GET 方法搭配 XMLHttpRequest 來要求廣告 (所有廣告請求的長度上限為 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 日當週
在服務上發布 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 中的自動調整大小功能。