VPAID 2 JavaScript reklam öğeleri

IMA HTML5 SDK'sı VPAID 2 JavaScript reklam öğelerini destekler. Desteğin etkinleştirilmesi 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şturulduğunda hata verebileceği veya beklendiği gibi çalışmayabileceğinden VPAID 2 JavaScript reklam öğesi yazarları için önemlidir.

Ön koşullar

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

Yararlı bilgiler

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ı şunlardır:

  • ENABLED - Varsayılan ayarlara sahip 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 reklam bir VPAID reklam öğesi döndürürse bir hata verilir.
VPAID modları hakkında daha fazla bilgi için ImaSdkSettings.VpaidMode API dokümanlarına bakın.

VPAID 2 desteği ile ilgili uyarılar

IFrame güvenliği

IMA SDK, VPAID 2 JavaScript reklam öğelerini oluşturmak için varsayılan olarak uygun bir iframe (aynı alan) veya sayfa içi komut dosyası yerine güvenli bir iframe kullanır. Bu, bir reklam öğesi üst sayfanın DOM'una erişmeyi bekliyorsa bir hataya neden olabilir. 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 düzgün mobil işlevsellik için ENABLED modunda IMA HTML5 SDK, reklama gerçek video öğesini sağlamaz; bunun yerine, normal video öğesinin işlevlerinin büyük kısmını taklit eden bir proxy öğesi sağlar. Yalnızca desteklenen API yöntemlerini çağıran reklam öğelerinde, 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 kullanılabilen 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 desteklenir mi?
IMA HTML5 SDK, şu anda 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 VPAID 2 JavaScript reklam öğelerini destekler.