Włączanie kreacji JavaScript VPAID 2

Pakiet IMA HTML5 SDK obsługuje kreacje JavaScript VPAID 2. Włączenie obsługi jest proste, ale należy pamiętać o 2 różnicach między specyfikacją VPAID 2 a sposobem obsługi tej specyfikacji przez pakiet IMA SDK. Te różnice nie wpływają na kod implementacji odtwarzacza ani pakietu SDK, ale są ważne dla autorów kreacji JavaScript VPAID 2, ponieważ kreacje mogą generować błędy lub nie działać zgodnie z oczekiwaniami, gdy są renderowane przez pakiet IMA HTML5 SDK.

Wymagania wstępne

  • Odtwarzacz wideo HTML5 z zintegrowanym pakietem IMA HTML5 SDK. Jeśli nie masz pakietu, zapoznaj się z artykułem Konfigurowanie pakietu IMA SDK.
  • Adres URL tagu reklamy VAST, który wskazuje na kreację JavaScript VPAID 2.

Przydatne informacje wstępne

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 – 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 zastępczy odtwarzacza wideo.
  • DISABLED – reklamy VPAID się nie wyświetlają. Jeśli żądana reklama zwróci kreację VPAID, zostanie zgłoszony błąd.
Więcej informacji o trybach VPAID znajdziesz w dokumentacji interfejsu API ImaSdkSettings.VpaidMode.

Zastrzeżenia dotyczące obsługi VPAID 2

Zabezpieczenie iframe

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

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

Element zastępczy odtwarzacza wideo

Ze względu na bezpieczeństwo i właściwe działanie na urządzeniach mobilnych w trybie ENABLED pakiet IMA HTML5 SDK nie udostępnia reklamie rzeczywistego elementu wideo. Zamiast tego udostępnia element zastępczy, który naśladuje większość funkcji normalnego elementu wideo. W przypadku kreacji reklam, które wywołują tylko obsługiwane metody interfejsu API, nie powinno być żadnych zmian w zachowaniu podczas renderowania kreacji. W trybie VpaidMode.INSECURE pakiet SDK udostępnia element odtwarzacza wideo zamiast elementu zastępczego.

Oto metody, słuchacze i atrybuty dostępne w elemencie zastępczym 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 JavaScript VPAID 2 są obsługiwane w pakietach SDK na iOS i Androida?
Pakiet IMA HTML5 SDK to jedyna platforma IMA SDK, która obecnie obsługuje kreacje JavaScript VPAID 2.
Czy to umożliwia wyświetlanie kreacji VPAID w pakiecie IMA HTML5 SDK?
Tak, pakiet IMA HTML5 SDK obsługuje kreacje JavaScript VPAID 2.