Pakiet Google Interactive Media Ads (IMA) SDK w HTML5 obsługuje standard 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 od kreacji do gracza
W tabeli poniżej znajdziesz listę komunikatów, 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 wiadomości z logów kreacji do pakietu IMA SDK na potrzeby debugowania. |
reportTracking |
Wysyła do pakietu IMA SDK żądanie pingowania 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 użytkownika pomijania reklamy. |
requestFocus |
Wysyła żądanie ustawienia fokusu na ramkę iframe kreacji. |
Sprawdzanie komunikatów o nieobsługiwanych kreacjach w odtwarzaczu
Pakiet IMA SDK nie obsługuje tych CreativeMessage typów:
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 |
Powiadamia kreację o konieczności zainicjowania i wyświetlenia elementu iframe kreacji. |
adStopped |
Informuje, że sesja reklamy została zakończona, i zawiera 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 komunikaty dziennika z odtwarzacza do kreacji. |
focusIn |
Informuje, że kreacja została zaznaczona. |
Sprawdzanie aktualizacji stanu multimediów
Pakiet IMA SDK wysyła do kreacji komunikaty mediaStateUpdate w przypadku tych zdarzeń:
playpausestalled(buffering – buforowanie)seekingseekedendeddurationchangetimeupdate, okresowo.volumechangew tym stan wyciszenia.