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 önceden yükleme uygulamaya ilişkin teknik ayrıntılar açıklanmaktadır.
Önceden yüklemeyi etkinleştir
Önceden yüklemeyi etkinleştirmek içinAdsRenderingSettings.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ındaki değişiklikler özetlenmiştir:
Etkinlik | Önceden Yüklemeli | Önceden Yüklenmemiş |
---|---|---|
Reklam VAST istendi | 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() |
Videonun ortasında gösterilen reklam veya videodan sonra gösterilen reklam yüklendi | Reklam arasındaki ilk reklam için, reklam başlangıç zamanından 8 saniye önce. Ardışık reklamlar için, ö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 işlemi, 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 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ı önceden yüklemek için otomatik oynatma etkinleştirilmelidir.
settings.isAutoPlayAdBreaks()
değerinin varsayılan değer olantrue
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 işlemi, reklam öğesinin tamamını yüklüyor mu?
- Hayır, reklam oynatma 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ştirmek için tasarlanmıştır. Çevrimdışı reklam sunumunu desteklemek için tasarlanmamıştır. IMA SDK, kullanıcının internet bağlantısı ve reklam öğesinin boyutuyla sınırlı olacak şekilde, tarayıcının izin verdiği kadar fazla medya yükler.
- Medyayı önceden yüklemenin, reklamın VAST ve medya için etkinleştirilmesi gerekir mi?
- Hayır, SDK bu önceden yükleme ayarından bağımsız olarak her zaman reklamın VAST'sini önceden yükler.