На этой странице представлена общая информация о поддержке и совместимости IMA SDK для HTML5 на стороне клиента с браузерами, форматами видео и платформами.
Поддерживаемые форматы видео и браузеры
Поддержка различных функций в разных браузерах отличается, и нет единого формата видео по умолчанию, который поддерживался бы всеми основными браузерами. Три основных формата видео, используемых в большинстве браузеров, – это H.264, WebM и Ogg Theora.
Поддерживаемые видеопроигрыватели
Большинство функций IMA поддерживается стандартными видеопроигрывателями HTML5, в том числе тегом HTML <video>. Список известных видеопроигрывателей с поддержкой IMA SDK можно найти в статье Программа партнеров по видеотехнологиям.
Совместимость событий VAST
В этом разделе перечислены события VAST, которые автоматически передаются на сервер на основе информации, возвращенной в ответе VAST.
Полностью поддерживается
complete, creativeView,
firstQuartile, impression, midpoint,
pause, resume, rewind (срабатывает при любой значительной перемотке назад), start,
thirdQuartile.
Частично поддерживается
clickСобытие
Clickотправляется только для видеообъявлений. Клики не регистрируются во встроенных полноэкранных проигрывателях на устройствах Android и iOS, а также на компьютерах. Однако клики могут регистрироваться элементом отслеживания кликов на странице, когда видео закрыто. Однако если в элементе видео используются нативные элементы управления на iPad, клики не регистрируются.fullscreen
IMA SDK поддерживает симулированный полноэкранный режим, в котором видео занимает все окно браузера. Видео считается полноэкранным, если его
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.
Ограничения для фреймворков JavaScript
При использовании фреймворка JavaScript, например React или AngularJS, с IMA HTML5 SDK необходимо учитывать некоторые особенности. Эти фреймворки часто перемещают элементы DOM, что может нарушить работу IMA, поскольку IMA ожидает, что DOM будет статичным при инициализации SDK. IMA поддерживает фреймворки JavaScript, если IMA инициализируется после того, как фреймворк завершит перемещение элементов DOM. В частности, элемент HTML5, переданный в качестве аргумента containerElement при создании AdDisplayContainer, не должен перемещаться после создания экземпляра.
Поддерживаемые платформы видеопроигрывателей
Google IMA SDK поддерживается на следующих платформах:
| Платформа | Версия | Тип объявления |
|---|---|---|
| HTML5 | Компьютеры: Chrome, Firefox, Safari, Edge, Opera. Мобильные устройства: Chrome/Android Browser (Android для телефонов и планшетов), Safari и Chrome (iOS). |
Линейные видеообъявления, линейные медийные объявления, параллельные и сопутствующие объявления, решения Менеджера рекламы для видеорекламы, видеообъявления Ad Exchange и объявления AFV |
| iOS | iOS 10.0 и более поздние версии | Линейные и сопутствующие объявления, видеореклама в Менеджере рекламы и Ad Exchange, а также объявления AdSense для видео |
| Android | Android 4.4 или более поздней версии; | Линейные и сопутствующие объявления, видеореклама в Менеджере рекламы и Ad Exchange, а также объявления AdSense для видео |
| tvOS | tvOS 15 и более поздних версий; | Линейные объявления, видеообъявления Менеджера рекламы и Ad Exchange |
Функции видео и версии SDK
Подробнее о перечисленных ниже функциях читайте в статье Общие сведения о видеорекламе.
| HTML5, версия 3 | iOS версии 3 | Android версии 3 | tvOS | |
|---|---|---|---|---|
| IAB Video Suite | ||||
| VAST 4 |  9 |
9 |
9 |
9 |
| VAST 3; |  |
1 |
1 |
1 |
| VAST 2 | |
|
|
|
| SIMID 1.0 | |
|
|
 |
