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.

Aktifkan pramuat

Untuk mengaktifkan pramuat, setel AdsRenderingSettings.enablePreloading ke true. Tindakan ini harus dilakukan sebagai akibat 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 melakukan pramuat diaktifkan:

Acara	Dengan Pramuat	Tanpa Pramuat
VAST iklan diminta	AdsLoader.requestAds()	AdsLoader.requestAds()
Pre-roll dimuat (satu iklan)	AdsManager.init()	AdsManager.start()
Pre-roll dimuat (Aturan iklan/VMAP)	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

Pramuat tunduk kepada batasan berikut:

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

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

FAQ

Apakah pramuat media akan memuat materi iklan sepenuhnya?

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

Apakah pramuat media perlu diaktifkan untuk VAST iklan serta media?

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