Halaman ini mendokumentasikan update produksi pada library Tag Google Penayang (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 dapat sampai 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 terdeteksi kapan saja selama peluncuran, seluruh rilis dapat segera dihentikan sebelum menjangkau semua pengguna.
Oleh karena itu, tanggal rilis tidak pasti; rilis dapat memerlukan waktu dari 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 kepada semua pengguna.
Minggu, 21 Oktober 2024
Ubah threadYield untuk menggunakan Scheduler.yield daripada
Scheduler.postTask jika tersedia. Lihat dokumentasi hasil untuk mengetahui detailnya.
| Diperbarui di GPT | |
|---|---|
| Properti |
googletag.config.PageSettingsConfig.threadYield
|
Minggu, 2 September 2024
Menambahkan dukungan untuk iklan interstisial game.
Minggu 19 Agustus 2024
Setelan untuk mengontrol perilaku hasil thread GPT telah diganti namanya dari
adYield menjadi threadYield untuk memperjelas bahwa fitur ini
berfokus pada menghasilkan thread JS, bukan mengoptimalkan hasil iklan. Perilaku
fitur dan API terkaitnya (selain nama) tetap
tidak berubah. Properti adYield akan dihapus dalam rilis GPT
mendatang.
Perilaku hasil thread default dapat dinonaktifkan dengan
googletag.setConfig({threadYield: 'DISABLED'});
atau diterapkan ke semua slot, terlepas dari lokasinya relatif terhadap area pandang
dengan googletag.setConfig({threadYield: 'ENABLED_ALL_SLOTS'});.
| Diperbarui di GPT | |
|---|---|
| Properti |
googletag.config.PageSettingsConfig.threadYield
|
Minggu, 29 Juli 2024
GPT kini menghasilkan thread JS menggunakan Scheduler.postTask (jika tersedia) dengan prioritas: 'pemblokiran pengguna' tepat sebelum merender materi iklan. Hal ini telah terbukti memiliki dampak yang sangat kecil pada tayangan sekaligus memberikan manfaat yang signifikan pada Core Web Vitals. Secara default, GPT hanya akan menghasilkan jika slot berada di luar area pandang.
Perilaku default dapat dinonaktifkan dengan
googletag.setConfig({adYield: 'DISABLED'});
atau diterapkan ke semua slot, terlepas dari lokasinya relatif terhadap area pandang
dengan googletag.setConfig({adYield: 'ENABLED_ALL_SLOTS'});.
| Yang baru di GPT | |
|---|---|
| Properti |
googletag.config.PageSettingsConfig.adYield
|
Minggu 12 Februari 2024
Menambahkan dukungan untuk mengonfigurasi sinyal yang diberikan penayang (PPS).
Memperbaiki bug saat
SlotRenderEndedEvent.slotContentChanged
selalu true. Ke depannya, properti ini hanya akan menjadi true jika
konten slot berubah, dan false jika tidak (misalnya, jika iklan tidak terisi).
Minggu, 29 Januari 2024
Kegagalan jaringan untuk permintaan iklan akan meniru tidak terisi dengan mengaktifkan
googletag.events.SlotRenderEndedEvent
dengan
isEmpty
disetel ke true. Lihat
Pemroses peristiwa iklan
untuk mengetahui contoh cara memproses peristiwa ini. Perubahan mencakup tindakan otomatis
menciutkan slot saat menggunakan
collapseEmptyDivs.
Menambahkan 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.
| Yang baru di GPT | |
|---|---|
| Enum |
OutOfPageFormat.LEFT_SIDE_RAILOutOfPageFormat.RIGHT_SIDE_RAIL
|
Minggu 13 November 2023
Menambahkan dukungan untuk mengonfigurasi perlakuan privasi penayang.
Menambahkan dukungan untuk pra-rendering Chrome. Saat GPT mendeteksi bahwa halaman berada dalam status pra-rendering, permintaan iklan akan tertunda 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
|
Minggu 24 Juli 2023
Protected Audience API (sebelumnya dikenal sebagai FLEDGE) bertransisi ke ketersediaan umum dengan rilis Chrome pada bulan Juli. Dengan demikian, fungsi terkait lelang komponen di GPT kini dianggap stabil.
| Dipindahkan dari eksperimental ke stabil | |
|---|---|
| Objek |
googletag.config.ComponentAuctionConfig
|
| Properti |
googletag.config.SlotSettingsConfig.componentAuction
|
Pekan 19 Juni 2023
Pembaruan: Mulai 5 Juli 2023 atau setelahnya, GPT tidak akan lagi menayangkan
library JavaScript versi lama, 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 pada masa mendatang.
Pekan 6 Juni 2023
Mulai 5 Juli 2023 atau setelahnya, GPT tidak akan lagi menayangkan library JavaScript versi lama. Tidak ada dampak bagi penayang yang memuat GPT dari URL resmi. Penerbit yang menayangkan versi cache gpt.js, pubads_impl.js, atau library apa pun yang dimuat harus memperbarui halamannya agar dapat menggunakan URL resmi. Untuk informasi selengkapnya, lihat panduan Memulai.
Minggu ke-4 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 akan mengalami
peningkatan pesan konsol penayang.
Namun, hal ini tidak akan memengaruhi permintaan iklan yang valid dan sudah ada.
Minggu 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.
Minggu 1 Mei 2023
Memperbaiki bug saat materi iklan yang tampak terpotong saat memuat ulang slot anchor beberapa ukuran.
Pekan 27 Maret 2023
GPT tidak lagi mendukung fitur berbasis visibilitas pada browser yang tidak mendukung Intersection Observer API secara native. Perlu diketahui bahwa semua browser yang didukung mendukung API ini secara native.
| Metode atau Peristiwa | |
|---|---|
googletag.events.ImpressionViewableEvent
|
|
googletag.events.SlotVisibilityChangedEvent
|
|
googletag.pubads().enableLazyLoad()
|
|
Minggu, 6 Februari 2023
Menambahkan dukungan untuk membagikan sinyal aman.
| Yang baru di GPT | |
|---|---|
| Objek |
BidderSignalProviderPublisherSignalProviderSecureSignalProvidersArray
|
| Jenis |
SecureSignalProvider
|
| Variabel |
googletag.secureSignalProviders
|
Minggu 30 Januari 2023
Perilaku Service.addEventListener() telah diubah sehingga saat peristiwa terjadi, semua pemroses terkait akan dieksekusi sebelum memproses peristiwa berikutnya. Sebelum perubahan ini, pemroses peristiwa awal dan akhir rendering slot untuk slot yang sama dapat dieksekusi secara tidak berurutan.
Minggu 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, untuk memungkinkan pengujian awal FLEDGE dengan beberapa penjual.
| Yang baru di GPT | |
|---|---|
| Metode |
Slot.setConfig()
|
| Objek |
ComponentAuctionConfigSlotSettingsConfig
|
Minggu 18 Juli 2022
ContentService API telah dihentikan. Memanggil googletag.content().setContent sekarang tidak berpengaruh apa pun selain mencatat peringatan ke dalam log. Properti googletag.content akan segera dihapus sepenuhnya; setelah itu, mencoba memanggilnya akan menampilkan pengecualian. Gunakan DOM API bawaan dari browser untuk langsung menambahkan konten 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 |
Minggu 7 Maret 2022
Iklan reward untuk web telah diluncurkan. Kunjungi pusat bantuan Ad Manager untuk mengetahui detailnya.
| Dukungan GPT untuk iklan reward untuk web | |
|---|---|
| Enum | OutOfPageFormat.REWARDED |
| Acara | RewardedSlotClosedEvent |
| Peristiwa | RewardedSlotGrantedEvent |
| Acara | RewardedSlotReadyEvent |
| Objek | RewardedPayload |
Minggu 28 Februari 2022
CommandArray.push sekarang secara eksplisit mengikat fungsi yang disediakan ke globalThis, bukan objek arguments-nya sendiri.
Minggu 8 Desember 2021
Kini Enum juga mengekspos pemetaan terbalik nilai ke kunci untuk mencocokkan perilaku enum TypeScript. API yang mengambil nilai enum tetap tidak berubah, dan pemetaan balik baru ini tidak boleh digunakan.
Minggu 9 Agustus 2021
Menambahkan metode removeEventListener.
Memanggil addEventListener beberapa kali dengan instance fungsi callback dan eventType yang sama kini tidak akan berfungsi. Dengan kata lain, jika satu instance fungsi callback didaftarkan n kali untuk jenis peristiwa yang sama, instance tersebut hanya akan dieksekusi satu kali saat peristiwa terjadi, bukan n kali.
Pekan 29 Juli 2021
Peristiwa visibilitas GPT: ImpressionViewableEvent
dan SlotVisibilityChangedEvent
kini akan terus diaktifkan pada sesi halaman yang panjang. Sebelumnya, situs ini dinonaktifkan
setelah satu jam sejak halaman dimuat.
Minggu 03 Mei 2021
GPT tidak lagi menetapkan ruang untuk slot sebelum mengambil iklan. Perubahan ini mengurangi Cumulative Layout Shift (CLS) di situs yang belum mencadangkan ruang menggunakan CSS. Untuk lebih mengurangi CLS di situs Anda, sebaiknya tetapkan area non-nol untuk iklan menggunakan CSS. Pelajari lebih lanjut
Minggu 22 Maret 2021
Memperbarui perilaku enableLazyLoad() untuk juga menunda rendering slot di bawah lipatan pada 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.
Minggu 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.
Minggu 12 Oktober 2020
Meluncurkan versi beta terbuka interstisial web, lihat pusat bantuan.
Minggu 31 Agustus 2020
Menghentikan penggunaan definePassback() dan defineOutOfPagePassback(). Lihat dokumen passback untuk mengetahui cara membuat passback dengan benar.
Pekan 15 Juni 2020
Memperbarui perilaku enableLazyLoad() agar kompatibel dengan collapseEmptyDivs(true).
Minggu 25 Mei 2020
GPT tidak akan lagi mendukung lokasi GPS presisi yang ditetapkan oleh penayang. Secara khusus, googletag.pubads().setLocation() tidak akan lagi mendukung parameter lintang, bujur, atau radius, tetapi akan mengambil alamat berformat bebas.
Minggu, 27 April 2020
Logika rendering GPT tidak lagi dimodularisasi menjadi file terpisah. Artinya, GPT akan mengambil lebih sedikit file dalam eksekusinya, sehingga sedikit mengurangi latensi, tetapi tidak memiliki dampak bersih pada bandwidth pengguna.
Saat permintaan dipicu di GPT (dengan memanggil googletag.display() atau googletag.pubads().refresh()), kami kini akan membekukan secara internal semua status yang disediakan penayang sehingga tidak dapat diubah sebelum permintaan dikirim. Oleh karena itu, saat permintaan dipicu, hanya status yang ditambahkan hingga titik tersebut yang akan digunakan untuk permintaan tersebut. Status apa pun yang diubah setelahnya hanya akan berlaku untuk permintaan berikut.
Minggu 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.
Minggu, 25 Maret 2019
Layanan Pubads kini beroperasi sepenuhnya segera setelah memanggil googletag.enableServices(), bukan diinisialisasi secara asinkron. Artinya, googletag.pubadsReady kini dijamin akan bernilai benar tepat setelah memanggil googletag.enableServices(). Polling untuk memeriksa nilai googletag.pubadsReady tidak perlu lagi.
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.
Minggu 21 Januari 2019
Menambahkan peristiwa baru yang didukung, SlotResponseReceived, yang diaktifkan saat respons iklan diterima untuk slot.
Menambahkan kolom baru, creativeTemplateId ke googleTag.ResponseInformation.
Minggu 14 Januari 2019
Menambahkan peristiwa baru yang didukung, SlotRequestedEvent, yang diaktifkan saat permintaan iklan dibuat untuk slot.
Minggu 27 Agustus 2018
Mengubah googletag.display() untuk menerima googletag.Slot sebagai argumen.
Minggu 6 Agustus 2018
Menambahkan googletag.PubAdsService.enableLazyLoad() untuk iklan pemuatan lambat di GPT.
Minggu 18 Juni 2018
Memperbaiki bug yang menyebabkan googletag.events.SlotOnloadEvent tidak dipicu.
Minggu, 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.
Minggu 23 April 2018
Menambahkan googletag.PubAdsService.setRequestNonPersonalizedAds() untuk mengontrol personalisasi iklan.
Minggu 12 Maret 2018
Mengembalikan perubahan yang berhenti menghapus konten yang ada di dalam slot sebelum memuat ulang, jika konten tersebut tidak ditempatkan di sana oleh GPT. Konten sekarang akan dihapus.
Minggu 19 Februari 2018
Saat 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 akan digunakan untuk permintaan iklan yang melebihi 4.096 karakter, hingga batas 8.192 karakter.
Berhenti menghapus konten yang ada di dalam slot sebelum dimuat ulang, jika konten tersebut tidak ditempatkan di sana oleh GPT. Catatan ini salah; lihat entri untuk Minggu 12 Maret 2018
Pekan tanggal 8 Januari 2018
Mendukung sintaksis alternatif [..., ['fluid'], ...] sebagai NamedSized dalam array beberapa ukuran. Sebelumnya, hanya [..., 'fluid', ...] yang dianggap valid.
Pekan 10 Juli 2017
Menghapus kolom labelIds dari googleTag.ResponseInformation.
Minggu 5 Juni 2017
Mengubah googletag.display() dan googletag.pubads().display untuk menerima elemen div serta ID div. Hal ini memungkinkan slot rendering di dalam div yang berada di shadow DOM.
Minggu 27 Februari 2017
Menambahkan sourceAgnosticCreativeId dan sourceAgnosticLineItemId ke SlotRenderEndedEvent.
Minggu 7 November 2016
Merilis getSlots() API di Layanan untuk mengambil daftar slot yang terkait dengan layanan.
Minggu 17 Oktober 2016
Mengubah Slot.clearTargeting() dan PubAdsService.clearTargeting() untuk menggunakan parameter kunci opsional.
Minggu 5 September 2016
Error yang tertangkap di googletag.cmd.push() tidak lagi tidak terlihat, dan akan dicetak ke konsol.
Minggu 8 Agustus 2016
Merilis SlotOnloadEvent API untuk memungkinkan pemrosesan materi iklan selesai dimuat.
Minggu 25 Juli 2016
Merilis getTargeting() dan getTargetingKeys() API di PubAdsService untuk mengambil parameter penargetan tingkat layanan kustom.
Minggu, 20 Juni 2016
Merilis openConsole() API untuk membuka Konsol Google Publisher tanpa perlu memuat ulang halaman.
Minggu 6 Juni 2016
Merilis getTargeting() dan getTargetingKeys() API untuk mengambil parameter penargetan kustom.
Menambahkan opsi konfigurasi tempat Safeframe harus mengizinkan perluasan dengan mendorong konten: allowPushExpansion.
Minggu 16 Mei 2016
Mendukung ukuran fleksibel dalam permintaan iklan multi-ukuran.
Minggu ke-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.
Minggu ke-1 April 2016
Meningkatkan panjang maksimum permintaan iklan HTTP GET menjadi 4.096 karakter.
Minggu, 28 Maret 2016
Menambahkan opsi konfigurasi yang mengizinkan Safeframe untuk memperluas dengan menempatkan konten: allowOverlayExpansion.
Menambahkan opsi konfigurasi tempat SafeFrame harus menggunakan atribut sandbox HTML5 untuk mencegah navigasi tingkat atas: sandbox.
Pekan tanggal 22 Februari 2016
Menambahkan kemampuan untuk menetapkan judul untuk iframe penampung iklan: setAdIframeTitle().
Menambahkan API untuk mengonfigurasi properti SafeFrame di tingkat halaman dan slot: setSafeFrameConfig().
Pekan 15 Februari 2016
Menambahkan kemampuan untuk menghancurkan slot dan menggunakan kembali div: destroySlots().
Menambahkan API untuk memaksa penggunaan safeframe di slot iklan dengan kontrol terperinci: setForceSafeFrame().
Minggu 7 Desember 2015
Menambahkan peristiwa visibilitas slot (SlotVisibilityChangedEvent).
Pekan 26 Oktober 2015
Menambahkan visibilitas tayangan (ImpressionViewableEvent).
Perbarui penargetan passback dari peta JSON (Passback.updateTargetingFromMap()).
Minggu 12 Oktober 2015
Dukungan untuk passback di luar halaman.
Minggu 31 Agustus 2015
Merestrukturisasi arsitektur GPT menjadi loader tipis dan implementasi yang lebih besar.
Dukungan untuk ukuran yang dapat menyesuaikan di GPT.