| VPAID 2 (HTML5) | |
|
|
|
| VMAP 1.0.1 | 2 3 |
2 |
2 |
2 |
| OM SDK 1.3 | |
|
|
|
| Функции Менеджера рекламы для работы с видео | ||||
| Линейные объявления | |
|
|
|
| Линейные медийные объявления |
|
|
|
|
| Объекты, размещенные на YouTube | 4 |
|
|
|
| Параллельные объявления (оверлеи) | 5 |
|
|
|
| Сопутствующие объявления | |
|
|
|
| Альтернативные ресурсы сопутствующих объявлений VAST 3 | |
|
|
|
| Видимость Active View | |
|
|
|
| Аудиообъявления | |
|
|
|
| Переадресация VAST | |
|
|
|
| Заполнение сопутствующего креатива с запросом медийного объявления | |
|
|
|
| Совместимость с тегом Google Publisher Tag (GPT) | |
|
|
|
| Осведомленность о контенте | |
|
|
|
| Правила для объявлений | 3 |
|
|
|
| Рекламные паузы, заданные вручную в правилах для объявлений |
|
|
|
|
| Ограничение частоты показа 6 | |
|
|
|
| Конкурентные исключения (трансляция) | |
|
|
|
| Конкурентные исключения (пакет) | |
|
|
|
| Конкурентные исключения (вся страница) | |
|
|
|
| Пакеты объявлений | 3 |
|
|
|
| Заставки | |
|
|
|
| Отчеты об отслеживании нескольких событий | |
|
|
|
| Динамическое размещение (AdSense для видео, Ad Exchange в Менеджере рекламы) | |
|
|
|
| С возможностью пропуска (не TrueView) 8 | 5 |
|
|
|
| In-Stream Select | |
|
|
|
| Предзагрузка объектов | 7 |
|
|
|
| Функции AdSense для видео | ||||
| TrueView In-Stream | 5 |
|
|
|
| In-Stream Select | |
|
|
|
| Стандартное объявление In-Stream | |
|
|
|
| Полный слот | |
|
|
|
| Сопутствующие объявления | |
|
|
|
| Заполнение сопутствующего креатива | |
|
|
|
| Наложения | 5 |
|
|
|
| Предзагрузка объектов | 7 |
|
|
|
| Функции Ad Exchange в Менеджере рекламы | ||||
| TrueView In-Stream | 5 |
|
|
|
| In-Stream Select | |
|
|
|
| Стандартное объявление In-Stream | |
|
|
|
| Полный слот | |
|
|
|
| Сопутствующие объявления | |
|
|
|
| Заполнение сопутствующего креатива | |
|
|
|
| Наложения | 5 |
|
|
|
| Видимость Active View | |
|
|
|
| Предзагрузка объектов | 7 |
|
|
|
| Почему я вижу эту рекламу? | |
|
|
|
1 Следующие функции VAST 3.0 пока не поддерживаются в SDK, не предназначенных для HTML5:
- Сопутствующий креатив
adSlotId - Способы показа сопутствующих объявлений
- Значки.
2 Следующие функции VMAP пока не поддерживаются:
- События отслеживания, относящиеся к VMAP
- Коды ошибок, относящиеся к VMAP
- Оверлеи
- Смещения по времени, отличные от чч:мм:сс, start и end.
- Атрибут "
breakType" repeatAfterатрибут
3 Для поддержки VMAP и правил для объявлений на iPhone требуется специальное воспроизведение объявлений.
4 Креативы, размещенные на YouTube, поддерживаются на компьютерах, но не на мобильных сайтах.
5 Параллельные объявления (оверлеи), объявления с возможностью пропуска (не TrueView) и объявления TrueView In-Stream поддерживаются на мобильных сайтах HTML5 в iOS 10 и более поздних версиях, если используется
playsinline
.
6 Для работы правил для объявлений, ограничений частоты показов и конкурентных исключений требуются файлы cookie или PPID.
7 Предварительная загрузка объектов нативных объявлений не работает в следующих случаях:
- Мобильные сайты на устройствах iOS
- Мобильные сайты на устройствах Android до версии 4.0
- Объявления, размещенные на YouTube, включая форматы TrueView.
-
Функция IMA для воспроизведения рекламных пауз вручную (любая реализация, основанная на событии
AD_BREAK_READY).
8 SDK не поддерживает объявления с возможностью пропуска, которые длятся менее 8 секунд. Если длительность объявления меньше минимальной, кнопка Пропустить не показывается.
9 Из функций VAST 4, поддерживаемых Google Менеджером рекламы, IMA поддерживает следующие:
- VAST 4.2
- Поддержка стандарта безопасного взаимодействия с мультимедийным интерфейсом (Secure Interactive Media Interface Definition, SIMID)
- Появилась возможность работать с несколькими узлами
UniversalAdID.
- VAST 4.0
- AdID
- Основной файл
- Новые коды ошибок VAST
AdVerifications: поддержка
Устаревшие SDK
| Flash v2 | HTML5, версия 1 | Версия 1 для iOS | Версия 1 для Android | Google Cast v2 | |
|---|---|---|---|---|---|
| Функции Менеджера рекламы для работы с видео | |||||
| Линейные объявления | |
|
|
|
|
| Параллельные объявления | |
|
|
|
|
| Интерактивные объявления (VPAID 1.0) | |
|
|
|
|
| Переадресация (VAST 2.0) | |
|
|
|
|
| Автозаполнение сопутствующими креативами (AdSense для видео, Ad Exchange в Менеджере рекламы) | |
|
|
|
|
| Аудиообъявления | |
|
|
|
|
| Совместимость с тегом Google Publisher Tag (GPT) | |
|
|
|
|
| Ограничение частоты показов | |
|
|
|
|
| Конкурентные исключения (трансляция) | |
|
|
|
|
| Конкурентные исключения (пакет) | |
|
|
|
|
| Конкурентные исключения (вся страница) | |
|
|
|
|
| Осведомленность о контенте | |
|
|
|
|
| Правила для объявлений и рекламные паузы, заданные вручную в правилах для объявлений | |
|
|
|
|
| Пакеты объявлений | |
|
|
|
|
| Заставки | |
|
|
|
|
| Отслеживание нескольких событий для отчетов | |
|
|
|
|
| Динамическое размещение | |
|
|
|
|
| С возможностью пропуска | |
|
|
|
|
| In-Stream Select | |
|
|
|
|
| Функции AdSense для видео | |||||
| Текстовые объявления | |
|
|
|
|
| AdSense VAST In-Stream | |
|
|
|
|
| Оверлей AdSense | |
|
|
|
|
| С возможностью пропуска | |
|
|
|
|
| In-Stream Select | |
|
|
|
|
| Выбор пользователя (YouTube) | |
|
|
|
|
| Объявления F2F в Менеджере рекламы | |
|
|
|
|
| Функции Ad Exchange в Менеджере рекламы | |||||
| Линейные объявления | |
|
|
|
|