本頁面記錄 Google 發布商廣告代碼 (GPT) 程式庫的正式版更新。您可以定期查看本頁的公告內容，瞭解各種全新或更新功能、錯誤修正、已知問題及已淘汰的功能。
如要接收更新內容，請將本頁面的網址加入您選擇的動態饋給閱讀器，或使用 Atom 1.0
或 RSS 2.0 格式的直接連結前往版本資訊動態饋給。
瞭解發布日期
所有 GPT 程式庫變更在發布前都會經過完整測試。此外，系統會逐步向使用者推出版本，以進一步防範非預期的迴歸。如果在發布期間的任何時間點發現迴歸問題，則整個版本在發布給所有使用者前可能會迅速捨棄。
因此，發布日期不一定是確切的發布日期，可能需要數天到數週的時間才會全面推出。也就是說，使用者會在不同的時間發生變更。下方提供的日期反映的是當週開始，變更已向「所有」使用者推出。
2024 年 2 月 19 日當週
2024 年 2 月 12 日當週
新增設定 發布商提供的信號 (PPS) 支援功能。
修正 SlotRenderEndedEvent.slotContentChanged 一律為 true 的錯誤。日後，只有在版位內容有所變更時，這個屬性才會是 true，否則只會是 false (例如廣告未供應時)。
2024 年 1 月 29 日當週
如果廣告請求的網路失敗，會啟動 isEmpty 設為 true 的 googletag.events.SlotRenderEndedEvent，藉此模擬沒有供應廣告的情形。如需監聽這個事件的範例，請參閱廣告事件監聽器。變更包括在使用 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 的安全信號出價工具指令碼目前將於 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 現在會在長網頁工作階段上繼續觸發。先前則是在網頁載入後一小時後就關閉了。
2021 年 5 月 3 日當週
GPT 不會在擷取廣告前設定版位空間。這項變更可以減少未使用 CSS 保留空間的網站，減少了累計版面配置位移 (CLS)。 如要進一步減少網站上的 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()，因為這些功能會同步運作，也可能遭到特定瀏覽器封鎖。瞭解詳情。
新增了 Slot.updateTargetingFromMap() 方法。
已新增 PubAdsService.setPrivacySettings()，做為啟用隱私權設定的新方法。日後會在這裡提供其他設定。
2019 年 3 月 25 日當週
現在 Pubads 服務在呼叫 googletag.enableServices() 後立即可正常運作，而不會以非同步方式初始化。也就是說，現在 googletag.pubadsReady 保證在呼叫 googletag.enableServices() 後都會是 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 日當週
在 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 個字元的限制。先前，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()。
新增 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 支援自動調整大小。