本頁說明 Google 發布商廣告代碼的產品更新詳細資料 (GPT) 程式庫。您可以定期查看這個網頁 全新或更新功能、錯誤修正、已知問題和 已淘汰的功能
如要接收最新消息，請將這個網頁的網址加到您的
動態消息閱讀器，或是使用直接連結
版本資訊動態饋給
Atom 1.0
或
RSS 2.0 格式。
瞭解推出日期
對 GPT 程式庫的所有變更，我們會先經過全面測試 版本。此外，我們會逐步向使用者推出版本， 避免意外迴歸如果在任何時間點發現迴歸問題 在推出過程中，可能很快就會放棄整個版本。 所有使用者。
因此，發行日期並不精確。發布新版本時 也就是經過數天或數週的時間才會全面推出換言之，使用者 在不同時間執行變更下方提供的日期代表開始時間 變更套用至「所有」使用者。
2024 年 7 月 29 日當週
GPT 現在會使用 Scheduler.postTask (如果有的話) 優先：「使用者封鎖」才顯示 廣告素材。事實證明，這對模型的影響極小 同時對廣告活動的曝光次數 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 將停止放送
但也無法向那些
版本。請參閱上一則公告
。
透過 www.googletagservices.com/tag/js/gpt.js 放送廣告的發布商可以繼續
。不過，我們仍建議改用偏好網域，因為
可能會改善 www.googletagservices.com 上的 gpt.js 效能及提供方式
可能會停用
2023 年 6 月 6 日當週
從 2023 年 7 月 5 日當天或之後，GPT 將不再放送過舊廣告 的 JavaScript 程式庫版本不影響發布商載入 從 官方網址。 提供 gpt.js、pubads_impl.js 或 所有載入的程式庫都必須更新網頁，才能使用 網址。詳情請參閱入門指南。
2023 年 5 月 22 日當週
提供給 googletag.defineSlot() 的負數和零大小值
和 SizeMappingBuilder.addSize()
就會自動移除。因此，提供這類無效值的現有整合可能會出現
發布商控制台訊息的數量增加。
不過，這項設定不會影響現有有效的廣告請求。
2023 年 5 月 18 日當週
現在 GPT 的安全信號出價工具指令碼安裝作業現在將在 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 列舉的行為。也就是 會維持不變，而這些新的反向對應則不應 。
2021 年 8 月 9 日當週
添加removeEventListener方法。
正在撥打 addEventListener 多次產生相同的 eventType 和回呼函式例項 免人工管理換句話說，如果註冊單一回呼函式例項， 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 方法。先前只有在 googletag.enableServices 之前呼叫時才會套用 set。
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() 後就能立即完全正常運作，而非以非同步方式初始化。也就是說，在呼叫 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 日當週
2018 年 3 月 12 日當週
復原變更；如果 GPT 沒有將內容放在任何版位，在重新整理前停止將現有內容移除。系統將清除內容。
2018 年 2 月 19 日當週
使用非同步顯示模式時：請求所有廣告請求都以 XMLHttpRequest 搭配 HTTP GET 方法使用 (最多 8,192 個字元)。先前，HTTP POST 方法適用於超過 4,096 個字元的廣告請求，上限為 8,192 個字元。
在重新整理前停止將現有內容移除 (如果 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。
2016 年 2 月 22 日當週
新增設定廣告容器 iframe 標題的功能：setAdIframeTitle()。
新增用於在網頁和版位層級設定 SafeFrame 屬性的 API：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 中的自動調整大小。