Поддержка и совместимость SDK

Выберите платформу: HTML5 Android iOS tvOS Cast Roku

На этой странице представлена общая информация о поддержке и совместимости IMA DAI с браузерами, видеоформатами и платформами.

Поддерживаемые форматы видео и браузеры

HTML5 – новый и постоянно развивающийся стандарт. В результате поддержка различных функций в браузерах различается, и нет единого формата видео по умолчанию, поддерживаемого всеми основными браузерами. Три основных видеоформата, используемых в большинстве браузеров, – это H.264, HLS и Dash.

Совместимость событий VAST

В этом разделе перечислены события VAST, которые автоматически передаются на сервер на основе информации, возвращенной в ответе VAST.

Полностью поддерживается

complete, creativeView, firstQuartile, impression, midpoint, pause, resume, rewind (срабатывает при любой значительной перемотке назад), start, thirdQuartile.

Частично поддерживается

  • click

    Событие Click отправляется только для видеообъявлений. Встроенные полноэкранные проигрыватели на устройствах Android, iOS и компьютерах не позволяют отслеживать клики, но это можно делать с помощью элемента отслеживания кликов на странице, когда видео закрыто. Однако если в видеоэлементе используются встроенные элементы управления на iPad, клики не регистрируются.

  • fullscreen

    IMA поддерживает симулированный полноэкранный режим, в котором видео занимает все окно браузера. IMA считает, что видео находится в полноэкранном режиме, если его параметры offsetWidth и offsetHeight не меньше размера тела документа. Этот режим поддерживается во всех браузерах.

    На iPhone и платформах Android до версии 3.0 видео всегда воспроизводится в полноэкранном режиме.

  • mute, unmute

    На устройствах iOS и Android громкость регулируется только встроенными средствами. Поэтому IMA не может определить громкость или статус отключения звука, а SDK не получает уведомления об изменениях. Ниже приведен список версий браузеров, которые поддерживают и не поддерживают mute, unmute.

    • Поддерживаемые браузеры: Firefox 3.5+, Chrome 8+, Safari 4+.
    • Не поддерживаются: iOS, Android.

Дополнительную информацию о показе объявлений VAST можно найти в руководстве IAB.

События объявлений при повторном просмотре рекламных пауз

IMA не запускает события объявлений при повторном просмотре рекламы по следующим причинам:

  • URL событий должны активироваться только один раз, иначе это может быть расценено как спам.
  • Это позволяет пользователям перематывать видео в пределах рекламных пауз, которые они уже видели, что делает просмотр удобнее.

При повторном просмотре рекламной паузы регистрируются только следующие события:

  • AD_PERIOD_STARTED
  • AD_PERIOD_ENDED

Поддерживаемые платформы видеопроигрывателей

Google IMA SDK поддерживается на следующих платформах:

Платформа Версия
HTML5 Компьютер: Chrome, Firefox, Safari, Edge, Opera
Мобильное устройство: Chrome/браузер Android (Android для телефонов и планшетов), Safari и Chrome (iOS)
iOS iOS 10.0 и более поздние версии
Android Android 4.4 или более поздней версии;
Google Cast Все устройства для трансляции
tvOS tvOS 15 и более поздние версии
Roku Все устройства, которые по-прежнему получают обновления ПО от Roku.

Поддержка форматов видеопотока

IMA SDK поддерживает форматы HLS и DASH. Поддержка отдельных платформ SDK указана в таблице ниже. Чтобы трансляция воспроизводилась корректно, видеопроигрыватель должен поддерживать используемый тип потока.

Платформа IMA SDK HLS; DASH
HTML5 Флажок Флажок
iOS Флажок Red-X
Android Флажок Флажок
Google Cast Флажок Флажок
tvOS Флажок Red-X
Roku Флажок Флажок

Функции видео и версии SDK

Чтобы узнать больше о перечисленных ниже функциях, ознакомьтесь с обзором видеорекламы.

