Шаблон в интерфейсе: HTML5 Mobile Float
Предпросмотр
Полноэкранный мобильный формат, вовлекающий пользователя во взаимодействие с баннером. Пользователю предлагают встряхнуть смартфон для совершения определенного действия.
Данный формат может подпадать под ограничения, налагаемые
Google совместно с
Coalition for Better Ads на показ рекламных баннеров в браузере Chrome. Чтобы баннер не был признан таким, который нарушает требования
стандарта, необходимо исключить следующее поведение баннера:
· автопроигрываемое видео с включенным звуком.
Поддерживаемые платформы
Desktop |
Tablet |
Phone |
Windows |
Mac |
iOS |
Android |
iOS |
Android |
— |
— |
ver. 8.0+ |
ver. 5+ |
ver. 8.0+ |
ver. 5+ |
Известные ограничения
На мобильных устройствах с платформой iOS 12 и выше настройка Движение и ориентация может быть выключена по умолчанию. В таком случае, модуль shake запустит показ всех панелей креатива автоматически с интервалом 5 секунд.
Скачать архив с примером:
Скачать
Данная структура файлов в архиве соответствует примеру и может быть изменена вами. Обязательным файлом в архиве является body.html, в котором указываются размеры баннера, параметр учета клика и другие скрипты.
Инструкция по работе с архивом
- Распакуйте архив с примером.
- Для просмотра креатива используйте страницу https://preview.admixer.net. Также можно скопировать все файлы в папку index – banners – banner – body и открыть файл index.html в среде просмотра на мобильном устройстве через localhost (например, браузер Chrome с режимом эмулятора мобильного устройства). Во этом случае требуется предварительная установка и настройка веб-сервера (к примеру, IIS для Windows, Apache для Mac OS).
Дополнительно можете проверить превью креатива предварительно скопировав на него ссылку и просмотрев с мобильного девайса.
- Откройте текстовым редактором файл body.html и отредактируйте часть кода, которая находится внутри тэгов <body> </body>.
В тегах <body>…</body> указываются размеры баннера, скрипты и т.д. Если разместить их в другом месте, креатив не будет отображаться.
- Отредактируйте JS код.
- Сохраните и заархивируйте все используемые материалы в ZIP формате (архив должен создаваться из файлов, а не из папки, в которой эти файлы находятся).
Файл body.html должен находиться в корневой директории ZIP-архива.
Общие требования к формату
Основная панель
Стандартные размеры, WxH, 100%x100%
Видео
- Размер контейнера для видеоплеера может быть задан любой в границах развернутой панели
- Тип файлов: .mp4
- Макс. продолжительность: 30 сек
Вес креатива
- до 300 Kb без видео
- до 2 Mb с видео
Требования к файлам
ZIP архив
.zip архив с необходимыми материалами. Рекомендуем использовать архив с примером.
HTML файл
HTML-файл должен содержать пути к загружаемым материалам (JS-файлам, изображениям). Рекомендуемое название HTML-файла — body.html.
Подключение и использование API
globalHTML5Api подключается автоматически, вызывается с помощью метода:
- Показать код globalHTML5Api
globalHTML5Api.on('load', function(){
/*
YOUR CODE IS HERE
*/
});
Все используемые объекты и методы globalHTML5Api помещаются внутрь вызываемой функции. Подключаемые модули передаются в качестве параметров функции. Данный формат может использовать модуль Player, Shake.
Упрощенный пример использования globalHTML5Api для формата Shake:
- Показать пример кода globalHTML5Api
globalHTML5Api.on('load', function(Shake){
globalHTML5Api.init({
'resize' : [
{
'name': 'state-1',
'fixed' : {
'vertical':'center',
'horizontal':'center'
},
'width': '100%',
'height': '100%'
}
]
});
})
Параметры globalHTML5Api.init
Ключ |
Свойства |
Тип |
Описание |
resize |
— |
Array |
Массив объектов |
name (required) |
String |
Имя объекта. Каждый объект представляет собой отдельное положение контейнера (resizeState). |
fixed |
— |
Объект со свойствами. Описывает положение контейнера относительно окна браузера |
vertical (required) |
top, bottom |
Положение контейнера по вертикали |
horizontal (required) |
center |
Положение контейнера по горизонтали |
width (required) |
String|Number |
Значение ширины контейнера с баннером |
height (required) |
String|Number |
Значение высоты контейнера с баннером |
Пример использования модуля Shake:
- Показать пример кода
var container = $('container');
Shake.subscribe(function(){
container.style.backgroundColor = "rgb(" + rnd(0,255) + "," + rnd(0,255) + "," + rnd(0,255) + ")";
})
*В примере выше функция обратного вызова изменяет цвет баннера по событию shake.
Параметры Shake
Метод |
Аргументы |
Описание |
subscribe |
Function |
Метод отвечает за отслеживание события Shake и запуск функции по совершению события, т.е. после того как пользователь потряс устройство. |
Методы globalHTML5Api
Метод |
Аргументы |
Тип |
Описание |
click(URL) |
— |
— |
Вызов клик-перехода на целевую страницу. Ссылка перехода может быть передана непосредственно в коде креатива. Также ссылка перехода может быть задана из шаблона заливки креатива в пользовательском интерфейсе. Ссылка, заданная в коде, имеет больший приоритет, чем ссылка, заданная через шаблон, что может привести к конфликту. Поэтому для передачи ссылки обязательно использовать только один из доступных способов. |
URL (optional) |
String |
Ссылка перехода |
src(URL) |
— |
— |
Метод возвращает абсолютный путь к файлу |
URL (optional) |
String |
Относительный путь к файлу |
globalHTML5Api.on(‘event’, callback);) |
— |
— |
Вызов функции по событию |
event |
String |
Событие ‘positionChange()’ |
callback(positionData) |
Function |
callback-функция |
Видео
Если креатив содержит видео, воспользуйтесь инструкцией Добавление видео в HTML5 баннер.
Важно! Все ссылки на внешние файлы должны работать по защищенному HTTPS протоколу.
Изображения
Поддерживаемые типы файлов: .jpg, .png, .gif, .svg.
Учет событий
- View/ Просмотр
- Confirmed view/ Подтвержденный просмотр
- Click/ Клик
Chrome
может ограничивать использование ресурсов рекламой (
до взаимодействия пользователя с ней) путем удаления тяжелого креатива со страницы. Реклама считается тяжелой, если пользователь не взаимодействовал с ней (например, не кликнул) и если она соответствует любому из следующих критериев:
— Использует основной поток
в общей сложности более 60 секунд
— Использует основной поток
более 15 секунд в любом 30-секундном окне
— Использует
более 4 мегабайт пропускной способности сети
По вопросам технических требований к баннерам, пожалуйста, обращайтесь к менеджеру поддержки вашего аккаунта.
Обновлено 09 апреля, 2024