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

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

На этой странице приведена общая информация о поддержке и совместимости клиентской реализации 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

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

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

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

Платформа Версия Тип объявления
HTML5 Компьютер: Chrome, Firefox, Safari, Edge, Opera
Мобильное устройство: Chrome/браузер Android (Android для телефонов и планшетов), Safari и Chrome (iOS)
Линейные, нелинейные и сопутствующие объявления, Решения для видеорекламы в Менеджере рекламы, видеообъявления Ad Exchange и объявления AdSense для видео.
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 Флажок Флажок Флажок Red-X
VPAID 2 (HTML5) Флажок Red-X Red-X Red-X
VMAP 1.0.1 Предупреждение 2 3 Предупреждение 2 Предупреждение 2 Предупреждение 2
OM SDK 1.3 Флажок Флажок Флажок Red-X
Функции Менеджера рекламы для видео
Линейные объявления Флажок Флажок Флажок Флажок
Объекты, размещенные на YouTube Предупреждение 4 Red-X Red-X Red-X
Параллельные объявления (оверлеи) Предупреждение 5 Red-X Red-X Red-X
Сопутствующие объявления Флажок Флажок Флажок Red-X
Альтернативные ресурсы сопутствующих объявлений VAST 3 Флажок Флажок Red-X Red-X
Видимость Active View Флажок Флажок Флажок Red-X
Аудиообъявления Флажок Флажок Флажок Флажок
Переадресация VAST Флажок Флажок Флажок Флажок
Запасной вариант сопутствующего объявления с запросом медийного объявления Флажок Флажок Флажок Red-X
Совместимость с тегом Google Publisher Tag (GPT) Флажок Red-X Red-X Red-X
Осведомленность о контенте Флажок Флажок Флажок Флажок
Правила для объявлений Предупреждение 3 Флажок Флажок Флажок
Рекламные паузы, заданные вручную в правилах для объявлений Флажок Red-X Red-X Red-X
Ограничение частоты показа 6 Флажок Флажок Флажок Флажок
Конкурентные исключения (поток) Флажок Флажок Флажок Флажок
Конкурентные исключения (под) Флажок Флажок Флажок Флажок
Конкурентные исключения (вся страница) Флажок Red-X Red-X Red-X
Пакетирование Предупреждение 3 Флажок Флажок Флажок
Заставки Флажок Флажок Флажок Флажок
Отчеты об отслеживании нескольких событий Флажок Флажок Флажок Флажок
Динамическое размещение (AdSense для видео, Ad Exchange в Менеджере рекламы) Флажок Флажок Флажок Флажок
С возможностью пропуска (не TrueView) 8 Предупреждение 5 Флажок Флажок Флажок
In-Stream Select Флажок Red-X Red-X Red-X
Предзагрузка объектов Предупреждение 7 Red-X Флажок Red-X
Функции AdSense для видео
TrueView In-Stream Предупреждение 5 Флажок Флажок Red-X
In-Stream Select Флажок Флажок Флажок Red-X
Стандартное объявление In-Stream Флажок Флажок Флажок Флажок
Полноразмерный слот Флажок Red-X Red-X Red-X
Сопутствующие объявления Флажок Флажок Флажок Red-X
Заполнение сопутствующих объявлений Red-X Флажок Флажок Red-X
Наложения Предупреждение 5 Red-X Red-X Red-X
Предзагрузка объектов Предупреждение 7 Red-X Флажок Red-X
Функции Ad Exchange в Менеджере рекламы
TrueView In-Stream Предупреждение 5 Флажок Флажок Red-X
In-Stream Select Флажок Флажок Флажок Red-X
Стандартное объявление In-Stream Флажок Флажок Флажок Флажок
Полноразмерный слот Флажок Red-X Red-X Red-X
Сопутствующие объявления Флажок Флажок Флажок Red-X
Заполнение сопутствующих объявлений Red-X Флажок Флажок Red-X
Наложения Предупреждение 5 Red-X Red-X Red-X
Видимость Active View Флажок Флажок Флажок Red-X
Предзагрузка объектов Предупреждение 7 Red-X Флажок Red-X
Почему я вижу эту рекламу? Флажок Флажок Флажок Флажок

1 В SDK, не предназначенных для HTML5, пока не поддерживаются следующие функции VAST 3.0:

  • Дополнительное приложение 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 SDK (любая реализация, основанная на событии AD_BREAK_READY).

8 SDK не поддерживает объявления с возможностью пропуска продолжительностью менее 8 секунд. Если показывается объявление короче минимальной продолжительности, кнопка Пропустить не отображается.

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