VPAID 2 JavaScript reklam öğelerini etkinleştirme

IMA HTML5 SDK, VPAID 2 JavaScript reklam öğelerini destekler. Destek etkinleştirilirken VPAID 2 spesifikasyonu ile IMA SDK'nın VPAID 2'yi destekleme şekli arasında bilinmesi gereken iki temel fark vardır. Bu farklılıklar oynatıcıyı veya SDK uygulama kodunu etkilemez ancak VPAID 2 JavaScript reklam öğesi yazarları için önemlidir. Çünkü reklam öğeleri, IMA HTML5 SDK'sı tarafından oluşturulduğunda hata verebilir veya beklendiği gibi çalışmayabilir.

Ön koşullar

Bu kılavuzu takip etmek için aşağıdaki özelliklere sahip bir uygulamayla başlayın:

  • IMA HTML5 SDK'sının entegre edildiği HTML5 video oynatıcı. Hesabınız yoksa IMA SDK'yı ayarlama başlıklı makaleyi inceleyin.
  • VPAID 2 JavaScript reklam öğesine yönlendiren bir VAST reklam etiketi URL'si.

Faydalı başlangıç kılavuzları

VPAID 2 desteğini etkinleştirme

VPAID 2 JavaScript desteğini etkinleştirmek için AdDisplayContainer'ınızı başlatmadan önce aşağıdaki yöntemi çağırın:

google.ima.settings.setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.ENABLED);
...
var adDisplayContainer = new google.ima.AdDisplayContainer(adContainerElement);
var adsLoader = new google.ima.AdsLoader(adDisplayContainer);
...

Kullanılabilir VPAID modları şunlardır:

  • ENABLED - Varsayılan ayarlarla VPAID reklamlarına izin verir.
  • INSECURE - Güvensiz modda VPAID reklamlarına izin verir. Daha fazla bilgi için IFrame güvenliği ve Video oynatıcı proxy öğesi başlıklı makaleleri inceleyin.
  • DISABLED - VPAID reklamları oynatılmıyor. İstenen bir reklam VPAID reklam öğesi döndürürse hata verilir.

VPAID modları hakkında daha fazla bilgi için ImaSdkSettings.VpaidMode API belgelerine bakın.

VPAID 2 desteğiyle ilgili uyarılar

IFrame güvenliği

Varsayılan olarak, IMA SDK, VPAID 2 JavaScript reklam öğelerini oluşturmak için güvenilir bir iframe yerine güvenli bir iframe (aynı alan) veya sayfa içi bir komut dosyası kullanır. Bu nedenle, bir reklam öğesi üst sayfanın DOM'una erişmeyi bekliyorsa hata oluşabilir. Reklamınızı uygun bir iframe'de oluşturmak için ImaSdkSettings.setVpaidMode(...) öğesini şu şekilde kullanabilirsiniz:

adsLoader.getSettings().setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.INSECURE);

Video oynatıcı proxy öğesi

Güvenlik ve uygun mobil işlevsellik için ENABLED modunda IMA HTML5 SDK, reklama gerçek video öğesini sağlamaz. Bunun yerine, normal video öğesinin işlevlerinin çoğunu taklit eden bir proxy öğesi sağlar. Yalnızca desteklenen API yöntemlerini çağıran reklam öğelerinde, reklam öğelerinin oluşturulmasında davranış değişikliği olmamalıdır. VpaidMode.INSECURE modunda, SDK proxy yerine video oynatıcı öğesini sağlar.

Video proxy öğesinde kullanılabilen yöntemler, dinleyiciler ve özellikler şunlardır:

Yöntemler

  • addEventListener
  • canPlayType
  • load
  • play
  • pause
  • setattribute

addEventListener için etkinlik türleri

  • abort
  • canplay
  • canplaythrough
  • click
  • durationchange
  • emptied
  • ended
  • error
  • loadeddata
  • loadedmetadata
  • loadstart
  • pause
  • play
  • playing
  • progress
  • ratechange
  • suspend
  • seeked
  • seeking
  • timeupdate
  • waiting

Özellikler

  • currentTime
  • duration
  • ended
  • paused
  • playbackRate
  • src
  • type

SSS

VPAID 2 JavaScript reklam öğeleri, iOS veya Android SDK'larında destekleniyor mu?
IMA HTML5 SDK, VPAID 2 JavaScript reklam öğelerini destekleyen tek IMA SDK platformudur.
Bu, IMA HTML5 SDK'sında VPAID reklam öğelerini etkinleştirir mi?
Evet, IMA HTML5 SDK'sı VPAID 2 JavaScript reklam öğelerini destekler.