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 dikkat edilmesi gereken iki temel fark vardır. Bu farklılıklar oynatıcıyı veya SDK uygulama kodunu etkilemez ancak reklam öğeleri IMA HTML5 SDK'sı tarafından oluşturulduğunda hatalara neden olabileceğinden ya da beklendiği gibi çalışmayabileceğinden VPAID 2 JavaScript reklam öğesi yazarları için önemlidir.

Ö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 öğesini işaret eden 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üvenli olmayan modda VPAID reklamlarına izin verir. Daha fazla bilgi için IFrame güvenliği ve Video oynatıcı proxy öğesi sayfalarını 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 dokümanlarına bakın.

VPAID 2 desteğiyle 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 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 aşağıdaki ş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'sı, VPAID 2 JavaScript reklamlarını 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.