Włączanie kreacji JavaScript VPAID 2

Pakiet IMA HTML5 SDK obsługuje kreacje VPAID 2 JavaScript. Włączając obsługę, musisz 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ą generować błędy lub nie działać zgodnie z oczekiwaniami, gdy są renderowane przez pakiet IMA HTML5 SDK.

Wymagania wstępne

Aby skorzystać z tego przewodnika, zacznij od aplikacji, która ma te elementy:

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

Przydatne wprowadzenia

Włączanie obsługi VPAID 2

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

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 elementu iframe i Element proxy odtwarzacza wideo.
  • DISABLED – reklamy VPAID nie są odtwarzane. Jeśli żądana reklama zwraca kreację VPAID, występuje błąd.

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

Ograniczenia obsługi VPAID 2

Zabezpieczenia elementu 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 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 elemencie friendly iframe, możesz użyć tagu ImaSdkSettings.setVpaidMode(...) w ten sposób:

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

Element zastępczy odtwarzacza wideo

Ze względów bezpieczeństwa i prawidłowego działania na urządzeniach mobilnych w trybie ENABLED pakiet IMA SDK w HTML5 nie udostępnia reklamie rzeczywistego elementu wideo, ale element zastępczy, 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 powinno dojść do zmian w sposobie renderowania kreacji. W trybie VpaidMode.INSECURE pakiet SDK udostępnia element odtwarzacza wideo zamiast serwera 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 i Android SDK?
Pakiet IMA SDK w HTML5 to jedyna platforma IMA SDK, która obsługuje kreacje VPAID 2 w JavaScript.
Czy to włącza kreacje VPAID w pakiecie IMA HTML5 SDK?
Tak, pakiet IMA HTML5 SDK obsługuje kreacje VPAID 2 w JavaScript.