Назад к Обзору платформы
Глоссарий
Креативы
Стоимость креативов
Работа с креативами
Тех. требования к креативам
Дополнительные настройки
Viber Format Creatives specs

Шаблон в интерфейсе: 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 секунд.

Скачать архив с примером:

Скачать

Инструкция по работе с архивом

  1. Распакуйте архив с примером.
  2. Для просмотра креатива используйте страницу https://preview.yehtu.com. Также можно скопировать все файлы в папку index – banners – banner – body и открыть файл index.html в среде просмотра на мобильном устройстве через localhost (например, браузер Chrome с режимом эмулятора мобильного устройства). Во этом случае требуется предварительная установка и настройка веб-сервера (к примеру, IIS для Windows, Apache для Mac OS).

    3. Дополнительно можете проверить превью креатива предварительно скопировав на него ссылку и просмотрев с мобильного девайса.

  3. Откройте текстовым редактором файл body.html и отредактируйте часть кода, которая находится внутри тэгов <body> </body>.
В тегах <body>…</body> указываются размеры баннера, скрипты и т.д. Если разместить их в другом месте, креатив не будет отображаться.
  1. Отредактируйте JS код.
  2. Сохраните и заархивируйте все используемые материалы в 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 баннер.

Изображения

Поддерживаемые типы файлов: .jpg, .png, .gif, .svg.

Учет событий

  • View/ Просмотр
  • Confirmed view/ Подтвержденный просмотр
  • Click/ Клик
Chrome может ограничивать использование ресурсов рекламой (до взаимодействия пользователя с ней) путем удаления тяжелого креатива со страницы. Реклама считается тяжелой, если пользователь не взаимодействовал с ней (например, не кликнул) и если она соответствует любому из следующих критериев:
— Использует основной поток в общей сложности более 60 секунд
— Использует основной поток более 15 секунд в любом 30-секундном окне
— Использует более 4 мегабайт пропускной способности сети
По вопросам технических требований к баннерам, пожалуйста, обращайтесь к менеджеру поддержки вашего аккаунта.
Обновлено 09 апреля, 2024