VPAID 2 JavaScript reklam öğeleri

IMA HTML5 SDK'sı VPAID 2 JavaScript reklam öğelerini destekler. Desteği etkinleştirmek kolaydır ancak VPAID 2 spesifikasyonu ile IMA SDK'nın VPAID 2'yi destekleme şekli arasında dikkat edilmesi gereken iki fark vardır. Bu farklılıklar, oynatıcıyı veya SDK uygulama kodunu etkilemez, ancak reklam öğeleri IMA HTML5 SDK tarafından oluşturulduklarında hatalara neden olabileceğinden veya beklendiği gibi çalışmayabileceğinden, VPAID 2 JavaScript reklam öğesi yazarları için önemlidir.

Ön koşullar

  • IMA HTML5 SDK entegre HTML5 video oynatıcı. Google Hesabınız yoksa Başlangıç kılavuzumuza göz atın.
  • VPAID 2 JavaScript reklam öğesine işaret eden bir VAST reklam etiketi URL'si.

Faydalı yardımcı öneriler

VPAID 2 desteğini etkinleştirme

VPAID 2 JavaScript desteğini etkinleştirmek için AdDisplayContainer öğenizi 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ı aşağıdaki gibidir:

  • ENABLED - Varsayılan ayarlarla VPAID reklamlarına izin verir.
  • INSECURE - Güvenli olmayan modda VPAID reklamlarına izin verir. Daha fazla bilgi için IFrame güvenliği ve Video oynatıcı proxy öğesi konularına bakın.
  • DISABLED - VPAID reklamları oynatılmıyor. İstenen bir reklam VPAID reklam öğesi döndürürse bir hata verilir.
ziyaret edin. VPAID modları hakkında daha fazla bilgi için ImaSdkSettings.VpaidMode ile ilgili API dokümanlarına bakın.

VPAID 2 desteği ile ilgili uyarılar

IFrame güvenliği

Varsayılan olarak IMA SDK, VPAID 2 JavaScript reklam öğelerini oluşturmak için uygun iframe (aynı alan adı) yerine güvenli iframe veya sayfa içi komut dosyası kullanır. Bu durum, bir reklam öğesinin üst sayfanın DOM'sine erişmeyi beklediği durumlarda bir hataya neden olabileceği anlamına gelir. Bunun yerine reklamınızı uygun bir iframe'de oluşturmak için ImaSdkSettings.setVpaidMode(...) öğesini aşağıdaki şekilde kullanabilirsiniz: 

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

Video oynatıcı proxy öğesi

IMA HTML5 SDK, güvenlik ve doğru mobil işlevsellik için ENABLED modunda 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 öğeleri için reklam öğelerinin oluşturulmasında herhangi bir davranış değişikliği olmamalıdır. VpaidMode.INSECURE modunda SDK, proxy yerine video oynatıcı öğesini sağlar.

Video proxy öğesinde bulunan yöntemler, işleyiciler 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'sı, şu anda VPAID 2 JavaScript reklam öğelerini destekleyen tek IMA SDK platformudur.
Bu, IMA HTML5 SDK'sındaki VPAID reklam öğelerini etkinleştirir mi?
Evet, IMA HTML5 SDK'sı VPAID 2 JavaScript reklam öğelerini destekler.