Pakiet Google Interactive Media Ads (IMA) SDK dla HTML5 obsługuje specyfikację Secure Interactive Media Interface Definition (SIMID) w wersji 1.1. Ten przewodnik zawiera informacje o konkretnych funkcjach i komunikatach SIMID obsługiwanych przez pakiet IMA SDK.
Informacje o komunikatach wysyłanych przez kreację do odtwarzacza
W tabeli poniżej znajdziesz listę wiadomości, które kreacja SIMID może wysyłać do pakietu IMA SDK:
| Wiadomość | Opis |
|---|---|
clickThru |
Obsługuje kliknięcia reklam na podstawie identyfikatora URI podanego przez kreację. |
fatalError |
Kończy sesję reklamową i zgłasza błąd krytyczny kreacji. |
getMediaState |
Zwraca bieżący stan odtwarzacza multimediów, w tym identyfikator URI, currentTime, czas trwania, głośność i stan wyciszenia. |
log |
Przekazuje komunikaty logu kreacji do pakietu IMA SDK na potrzeby debugowania. |
reportTracking |
Wysyła do pakietu IMA SDK żądanie pingowania linków monitorujących w imieniu kreacji. |
requestChangeAdDuration |
Żądania zmiany łącznego czasu trwania sesji reklamowej. |
requestNavigation |
Żąda przejścia do zewnętrznego identyfikatora URI. |
requestPause |
Wysyła do pakietu IMA SDK żądanie wstrzymania odtwarzacza multimediów. |
requestPlay |
Wysyła do pakietu IMA SDK żądanie wznowienia lub odtworzenia odtwarzacza multimedialnego. |
requestResize |
Żądania zmiany rozmiaru odtwarzacza. Jeśli odtwarzacz zezwala na zmianę rozmiaru, pakiet IMA SDK zmienia rozmiar odtwarzacza. |
requestSkip |
Wysyła do pakietu SDK żądanie pominięcia bieżącej reklamy. |
requestStop |
Wysyła do pakietu SDK żądanie zatrzymania sesji reklamowej. |
handleSkipShown |
Powiadamia pakiet IMA SDK, że kreacja wyświetliła interfejs pomijania reklamy. |
requestFocus |
Żąda zaznaczenia elementu iframe kreacji. |
Sprawdzanie komunikatów o nieobsługiwanych kreacjach wysyłanych do odtwarzacza
Pakiet IMA SDK nie obsługuje tych typów CreativeMessage:
requestChangeVolumerequestFullscreenrequestExitFullscreen
Informacje o komunikatach odtwarzacza do kreacji
W tabeli poniżej znajdziesz listę komunikatów, które pakiet IMA SDK może wysyłać do kreacji SIMID:
| Wiadomość | Opis |
|---|---|
init |
Wysyłane podczas konfigurowania sesji z danymi o środowisku i parametrami reklamy. |
startCreative |
Powiadamia kreację, aby zainicjowała i wyświetliła element iframe kreacji. |
adStopped |
Powiadamia o zakończeniu sesji reklamowej i podaje kod przyczyny. |
adSkipped |
Powiadamia kreację, że użytkownik lub pakiet IMA SDK pominął reklamę. |
resize |
Powiadamia kreację o zmianach wymiarów odtwarzacza lub filmu. |
appBackgrounded |
Powiadamia kreację, że aplikacja przeszła do działania w tle. |
appForegrounded |
Powiadamia kreację, że aplikacja powróciła na pierwszy plan. |
fatalError |
Powiadamia kreację o błędzie po stronie odtwarzacza. |
log |
Wysyła komunikaty logu z odtwarzacza do kreacji. |
focusIn |
Powiadamia, że kreacja została zaznaczona. |
Sprawdzanie aktualizacji stanu multimediów
Pakiet IMA SDK wysyła do kreacji wiadomości mediaStateUpdate w przypadku tych zdarzeń:
playpausestalled(buffering – buforowanie)seekingseekedendeddurationchangetimeupdate, okresowo.volumechange, w tym stan ignorowania.