Pramuat media

IMA SDK mendukung pramuat aset iklan video. Anda dapat mengaktifkan fitur ini dalam integrasi SDK untuk memberikan transisi yang lebih lancar antara iklan dan konten. Panduan ini membahas detail teknis penerapan pramuat media dengan IMA SDK.

Mengaktifkan pramuat

Untuk mengaktifkan pramuat, tetapkan AdsRenderingSettings.enablePreloading ke true. Hal ini harus dilakukan sebagai hasil dari peristiwa ADS_MANAGER_LOADED:

function onAdsManagerLoaded(adsManagerLoadedEvent) {
  var adsRenderingSettings = new google.ima.AdsRenderingSettings();
  adsRenderingSettings.enablePreloading = true;
  ...
  var adsManager = adsManagerLoadedEvent.getAdsManager(
      videoContent, adsRenderingSettings);
}

Waktu

Tabel berikut meringkas perubahan waktu pemuatan iklan saat pramuat diaktifkan:

Acara	Dengan Pramuat	Tanpa Pramuat
VAST iklan yang diminta	AdsLoader.requestAds()	AdsLoader.requestAds()
Pre-roll dimuat (satu iklan)	AdsManager.init()	AdsManager.start()
Pre-roll dimuat (VMAP/Aturan iklan)	AdsManager.init()	AdsManager.init()
Mid-roll atau post-roll dimuat	Untuk iklan pertama dalam jeda iklan, 8 detik sebelum waktu mulai iklan. Untuk iklan berturut-turut, saat iklan sebelumnya mulai diputar.	Pada waktu mulai iklan.

Batasan

Pemuatan sebelumnya tunduk pada batasan berikut:

• Pemuatan media sebelumnya tidak tersedia di web seluler pada perangkat iOS atau saat menggunakan IMA SDK HTML5 di smart TV yang terhubung.
• VPAID dimuat sebelumnya, tetapi tidak ada dependensi iklan—termasuk media yang diputar oleh iklan tersebut—yang dimuat hingga iklan dieksekusi.
• Autoplay harus diaktifkan untuk memuat iklan VMAP secara otomatis. Pastikan settings.isAutoPlayAdBreaks() ditetapkan ke true, yang merupakan nilai default.
• Post-roll dimuat sebelumnya setelah mid-roll terakhir, atau 8 detik sebelum akhir konten jika AdsRequest.contentDuration digunakan untuk menetapkan durasi.

Catatan: Menetapkan contentDuration ke nilai yang dicadangkan -3 (dengan contentDuration(-3)) adalah nilai khusus yang mengidentifikasi durasi konten yang tidak diketahui dan menonaktifkan pramuat untuk post-roll VAMP.

FAQ

Apakah pramuat media memuat materi iklan lengkap?

Tidak, materi iklan biasanya tidak dimuat sepenuhnya saat pemutaran iklan dimulai. Pemuatan data dimaksudkan untuk meningkatkan pengalaman pengguna dengan meminimalkan waktu yang diperlukan untuk memuat iklan. Fitur ini tidak dimaksudkan untuk mendukung penayangan iklan offline. IMA SDK memuat media sebanyak yang diizinkan browser, yang dibatasi oleh koneksi internet pengguna dan ukuran materi iklan.

Apakah pramuat media perlu diaktifkan untuk VAST dan media iklan?

Tidak, SDK selalu melakukan pramuat VAST iklan, terlepas dari setelan pramuat ini.