SDK Google Interactive Media Ads (IMA) для HTML5 поддерживает Secure Interactive Media Interface Definition (SIMID) версии 1.1. В этом руководстве описаны конкретные функции и сообщения SIMID, поддерживаемые SDK IMA.
Понимание того, как креативные сообщения доносятся до игрока.
В таблице ниже перечислены сообщения, которые креатив SIMID может отправлять в SDK IMA:
| Сообщение | Описание |
|---|---|
clickThru | Обрабатывает клики по рекламе на основе URI, предоставленного креативом. |
fatalError | Завершает показ рекламы и сообщает о критической ошибке в рекламном материале. |
getMediaState | Возвращает текущее состояние медиаплеера, включая URI, текущее время, продолжительность, громкость и статус отключения звука. |
log | Пересылает креативные сообщения журнала в IMA SDK для отладки. |
reportTracking | Запрашивает у IMA SDK отправку уведомлений об отслеживании URL-адресов от имени рекламного материала. |
requestChangeAdDuration | Запросы на изменение общей продолжительности рекламной сессии. |
requestNavigation | Запрашивает переход по внешнему URI. |
requestPause | Запрашивает у IMA SDK приостановку воспроизведения медиаплеера. |
requestPlay | Запрашивает у IMA SDK возобновление или воспроизведение медиаплеера. |
requestResize | Запрос на изменение размера видеоплеера. Если плеер допускает изменение размера, IMA SDK изменяет размер плеера. |
requestSkip | Запрашивает у SDK пропуск текущей рекламы. |
requestStop | Запрашивает у SDK остановку рекламной сессии. |
handleSkipShown | Уведомляет IMA SDK о том, что в креативе отобразился интерфейс пропуска рекламы. |
requestFocus | Запрос на выделение места в iframe креатива. |
Проверьте сообщения для игроков, не поддерживающие поддержку креативов.
IMA SDK не поддерживает следующие типы CreativeMessage :
-
requestChangeVolume -
requestFullscreen -
requestExitFullscreen
Понимание взаимодействия игрока и создателя контента
В таблице ниже перечислены сообщения, которые SDK IMA поддерживает для отправки на рекламный материал SIMID:
| Сообщение | Описание |
|---|---|
init | Отправляется во время настройки сессии вместе с данными об окружении и параметрами рекламы. |
startCreative | Уведомляет разработчика о необходимости инициализации и отображения iframe с креативным контентом. |
adStopped | Уведомляет о завершении рекламной сессии, включая код причины. |
adSkipped | Уведомляет рекламный материал о том, что пользователь или IMA SDK пропустили рекламу. |
resize | Уведомляет создателя контента об изменениях размеров проигрывателя или видео. |
appBackgrounded | Уведомляет разработчика о том, что приложение перешло в фоновый режим. |
appForegrounded | Уведомляет разработчика о том, что приложение вернулось на передний план. |
fatalError | Уведомляет разработчика о возникшей ошибке на стороне игрока. |
log | Отправляет сообщения журнала от игрока в творческий режим. |
focusIn | Уведомляет о том, что креатив получил фокус. |
Обзор обновлений состояния СМИ
IMA SDK отправляет сообщения mediaStateUpdate креативу для следующих событий:
-
play -
pause -
stalled(буферизация) -
seeking -
seeked -
ended -
durationchange -
timeupdate, периодически. -
volumechangeвключая статус отключения звука.