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