Włączanie kreacji JavaScript VPAID 2

Pakiet IMA HTML5 SDK obsługuje kreacje VPAID 2 JavaScript. W przypadku włączenia obsługi, należy pamiętać o 2 głównych różnicach między specyfikacją VPAID 2 a sposobem, w jaki pakiet IMA SDK obsługuje VPAID 2. Te różnice nie mają wpływu na kod implementacji odtwarzacza ani pakietu SDK, ale są ważne dla autorów kreacji VPAID 2 JavaScript, ponieważ kreacje mogą zgłaszać błędy lub nie działać zgodnie z oczekiwaniami, gdy są renderowane przez pakiet IMA HTML5 SDK.

Wymagania wstępne

Aby korzystać z tego przewodnika, zacznij od aplikacji, która ma:

  • odtwarzacz wideo HTML5 z zintegrowanym pakietem IMA HTML5 SDK; jeśli go nie masz, przeczytaj artykuł Konfigurowanie pakietu IMA SDK.
  • adres URL tagu reklamy VAST, który wskazuje kreację VPAID 2 JavaScript.

Przydatne informacje

  • Jeśli nie znasz standardu VPAID 2, możesz dowiedzieć się więcej na stronie IAB VPAID.

Włączanie obsługi VPAID 2

Aby włączyć obsługę VPAID 2 JavaScript, przed zainicjowaniem AdDisplayContainerwywołaj tę metodę:

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

Dostępne tryby VPAID:

  • ENABLED – umożliwia wyświetlanie reklam VPAID z ustawieniami domyślnymi.
  • INSECURE – umożliwia wyświetlanie reklam VPAID w trybie niezabezpieczonym. Więcej informacji znajdziesz w artykułach Bezpieczeństwo iframe i Element proxy odtwarzacza wideo.
  • DISABLED – reklamy VPAID nie są odtwarzane. Jeśli żądana reklama zwraca kreację VPAID, zgłaszany jest błąd.

Więcej informacji o trybach VPAID znajdziesz w dokumentacji API dotyczącej ImaSdkSettings.VpaidMode.

Ograniczenia dotyczące obsługi VPAID 2

Bezpieczeństwo iframe

Domyślnie pakiet IMA SDK używa bezpiecznego elementu iframe zamiast elementu friendly iframe (w tej samej domenie) lub skryptu na stronie do renderowania kreacji VPAID 2 JavaScript. Oznacza to, że jeśli kreacja oczekuje dostępu do DOM strony nadrzędnej, może to spowodować błąd. Aby zamiast tego renderować reklamę w elemencie friendly iframe, możesz użyć ImaSdkSettings.setVpaidMode(...) w ten sposób:

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

Element proxy odtwarzacza wideo

Ze względu na bezpieczeństwo i prawidłowe działanie na urządzeniach mobilnych w trybie ENABLED pakiet IMA HTML5 SDK nie udostępnia reklamy rzeczywistego elementu wideo. Zamiast tego udostępnia element proxy, który naśladuje większość funkcji zwykłego elementu wideo. W przypadku kreacji reklamowych, które wywołują tylko obsługiwane metody interfejsu API, nie powinny wystąpić żadne zmiany w renderowaniu kreacji. W trybie VpaidMode.INSECURE pakiet SDK udostępnia element odtwarzacza wideo zamiast elementu proxy.

Oto metody, odbiorniki i atrybuty dostępne w elemencie proxy wideo:

Metody

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

Typy zdarzeń dla addEventListener

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

Atrybuty

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

Najczęstsze pytania

Czy kreacje VPAID 2 JavaScript są obsługiwane w pakietach iOS SDK lub Android SDK?
Pakiet IMA HTML5 SDK to jedyna platforma IMA SDK, która obsługuje kreacje VPAID 2 JavaScript.
Czy to włącza kreacje VPAID w pakiecie IMA HTML5 SDK?
Tak, pakiet IMA HTML5 SDK obsługuje kreacje VPAID 2 JavaScript.