Pakiet Google Interactive Media Ads (IMA) SDK w 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 wiadomościach z kreacji do graczy
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 z kreacji. |
getMediaState |
Zwraca bieżący stan odtwarzacza multimediów, w tym identyfikator URI, currentTime, duration, volume i stan wyciszenia. |
log |
Przekazuje komunikaty dziennika kreacji do pakietu IMA SDK na potrzeby debugowania. |
reportTracking |
Pakiet IMA SDK wysyła pingi do adresów URL śledzenia w imieniu kreacji. |
requestChangeAdDuration |
Żądania zmiany łącznego czasu trwania sesji reklamowej. |
requestNavigation |
Wysyła żądanie przejścia do zewnętrznego identyfikatora URI. |
requestPause |
Wysyła do pakietu IMA SDK żądanie wstrzymania odtwarzacza multimediów. |
requestPlay |
Żądania, aby pakiet IMA SDK wznowił lub odtworzył odtwarzacz multimediów. |
requestResize |
Żądania zmiany rozmiaru odtwarzacza. Jeśli odtwarzacz umożliwia zmianę rozmiaru, pakiet IMA SDK zmienia jego rozmiar. |
requestSkip |
Żądania, aby pakiet SDK pominął bieżącą reklamę. |
requestStop |
Żądania, aby pakiet SDK zatrzymał sesję reklamową. |
handleSkipShown |
Informuje pakiet IMA SDK, że kreacja wyświetliła interfejs pomijania reklamy. |
requestFocus |
Żąda ustawienia fokusu na elemencie iframe kreacji. |
Sprawdzanie wiadomości z nieobsługiwanymi kreacjami do odtwarzacza
Pakiet IMA SDK nie obsługuje tych typów CreativeMessage:
requestChangeVolumerequestFullscreenrequestExitFullscreen
Informacje o wiadomościach od graczy do twórców
W tabeli poniżej znajdziesz listę wiadomości, które pakiet IMA SDK może wysyłać do kreacji SIMID:
| Wiadomość | Opis |
|---|---|
init |
Wysyłany podczas konfigurowania sesji z danymi o środowisku i parametrami reklamy. |
startCreative |
Informuje kreację o konieczności zainicjowania i wyświetlenia elementu iframe kreacji. |
adStopped |
Powiadamia o zakończeniu sesji reklamowej, podając kod przyczyny. |
adSkipped |
Informuje kreację, że użytkownik lub pakiet IMA SDK pominął reklamę. |
resize |
Powiadamia kreację o zmianach wymiarów odtwarzacza lub filmu. |
appBackgrounded |
Informuje kreację, że aplikacja została przeniesiona w tle. |
appForegrounded |
Informuje kreację, że aplikacja wróciła na pierwszy plan. |
fatalError |
Powiadamia kreację o błędzie po stronie odtwarzacza. |
log |
Wysyła do kreacji komunikaty dziennika z odtwarzacza. |
focusIn |
Powiadamia, że kreacja została zaznaczona. |
Sprawdzanie aktualizacji stanu multimediów
Pakiet IMA SDK wysyła do kreacji mediaStateUpdate komunikaty w przypadku tych zdarzeń:
playpausestalled(buffering – buforowanie)seekingseekedendeddurationchangetimeupdate, okresowo.volumechange, w tym stan wyciszenia.