Kreacje JavaScript VPAID 2

Pakiet IMA HTML5 SDK obsługuje kreacje JavaScript VPAID 2. Włączenie obsługi jest łatwe, ale trzeba pamiętać o dwóch 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ą istotne dla autorów kreacji JavaScript VPAID 2, ponieważ kreacje renderowane przez pakiet IMA HTML5 SDK mogą powodować błędy lub nie działać zgodnie z oczekiwaniami.

Wymagania wstępne

  • Odtwarzacz wideo HTML5 ze zintegrowanym pakietem IMA HTML5 SDK. Jeśli go nie masz, zapoznaj się z przewodnikiem dla początkujących.
  • URL tagu reklamy VAST wskazujący kreację JavaScript VPAID 2.

Przydatne podkłady

Włączanie obsługi VPAID 2

Aby włączyć obsługę JavaScriptu VPAID 2, przed zainicjowaniem AdDisplayContainer wywoł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 – zezwala na reklamy VPAID z ustawieniami domyślnymi.
  • INSECURE – zezwala na reklamy VPAID w niezabezpieczonym trybie. Więcej informacji znajdziesz w artykułach Zabezpieczenia iframe i Element proxy odtwarzacza wideo.
  • DISABLED – reklamy VPAID nie są odtwarzane. Jeśli żądana reklama zwróci kreację VPAID, wystąpi błąd.
Więcej informacji o trybach VPAID znajdziesz w dokumentacji interfejsu API ImaSdkSettings.VpaidMode.

Zastrzeżenia dotyczące obsługi VPAID 2

Zabezpieczenia iframe

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

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

Element serwera proxy odtwarzacza wideo

Ze względu na bezpieczeństwo i prawidłowe działanie urządzeń mobilnych w trybie ENABLED pakiet IMA HTML5 SDK nie dostarcza rzeczywistego elementu wideo reklamy; zamiast tego udostępnia element proxy, który naśladuje większą część funkcjonalności zwykłego elementu wideo. Kreacje, które wywołują tylko obsługiwane metody interfejsu API, nie powinny się zmienić w sposobie renderowania kreacji. W trybie VpaidMode.INSECURE pakiet SDK udostępnia element odtwarzacza wideo, a nie serwer proxy.

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

Metody

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

Typy zdarzeń dla metody 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 JavaScript VPAID 2 są obsługiwane przez pakiety SDK na iOS lub Androida?
Pakiet IMA HTML5 SDK to jedyna platforma IMA SDK, która obsługuje obecnie kreacje JavaScript VPAID 2.
Czy to umożliwia włączenie kreacji VPAID w pakiecie IMA HTML5 SDK?
Tak. Pakiet IMA HTML5 SDK obsługuje kreacje JavaScriptu VPAID 2.