IMA SDK, video reklam öğelerinin önceden yüklenmesini destekler. Reklamlar ile içerik arasında daha sorunsuz bir geçiş sağlamak için SDK entegrasyonunuzda bu özelliği etkinleştirebilirsiniz. Bu kılavuzda, IMA SDK ile medya ön yükleme özelliğini uygulamayla ilgili teknik ayrıntılar ele alınmaktadır.
Ön yüklemeyi etkinleştirme
Önceden yüklemeyi etkinleştirmek içinAdsRenderingSettings.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, ön yükleme etkinleştirildiğinde reklam yükleme zamanlamasında yapılan değişiklikler özetlenmektedir:
Etkinlik | Önceden Yükleme Özelliği | Önceden yükleme olmadan |
---|---|---|
Reklam VAST istendi | AdsLoader.requestAds() |
AdsLoader.requestAds() |
Videodan önce gösterilen reklam yüklü (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 yüklenir. | Reklam arasının ilk reklamı için reklamın başlama zamanından 8 saniye önce. Art arda yayınlanan reklamlarda, önceki reklam oynatılmaya başladığında. | Reklamın başlangıç zamanında. |
Sınırlamalar
Önceden yükleme aşağıdaki sınırlamalara tabidir:
- Medya ön yükleme özelliği, iOS cihazlardaki 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 hiçbir bağımlılığı (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 olantrue
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çeriğin bitiminden 8 saniye önce önceden yüklenir.
SSS
- Medya önceden yükleme özelliği reklam öğesinin tamamını yüklüyor mu?
- Hayır, reklam oynatılmaya başladığında reklam öğesi genellikle tam olarak yüklenmez. Ön yükleme, reklamın yüklenmesinin sürdüğü 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'sı, kullanıcının internet bağlantısı ve reklam öğesinin boyutuyla sınırlı olarak tarayıcının izin verdiği kadar medya yükler.
- Medya ön yüklemenin, reklamın VAST'ı ve medyası için etkinleştirilmesi gerekir mi?
- Hayır, SDK bu ön yükleme ayarından bağımsız olarak reklamın VAST'ını her zaman önceden yükler.