Medyayı önceden yükleme

IMA SDK, video reklam öğelerinin önceden yüklenmesini destekler. Reklamlar ve içerik arasında daha sorunsuz bir geçiş sağlamak için bu özelliği SDK entegrasyonunuzda etkinleştirebilirsiniz. Bu kılavuzda, IMA SDK ile medya önceden yükleme uygulamasının teknik ayrıntıları açıklanmaktadır.

Önceden yüklemeyi etkinleştir

Önceden yüklemeyi etkinleştirmek için AdsRenderingSettings.enablePreloading değerini true olarak ayarlayın. Bu, ADS_MANAGER_LOADED etkinliğinin bir sonucu olarak yapılmalıdır:

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

Zamanlama

Aşağıdaki tabloda, önceden yükleme etkinleştirildiğinde reklam yükleme zamanlamasında yapılan değişiklikler özetlenmektedir:

Etkinlik	Önceden Yüklemeli	Önceden Yüklemesiz
Reklam VAST istendi	AdsLoader.requestAds()	AdsLoader.requestAds()
Videodan önce yüklenen reklam (tek reklam)	AdsManager.init()	AdsManager.start()
Videodan önce gösterilen reklam yüklendi (VMAP/Reklam kuralları)	AdsManager.init()	AdsManager.init()
Videonun ortasında veya videodan sonra gösterilen reklam yüklendi	Reklam arasındaki ilk reklam için, reklam başlangıç zamanından 8 saniye önce. Birbirini izleyen reklamlarda, önceki reklam oynatılmaya başladığında.	Reklam başlangıç zamanı.

Sınırlamalar

Önceden yükleme aşağıdaki sınırlamalara tabidir:

• Medya önceden yükleme özelliği, iOS cihazlardaki mobil web'de veya bağlı akıllı TV'lerde HTML5 IMA SDK kullanılırken kullanılamaz.
• VPAID önceden yüklenir, ancak reklam yürütülene kadar reklamın bağımlılıklarının hiçbiri (bu reklam tarafından oynatılan medya dahil) yüklenmez.
• VMAP reklamlarının önceden yüklenmesi için otomatik oynatma etkinleştirilmelidir. settings.isAutoPlayAdBreaks() öğesinin, varsayılan değer olan true olarak ayarlandığından emin olun.
• Videodan sonra gösterilen reklamlar, videonun ortasında gösterilen son reklamdan sonra veya süreyi ayarlamak için AdsRequest.contentDuration kullanılıyorsa içeriğin bitiminden 8 saniye önce önceden yüklenir.

SSS

Medya önceden yükleme, reklam öğesinin tamamını yüklüyor mu?

Hayır. Reklam oynatılmaya başladığında reklam öğesi genellikle tam olarak yüklenmez. Önceden yükleme, reklamın yüklenmesi için gereken süreyi en aza indirerek kullanıcı deneyimini iyileştirmek amacıyla tasarlanmıştır. Çevrimdışı reklam sunmayı desteklemek için tasarlanmamıştır. IMA SDK, kullanıcının internet bağlantısı ve reklam öğesinin boyutuyla sınırlı olmak üzere, tarayıcının izin verdiği kadar medyayı yükler.

Medya önceden yüklemenin, medyanın yanı sıra reklamın VAST için de etkinleştirilmesi gerekir mi?

Hayır. SDK, bu önceden yükleme ayarından bağımsız olarak her zaman reklamın VAST'ını önceden yükler.