IAB Video Suite Поддержка
VAST 4 Предупреждение 1
VAST 3 Предупреждение 2
VAST 2 Флажок
VPAID 2 Red-X
VMAP 1.0.1 Предупреждение 3
Функции Менеджера рекламы для видео Поддержка
Линейные объявления Флажок
Параллельные объявления (оверлеи) Red-X
Сопутствующие объявления Предупреждение 4
Альтернативные ресурсы сопутствующих объявлений VAST 3 Red-X
Видимость Active View Флажок
Переадресация VAST Флажок
Заполнение сопутствующего креатива с помощью запроса медийного объявления Red-X
Совместимость с тегом Google Publisher Tag (GPT) Red-X
Осведомленность о контенте Red-X
Правила для объявлений Флажок
Пакетирование Флажок
Заставки Флажок
Отчеты об отслеживании нескольких событий Флажок
С возможностью пропуска (резервирование, не TrueView) Предупреждение 5
Функции AdSense для видео 7 Поддержка
TrueView In-Stream Предупреждение 6
In-Stream Select Флажок
Стандартное объявление In-Stream Флажок
Полный слот Red-X
Сопутствующие объявления Предупреждение 4
Заполнение сопутствующих объявлений Red-X
Наложения Red-X
Функции Ad Exchange в Менеджере рекламы Поддержка
TrueView In-Stream Предупреждение 6
In-Stream Select Флажок
Стандартное объявление In-Stream Флажок
Полный слот Red-X
Сопутствующие объявления Предупреждение 4
Заполнение сопутствующих креативов Red-X
Наложения Red-X
Видимость Active View Флажок
Почему я вижу эту рекламу? Предупреждение 8

1 Из функций VAST 4, поддерживаемых Google Менеджером рекламы, IMA поддерживает следующие:

2 В настоящее время не поддерживаются следующие функции VAST 3.0:

  • Дополнительное приложение adSlotId
  • Способы показа сопутствующих объявлений
  • Значки.

3 Следующие функции VMAP пока не поддерживаются:

  • События отслеживания, относящиеся к VMAP
  • Коды ошибок, относящиеся к VMAP
  • Оверлеи
  • Смещение по времени, отличное от hh:mm:ss, или значения "start" и "end"
  • Показать атрибут breakType
  • repeatAfter атрибут

4 Поддерживаются только сопутствующие графические креативы. Для заполнения объявлений изображениями-компаньонами требуется специальная реализация. Сопутствующие объявления не поддерживаются на tvOS.

5 Обычные объявления с возможностью пропуска поддерживаются только в IMA DAI SDK для HTML5, iOS, tvOS, Roku и Android (включая Android TV). При использовании Cast SDK необходимо объявить возможность пропуска с помощью StreamRequest.senderCanSkip, чтобы поддерживать традиционные объявления с возможностью пропуска.

6 Объявления TrueView с возможностью пропуска поддерживаются в IMA DAI SDK для HTML5, iOS, tvOS, Roku и Android (включая Android TV).

7. Функции AdSense не поддерживаются в Cast SDK.

8 Для функции Почему я вижу эту рекламу? требуется, чтобы при создании StreamManager передавался параметр adUiElement. Функция Почему я вижу эту рекламу? не поддерживается в Cast SDK.

Особенности использования фреймворков JavaScript

При использовании IMA HTML5 SDK с фреймворком JavaScript, например React или AngularJS, необходимо учитывать некоторые особенности. Такие фреймворки часто перемещают элементы DOM, что может нарушить работу IMA SDK, поскольку он ожидает, что DOM будет статичным при инициализации. IMA SDK поддерживает фреймворки JavaScript, если SDK инициализируется после того, как фреймворк завершит перемещение элементов DOM. В частности, элемент HTML5, переданный в качестве аргумента adUiElement при создании StreamManager, нельзя перемещать после его инициализации.