Halaman ini mendokumentasikan update produksi pada library Tag Google Publisher (GPT). Anda dapat memeriksa halaman ini secara berkala untuk melihat info terkait fitur baru atau yang diupdate, perbaikan bug, masalah umum, dan fungsi yang tidak digunakan lagi.
Agar update dikirimkan kepada Anda, tambahkan URL halaman ini ke
pembaca feed pilihan Anda, atau gunakan link langsung ke
feed catatan rilis dalam format
Atom 1.0
atau
RSS 2.0.
Memahami tanggal rilis
Semua perubahan pada library GPT diuji secara menyeluruh sebelum dirilis. Selain itu, rilis diluncurkan kepada pengguna secara bertahap untuk lebih melindungi dari regresi yang tidak terduga. Jika regresi terlihat selama peluncuran, seluruh rilis dapat segera diabaikan sebelum menjangkau semua pengguna.
Oleh karena itu, tanggal rilis tidaklah tepat. Rilis dapat memerlukan waktu beberapa hari hingga beberapa minggu untuk diluncurkan sepenuhnya. Artinya, pengguna akan mengalami perubahan pada waktu yang berbeda. Tanggal yang diberikan di bawah mencerminkan awal minggu saat perubahan selesai diluncurkan ke semua pengguna.
Pekan ke-19 Februari 2024
Menambahkan pemicu interstisial navBar, yang dapat menampilkan iklan interstisial yang dikelola GPT saat pengguna berinteraksi dengan menu navigasi browser. Fitur ini khusus untuk desktop.
Lihat Menampilkan iklan interstisial web untuk mengetahui contohnya.
Pekan ke-12 Februari 2024
Menambahkan dukungan untuk mengonfigurasi sinyal yang diberikan penayang (PPS).
Memperbaiki bug yang mana SlotRenderEndedEvent.slotContentChanged selalu true. Ke depannya, properti ini hanya akan menjadi true jika
konten slot diubah, dan false jika tidak (misalnya, jika iklan tidak terisi).
Pekan tanggal 29 Januari 2024
Kegagalan jaringan untuk permintaan iklan akan menirukan tidak adanya pengisian dengan mengaktifkan googletag.events.SlotRenderEndedEvent dengan isEmpty yang ditetapkan ke true. Lihat Pemroses peristiwa iklan untuk mengetahui contoh cara memproses peristiwa ini. Perubahan termasuk menciutkan slot secara otomatis saat menggunakan collapseEmptyDivs.
Penambahan dukungan untuk mengonfigurasi perluasan iklan di desktop/tablet dan web seluler (layar sebagian).
Pekan tanggal 11 Desember 2023
Menambahkan dukungan untuk iklan anchor kolom samping.
| Baru di GPT | |
|---|---|
| Enum |
OutOfPageFormat.LEFT_SIDE_RAILOutOfPageFormat.RIGHT_SIDE_RAIL
|
Pekan tanggal 13 November 2023
Menambahkan dukungan untuk mengonfigurasi perlakuan privasi penayang.
Menambahkan dukungan untuk pra-rendering Chrome. Saat GPT mendeteksi halaman dalam status pra-rendering, permintaan iklan akan ditunda hingga halaman terlihat oleh pengguna.
Pekan tanggal 23 Oktober 2023
Menambahkan dukungan untuk pemicu interstisial web opsional.
| Baru di GPT | |
|---|---|
| Objek |
googletag.config.InterstitialConfig
|
| Properti |
googletag.config.SlotSettingsConfig.interstitial
|
| Jenis |
googletag.config.InterstitialTrigger
|
Pekan ke-24 Juli 2023
Protected Audience API (sebelumnya dikenal sebagai FLEDGE) bertransisi ke ketersediaan umum dengan Chrome dirilis pada bulan Juli. Dengan ini, fungsi terkait lelang komponen di GPT kini dianggap stabil.
| Dipindahkan dari eksperimental ke stabil | |
|---|---|
| Objek |
googletag.config.ComponentAuctionConfig
|
| Properti |
googletag.config.SlotSettingsConfig.componentAuction
|
Pekan tanggal 19 Juni 2023
Update: Mulai atau setelah 5 Juli 2023, GPT tidak akan lagi menayangkan
versi library JavaScript-nya yang sudah tidak berlaku, atau menayangkan iklan ke
versi tersebut. Lihat pengumuman sebelumnya
untuk mengetahui detailnya.
Penayang yang menayangkan dari www.googletagservices.com/tag/js/gpt.js dapat terus
melakukannya. Namun, sebaiknya beralih ke domain pilihan, karena
dapat meningkatkan performa dan penayangan gpt.js di www.googletagservices.com
dapat dihentikan di masa mendatang.
Pekan tanggal 6 Juni 2023
Mulai atau setelah 5 Juli 2023, GPT tidak akan lagi menayangkan versi library JavaScript yang sudah tidak berlaku. Tidak ada dampak bagi penayang yang memuat GPT dari URL resmi. Penayang yang menayangkan versi gpt.js, pubads_impl.js, atau library apa pun yang di-cache harus memperbarui halaman agar dapat menggunakan URL resmi. Untuk informasi selengkapnya, lihat panduan Memulai.
Pekan tanggal 22 Mei 2023
Nilai ukuran negatif dan nol yang diberikan ke googletag.defineSlot()
dan SizeMappingBuilder.addSize()
kini otomatis dihapus, karena tidak valid. Akibatnya, integrasi yang ada yang memberikan nilai tidak valid tersebut mungkin mengalami peningkatan pesan konsol penayang.
Namun, hal ini tidak akan berpengaruh pada permintaan iklan yang ada dan valid.
Pekan tanggal 18 Mei 2023
Penginstalan skrip bidder Sinyal Aman oleh GPT kini akan dilakukan lebih awal dalam eksekusi GPT. Hal ini dapat meningkatkan cakupan sinyal di seluruh permintaan iklan.
Pekan tanggal 1 Mei 2023
Memperbaiki bug yang menyebabkan materi iklan terpotong saat memuat ulang slot anchor berbagai ukuran.
Pekan tanggal 27 Maret 2023
GPT tidak lagi mendukung fitur berbasis visibilitas di browser yang secara native tidak mendukung Intersection Observer API. Perlu diperhatikan bahwa semua browser yang didukung mendukung API ini secara native.
| Metode atau Peristiwa | |
|---|---|
googletag.events.ImpressionViewableEvent
|
|
googletag.events.SlotVisibilityChangedEvent
|
|
googletag.pubads().enableLazyLoad()
|
|
Pekan ke-6 Februari 2023
Menambahkan dukungan untuk membagikan sinyal aman.
| Baru di GPT | |
|---|---|
| Objek |
BidderSignalProviderPublisherSignalProviderSecureSignalProvidersArray
|
| Jenis |
SecureSignalProvider
|
| Variabel |
googletag.secureSignalProviders
|
Pekan tanggal 30 Januari 2023
Perilaku Service.addEventListener() telah berubah sehingga jika suatu peristiwa terjadi, semua pemroses terkait akan dieksekusi sebelum memproses peristiwa berikutnya. Sebelum perubahan ini, pemroses peristiwa awal dan akhir render slot untuk slot yang sama dapat dieksekusi secara tidak berurutan.
Pekan tanggal 15 Agustus 2022
Jenis nilai yang ditampilkan Service.removeEventListener() telah diubah dari boolean menjadi void.
Pekan tanggal 25 Juli 2022
Menambahkan dukungan eksperimental untuk lelang komponen FLEDGE, guna memungkinkan pengujian awal FLEDGE dengan beberapa penjual.
| Baru di GPT | |
|---|---|
| Metode |
Slot.setConfig()
|
| Objek |
ComponentAuctionConfigSlotSettingsConfig
|
Pekan tanggal 18 Juli 2022
ContentService API telah dihentikan. Memanggil googletag.content().setContent sekarang tidak berpengaruh selain logging peringatan. Properti googletag.content akan segera dihapus sepenuhnya; setelah itu, jika properti tersebut dipanggil, pengecualian akan ditampilkan. Sebagai gantinya, gunakan DOM API bawaan browser untuk menambahkan konten secara langsung ke elemen div.
Pekan tanggal 23 Mei 2022
Menambahkan dukungan untuk mengonfigurasi sumber traffic permintaan iklan.
| Dukungan GPT untuk sumber traffic | |
|---|---|
| Enum |
TrafficSource.ORGANICTrafficSource.PURCHASED
|
| Properti | PrivacySettingsConfig.trafficSource |
Pekan tanggal 7 Maret 2022
Iklan reward untuk web telah diluncurkan. Buka pusat bantuan Ad Manager untuk mengetahui detailnya.
| Dukungan GPT untuk iklan reward untuk web | |
|---|---|
| Enum | OutOfPageFormat.REWARDED |
| Event | RewardedSlotClosedEvent |
| Event | RewardedSlotGrantedEvent |
| Event | RewardedSlotReadyEvent |
| Objek | RewardedPayload |
Pekan tanggal 28 Februari 2022
CommandArray.push sekarang secara eksplisit mengikat fungsi yang disediakan ke globalThis, bukan objek arguments-nya sendiri.
Pekan tanggal 8 Desember 2021
Enum kini juga menampilkan pemetaan terbalik nilai ke kunci untuk mencocokkan perilaku enum TypeScript. API yang menggunakan nilai enum tetap tidak berubah, dan pemetaan terbalik baru ini tidak boleh digunakan.
Pekan tanggal 9 Agustus 2021
Menambahkan metode removeEventListener.
Memanggil addEventListener beberapa kali dengan eventType dan instance fungsi callback yang sama kini tanpa pengoperasian. Dengan kata lain, jika satu instance fungsi callback didaftarkan n kali untuk jenis peristiwa yang sama, instance tersebut hanya akan dijalankan satu kali ketika peristiwa terjadi, bukan n kali.
Pekan tanggal 29 Juli 2021
Peristiwa visibilitas GPT: ImpressionViewableEvent
dan SlotVisibilityChangedEvent
kini akan terus aktif pada sesi halaman yang panjang. Sebelumnya, mereka menonaktifkan layanan setelah satu jam sejak pemuatan halaman.
Pekan tanggal 3 Mei 2021
GPT tidak lagi menetapkan ruang untuk slot sebelum mengambil iklan. Perubahan ini akan mengurangi Pergeseran Tata Letak Kumulatif (CLS) pada situs yang belum mencadangkan ruang menggunakan CSS. Untuk mengurangi CLS lebih lanjut di situs Anda, sebaiknya cadangkan area selain nol untuk iklan menggunakan CSS. Pelajari lebih lanjut
Pekan tanggal 22 Maret 2021
Memperbarui perilaku enableLazyLoad() untuk juga menunda rendering slot paruh bawah di tab latar belakang.
Pekan tanggal 23 Februari 2021
Metode googletag.pubads().set dan Slot.set kini dapat dipanggil kapan saja sebelum display atau refresh. Sebelumnya set hanya diterapkan saat dipanggil sebelum googletag.enableServices.
Pekan tanggal 16 Februari 2021
googletag.pubads().setPublisherProvidedId API kini dapat dipanggil kapan saja. Sebelumnya, fungsi ini hanya berfungsi jika dipanggil sebelum googletag.enableServices.
Pekan tanggal 4 Januari 2021
googletag.pubads().collapseEmptyDivs API kini dapat dipanggil berulang kali untuk mengubah setelan. Panggilan berulang sebelumnya akan diabaikan.
Pekan 12 Oktober 2020
Meluncurkan interstisial web versi beta terbuka, lihat pusat bantuan.
Pekan 31 Agustus 2020
Menghentikan penggunaan definePassback() dan defineOutOfPagePassback(). Lihat dokumen passback untuk mengetahui cara membuat passback dengan benar.
Pekan tanggal 15 Juni 2020
Memperbarui perilaku enableLazyLoad() agar kompatibel dengan collapseEmptyDivs(true).
Pekan tanggal 25 Mei 2020
GPT tidak lagi mendukung lokasi GPS akurat yang ditetapkan oleh penayang. Secara khusus, googletag.pubads().setLocation() tidak akan lagi mendukung parameter lintang, bujur, atau radius, tetapi akan menggunakan alamat berformat bebas.
Pekan tanggal 27 April 2020
Logika rendering GPT tidak lagi dimodularisasi ke dalam file terpisah. Artinya, GPT akan mengambil lebih sedikit file dalam eksekusinya, sehingga akan sedikit mengurangi latensi, tetapi tidak memiliki dampak bersih pada bandwidth pengguna.
Saat permintaan dipicu di GPT (dengan memanggil googletag.display() atau googletag.pubads().refresh()), kini kami akan membekukan semua status yang diberikan penayang secara internal sehingga tidak dapat diubah sebelum permintaan tersebut dikirim. Oleh karena itu, ketika permintaan terpicu, hanya status yang ditambahkan hingga titik tersebut yang akan digunakan untuk permintaan tersebut. Setiap status yang diubah setelahnya hanya akan berlaku untuk permintaan berikut.
Pekan tanggal 11 November 2019
Sekarang ada cuplikan baru yang direkomendasikan untuk membuat passback GPT. Penggunaan definePassback()
dan defineOutOfPagePassback() tidak disarankan, karena fungsi ini berperilaku secara sinkron dan mungkin diblokir oleh browser tertentu. Pelajari lebih lanjut.
Menambahkan metode Slot.updateTargetingFromMap().
Menambahkan PubAdsService.setPrivacySettings() sebagai metode baru untuk mengaktifkan setelan privasi. Setelan tambahan akan tersedia di sini pada masa mendatang.
Pekan 25 Maret 2019
Layanan Pub Ads kini beroperasi sepenuhnya segera setelah memanggil googletag.enableServices(), bukan diinisialisasi secara asinkron. Ini berarti googletag.pubadsReady sekarang dijamin benar setelah memanggil googletag.enableServices(). Polling untuk memeriksa nilai googletag.pubadsReady tidak lagi diperlukan.
Pekan Tanggal 4 Februari 2019
Memperbarui perilaku enableLazyLoad() untuk memungkinkan perubahan pada konfigurasi pemuatan lambat setelah memanggil enableServices(), dengan konfigurasi pemuatan lambat yang dibekukan untuk setiap slot saat slot tersebut ditampilkan.
Pekan tanggal 21 Januari 2019
Menambahkan peristiwa baru yang didukung, SlotResponseReceived, yang aktif saat respons iklan diterima untuk slot.
Menambahkan kolom baru, creativeTemplateId ke googleTag.ResponseInformation.
Pekan 14 Januari 2019
Menambahkan peristiwa baru yang didukung, SlotRequestedEvent, yang diaktifkan saat permintaan iklan dibuat untuk slot.
Pekan 27 Agustus 2018
Mengubah googletag.display() untuk menerima googletag.Slot sebagai argumen.
Pekan tanggal 6 Agustus 2018
Menambahkan googletag.PubAdsService.enableLazyLoad() untuk iklan pemuatan lambat di GPT.
Pekan 18 Juni 2018
Memperbaiki bug yang menyebabkan googletag.events.SlotOnloadEvent tidak terpicu.
Pekan 30 April 2018
Menambahkan googletag.PubAdsService.setTagForUnderAgeOfConsent() untuk mengontrol iklan bagi pengguna yang berusia di bawah usia dewasa, dan googletag.PassbackSlot.setTagForUnderAgeOfConsent() untuk menandai slot passback sebagai berasal dari pengguna yang berusia di bawah usia dewasa.
Pekan 23 April 2018
Menambahkan googletag.PubAdsService.setRequestNonPersonalizedAds() untuk mengontrol personalisasi iklan.
Pekan 12 Maret 2018
Melakukan roll back perubahan yang menghentikan penghapusan konten yang ada di dalam slot sebelum pemuatan ulang, jika konten tersebut tidak ditempatkan di sana oleh GPT. Konten kini akan dihapus.
Pekan 19 Februari 2018
Jika mode rendering asinkron digunakan: Minta iklan menggunakan XMLHttpRequest dengan metode HTTP GET jika memungkinkan untuk semua permintaan iklan, hingga batas 8.192 karakter. Sebelumnya, metode HTTP POST telah digunakan untuk permintaan iklan yang melebihi 4.096 karakter, hingga batas 8.192 karakter.
Menghentikan penghapusan konten yang ada di dalam slot sebelum pemuatan ulang, jika konten tersebut tidak ditempatkan di sana oleh GPT. Catatan ini salah; lihat entri untuk Pekan tanggal 12 Maret 2018
Pekan tanggal 8 Januari 2018
Mendukung sintaksis alternatif [..., ['fluid'], ...] sebagai NamedSized dalam array multiukuran. Sebelumnya, hanya [..., 'fluid', ...] yang dianggap valid.
Pekan 10 Juli 2017
Menghapus kolom labelIds dari googleTag.ResponseInformation.
Pekan tanggal 5 Juni 2017
Memodifikasi googletag.display() dan googletag.pubads().display untuk menerima elemen div serta ID div. Hal ini memungkinkan slot rendering di dalam div yang ada dalam shadow DOM.
Pekan 27 Februari 2017
Menambahkan sourceAgnosticCreativeId dan sourceAgnosticLineItemId ke SlotRenderEndedEvent.
Pekan tanggal 7 November 2016
Merilis getSlots() API di Layanan untuk mengambil daftar slot yang terkait dengan layanan.
Pekan 17 Oktober 2016
Mengubah Slot.clearTargeting() dan PubAdsService.clearTargeting() untuk menggunakan parameter kunci opsional.
Pekan tanggal 5 September 2016
Error yang tertangkap di googletag.cmd.push() tidak lagi terlihat, dan akan dicetak ke konsol.
Pekan tanggal 8 Agustus 2016
Merilis SlotOnloadEvent API untuk memungkinkan pemrosesan materi iklan selesai dimuat.
Pekan 25 Juli 2016
Merilis getTargeting() dan getTargetingKeys() API di PubAdsService untuk mengambil parameter penargetan tingkat layanan kustom.
Pekan tanggal 20 Juni 2016
Merilis openConsole() API untuk membuka Konsol Google Publisher tanpa perlu memuat ulang halaman.
Pekan tanggal 6 Juni 2016
Merilis getTargeting() dan getTargetingKeys() API untuk mengambil parameter penargetan kustom.
Menambahkan opsi konfigurasi tempat Safeframe akan mengizinkan perluasan dengan mengirim konten: allowPushExpansion.
Pekan 16 Mei 2016
Mendukung ukuran yang dapat disesuaikan dalam permintaan iklan beberapa ukuran.
Pekan 18 April 2016
Merilis getResponseInformation API yang menampilkan informasi respons iklan untuk slot iklan.
Merilis setAdIframeTitle API yang menetapkan input sebagai judul iframe penampung iklan yang dibuat setelahnya.
Pekan tanggal 4 April 2016
Meningkatkan panjang maksimum permintaan iklan HTTP GET menjadi 4.096 karakter.
Pekan 28 Maret 2016
Menambahkan opsi konfigurasi tempat Safeframe harus mengizinkan perluasan dengan menempatkan konten: allowOverlayExpansion.
Menambahkan opsi konfigurasi saat SafeFrame harus menggunakan atribut sandbox HTML5 untuk mencegah navigasi tingkat atas: sandbox.
Pekan 22 Februari 2016
Menambahkan kemampuan untuk menetapkan judul untuk iframe penampung iklan: setAdIframeTitle().
Menambahkan API untuk mengonfigurasi properti SafeFrame di tingkat slot dan halaman: setSafeFrameConfig().
Pekan 15 Februari 2016
Menambahkan kemampuan untuk menghancurkan slot dan menggunakan kembali div: destroySlots().
Menambahkan API untuk memaksa penggunaan safeframe pada slot iklan dengan kontrol terperinci: setForceSafeFrame().
Pekan tanggal 7 Desember 2015
Menambahkan peristiwa visibilitas slot (SlotVisibilityChangedEvent).
Pekan 26 Oktober 2015
Menambahkan visibilitas tayangan (ImpressionViewableEvent).
Memperbarui penargetan passback dari peta JSON (Passback.updateTargetingFromMap()).
Pekan 12 Oktober 2015
Dukungan untuk pass-of-page.
Pekan 31 Agustus 2015
Restrukturisasi arsitektur GPT menjadi thin loader dan implementasi yang lebih besar.
Dukungan untuk ukuran yang dapat disesuaikan di GPT.