Włączanie kreacji JavaScript VPAID 2

Pakiet IMA HTML5 SDK obsługuje kreacje VPAID 2 JavaScript. Włączając obsługę, 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 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 pakietu SDK IMA, zapoznaj się z artykułem Konfigurowanie pakietu SDK IMA.
  • Adres URL tagu reklamy VAST, który prowadzi do kreacji JavaScript VPAID 2.

Przydatne wprowadzenia

Włączanie obsługi VPAID 2

Aby włączyć obsługę JavaScript VPAID 2, 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 niezabezpieczonym trybie. 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, generowany jest błąd.

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

Ograniczenia obsługi VPAID 2

Bezpieczeństwo 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 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ędu na bezpieczeństwo i prawidłowe działanie na urządzeniach mobilnych w 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 JavaScript VPAID 2 są obsługiwane w pakietach SDK na iOS i Androida?
Pakiet IMA SDK w HTML5 to jedyna platforma IMA SDK, która obsługuje kreacje VPAID 2 w JavaScript.
Czy ta funkcja włącza kreacje VPAID w pakiecie IMA HTML5 SDK?
Tak, pakiet IMA HTML5 SDK obsługuje kreacje VPAID 2 w JavaScript.