Medyayı önceden yükleme

Platform seçin: HTML5 Android

IMA SDK, video reklam öğelerinin önceden yüklenmesini destekler. Reklamlar ve içerikler 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 ön yüklemesi uygulamanın teknik ayrıntıları ele alınmaktadır.

Önceden yüklemeyi etkinleştirme

Önceden yüklemeyi etkinleştirmek için AdsRenderingSettings.enablePreloading politikasını "true" olarak ayarlayın. Bu işlem, 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ındaki değişiklikler özetlenmektedir:

Etkinlik Önceden yükleme ile Önceden yükleme olmadan
Reklam VAST isteğinde bulunuldu AdsLoader.requestAds() AdsLoader.requestAds()
Videodan önce gösterilen reklam yüklendi (tek reklam) AdsManager.init() AdsManager.start()
Videodan önce gösterilen reklam yüklendi (VMAP/Reklam kuralları) AdsManager.init() AdsManager.init()
Ara reklam veya videodan sonra gösterilen reklam yüklendi Reklam arasının ilk reklamı için reklam başlangıç zamanından 8 saniye önce. Arka arkaya gösterilen reklamlarda, önceki reklam oynatılmaya başladığında. Reklam başlangıç zamanında.

Sınırlamalar

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

  • Medya önceden yükleme, iOS cihazlarda mobil web'de veya bağlı akıllı TV'lerde HTML5 IMA SDK'sı kullanılırken kullanılamaz.
  • VPAID önceden yüklenir ancak reklamın bağımlılıklarından hiçbiri (reklam tarafından oynatılan medya dahil) reklam yürütülene kadar yüklenmez.
  • VMAP reklamlarını önceden yüklemek için otomatik oynatma etkinleştirilmelidir. settings.isAutoPlayAdBreaks() değerinin, varsayılan değer olan true olarak ayarlandığından emin olun.
  • Videodan sonra gösterilen reklamlar, son ara reklamdan sonra veya süre 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ükler mi?
Hayır, reklam oynatılmaya başladığında reklam öğesi genellikle tam olarak yüklenmez. Önceden yükleme, reklamın yüklenme süresini en aza indirerek kullanıcı deneyimini iyileştirmeyi amaçlar. Ç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 medya yükler.
Medya önceden yüklemesinin, reklamın VAST'ı ve medya için etkinleştirilmesi gerekir mi?
Hayır, SDK, bu önceden yükleme ayarından bağımsız olarak reklamın VAST'ını her zaman önceden yükler.