Kreacje JavaScript VPAID 2

Pakiet IMA HTML5 SDK obsługuje kreacje JavaScript VPAID 2. Włączanie obsługi jest proste, ale występują dwie różnice między specyfikacją VPAID 2 a sposobem, w jaki pakiet IMA SDK obsługuje VPAID 2. Różnice te nie mają wpływu na kod implementacji odtwarzacza ani pakietu SDK, ale są istotne dla autorów kreacji JavaScript VPAID 2, ponieważ kreacje podczas renderowania przez pakiet IMA HTML5 SDK mogą powodować występowanie błędów lub nie działać zgodnie z oczekiwaniami.

Wymagania wstępne

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

Przydatne materiały

Włączanie obsługi VPAID 2

Aby włączyć obsługę JavaScriptu VPAID 2, przed zainicjowaniem kontenera AdDisplayContainer wywołaj następującą 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 trybie niezabezpieczonego. Więcej informacji znajdziesz w sekcjach Zabezpieczenia iframe i Element proxy odtwarzacza wideo.
  • DISABLED – reklamy VPAID nie są odtwarzane. Jeśli żądana reklama zwraca kreację VPAID, pojawia się 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 to spowodować błąd. Aby wyrenderować reklamę w zaprzyjaźnionym elemencie iframe, możesz użyć polecenia ImaSdkSettings.setVpaidMode(...) w ten sposób: 

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

Element serwera proxy odtwarzacza wideo

Ze względów bezpieczeństwa i prawidłowej funkcjonalności mobilnej w trybie ENABLED pakiet IMA HTML5 SDK nie dostarcza do reklamy rzeczywistego elementu wideo. zawiera element pośredniczący, który naśladuje większość funkcji zwykłego elementu wideo. Renderowanie kreacji, które wywołują tylko obsługiwane metody interfejsu API, nie powinno się zmieniać w ich działaniu. W trybie VpaidMode.INSECURE pakiet SDK udostępnia element odtwarzacza wideo, a nie serwer proxy.

Oto metody, detektory i atrybuty dostępne w elemencie serwera proxy filmu:

Metody

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

Typy zdarzeń dla funkcji 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 w pakietach SDK na iOS i Androida?
Pakiet IMA HTML5 SDK to jedyna platforma IMA SDK, która obsługuje obecnie kreacje JavaScript VPAID 2.
Czy spowoduje to włączenie kreacji VPAID w pakiecie IMA HTML5 SDK?
Tak. Pakiet IMA HTML5 SDK obsługuje kreacje JavaScript VPAID 2.