Medyayı önceden yükleme

Platform seçin: HTML5 Android

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 özelliğini uygulama ile ilgili teknik ayrıntılar ele alınmaktadır.

Önceden yüklemeyi etkinleştirme

Önceden yüklemeyi etkinleştirmek için AdsRenderingSettings.enablePreloading değerini true olarak ayarlayın. Bu işlem, ADS_MANAGER_LOADED etkinliği sonucunda 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 Özellikli Önceden Yükleme Olmadan
İstenen reklam VAST'ı AdsLoader.requestAds() AdsLoader.requestAds()
Videodan önce gösterilen reklam yüklendi (tek reklam) AdsManager.init() AdsManager.start()
Videonun başında 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ının ilk reklamı için reklamın başlangıç zamanından 8 saniye önce. Ardışık reklamlarda, önceki reklam oynatılmaya başladığında. Reklam başlangıç zamanında.

Sınırlamalar

Ön 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 kullanılırken kullanılamaz.
  • VPAID önceden yüklenir ancak reklam yürütülene kadar reklamın bağımlılıklarından 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() değerinin varsayılan değer olan true olarak ayarlandığından emin olun.
  • Videodan sonra gösterilen reklamlar, son videonun ortasında gösterilen reklamdan sonra veya süreyi ayarlamak için AdsRequest.contentDuration kullanılıyorsa içerik bitmeden 8 saniye önce önceden yüklenir.

SSS

Medya önceden yükleme, reklam öğesinin tamamını yükler mi?
Hayır, reklam oynatma 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ştirmeyi amaçlar. Çevrimdışı reklam yayınını desteklemek için tasarlanmamıştır. IMA SDK, tarayıcının izin verdiği ölçüde medyayı yükler. Bu yükleme, kullanıcının internet bağlantısı ve reklam öğesinin boyutuyla sınırlıdır.
Reklamın VAST'ı ve medya için önceden medya yükleme etkinleştirilmeli mi?
Hayır, SDK bu önceden yükleme ayarından bağımsız olarak reklamın VAST'ını her zaman önceden yükler.