Admixer HelpCenter

Ukrainian

English

Russian

Назад до Огляду платформи

Глосарій

Креативи

Шаблон в інтерфейсі: HTML5 Banner

Попередній перегляд

Формат банера, що складається з двох панелей - початкової та повноекранної. Повноекранна панель з'являється за кліком або за наведенням на основну. Кнопка "Закрити" на повноекранній панелі повертає банер у початковий стан.

Цей формат може підпадати під обмеження, що накладаються Google спільно з Coalition for Better Ads на показ рекламних банерів у браузері Chrome. Щоб банер не був визнаний таким, що порушує вимоги стандарта, необхідно виключити таку поведінку банера:
· автопрогравання відео з увімкненим звуком.

Сумісність з інвентарем:

Тільки локальний інвентар (зони прямого паблішера).

Підтримувані платформи

Desktop		Tablet		Phone
Windows	Mac	iOS	Android	iOS	Android
Chrome, Firefox, Edge, IE10+	Safari8+, Chrome, Firefox	—	—	—	—

Вимоги до формату

Основна панель

Стандартні розміри WxH, px: 300×250, 240×350, 300×250, 240×500, 300×600

Розгорнута панель

Стандартні розміри, WxH: 100%x100%

Відео (опційно)

Розмір контейнера для відеоплеєра може бути заданий будь-який у межах панелі
Тип файлів: .mp4
Макс. продолжительность: 30 сек
Частота кадрів: 24 к/с

Аудіо

Ініціюється користувачем (вимкнено за замовчуванням)

Кнопки керування

Кнопка "X / Закрити" у правому верхньому кутку банера (дає змогу користувачеві закрити розгорнуту панель)
Мінімально необхідний відступ для кнопки Закрити від верхньої і правої меж банера - 5px:

right: 5px;
top: 5px;

Вага креативу

до 300 KB без відео
до 2 MB з відео

Завантажити архів з прикладом:

Завантажити

Дана структура файлів в архіві відповідає прикладу і може бути змінена вами. Обов'язковим файлом в архіві є body.html, в якому вказуються розміри банера, параметр обліку кліка та інші скрипти.

Інструкція по роботі з архівом

Розпакуйте архів із прикладом.
Для перегляду креативу, використовуйте сторінку http://preview.admixer.net або ж скопіюйте всі файли в папку index – banners – banner – body та відкрийте файл index.html в браузері через localhost. У другому випадку потрібне попереднє встановлення та налаштування веб-сервера (наприклад, IIS для Windows, Apache для Mac OS).
Відкрийте текстовим редактором файл body.html і відредагуйте частину коду, яка знаходиться всередині тегів <body> </body>.

В тегах <body>…</body> вказуються розміри банера, скрипти тощо. Якщо розмістити їх в іншому місці, креатив не відображатиметься.

Відредагуйте файл body.js.
Збережіть і заархівуйте всі використовувані матеріали в ZIP форматі (архів повинен створюватися з файлів, а не з папки, в якій ці файли знаходяться).

Вимоги до файлів

ZIP архів

Банер з усіма необхідними матеріалами повинен знаходитися в .zip архіві. Рекомендуємо використовувати архів із прикладом.

HTML файл

HTML-Файл повинен містити шляхи до завантажуваних матеріалів (JS-файлів, зображень). Рекомендована назва HTML-файла — body.html.

Підключення та використання API

globalHTML5Api підключається автоматично, викликається за допомогою методу:

Показати код globalHTML5Api

globalHTML5Api.on('load', function(){
  /*
    YOUR CODE IS HERE
  */
});

Усі використовувані об'єкти і методи globalHTML5Api поміщаються всередину викликаної функції.
Модулі, що підключаються, передаються як параметри функції. Для цього формату може використовуватися модуль Player.
Спрощений приклад використання globalHTML5Api.init для формату Click to Fullscreen:

Показати приклад коду globalHTML5Api.init

globalHTML5Api.on('load', function(){
	globalHTML5Api.init({
		'resize' : [
			{
				'name': 'state-1',
				'width': '300px',
				'height': '250px',
				'onComplete': function () {
					//function();
			},
				'onStart': function () {
					//function();
			}
			},
			{
				'name': 'state-2',
				'fixed' : {
						'vertical':'center',
						'horizontal':'center'
					},
				'width': '100%',
				'height': '100%'
			}
		]
	});
});

Параметри globalHTML5Api.init

Ключ	Параметри	Властивості			Тип	Опис
resize(options)	—	—			—	Ініціалізація globalHTML5Api.resize
	options	—			Array	Масив об'єктів із властивостями. Кожен об'єкт являє собою окреме положення контейнера (resizeState)
		name (required)			String	Ім'я об'єкта
		width (required)			String\|Number	Значення ширини контейнера з банером
		height (required)			String\|Number	Значення висоти контейнера з банером
		fixed	—		Object	Об'єкт із властивостями. Описує положення контейнера щодо вікна браузера
			vertical (required)	center	String	Положення контейнера по вертикалі
			horizontal (required)	center	String	Положення контейнера по горизонталі
		onComplete			Function	Запуск callback функції після закінчення globalHTML5Api.init.resize.to(this.name)
		onStart			Function	Запуск callback функції на початку globalHTML5Api.init.resize.to(this.name)

Методи globalHTML5Api.resize

Метод	Параметри	Тип	Опис
to(resizeStateName, time, eventName)	—	—	Зміна поточного положення контейнера на вказане
	resizeStateName (required)	String	Ім'я положення контейнера, до якого потрібно перейти
	time (required)	Number	Час анімації зміни положення контейнера
	eventName (required)	String	Подія, яку необхідно враховувати: adExpand – розгортання контейнера adCollapse – згортання контейнера adExpandAuto – автоматичне розгортання контейнера adCollapseAuto – автоматичне згортання контейнера
currentState()	—	—	Метод повертає рядок: resizeState.name – ім'я поточного положення контейнера interactive to resizeState.name – зміна положення контейнера до вказаного

Методи globalHTML5Api

Метод	Аргументи	Тип	Опис
click(URL)	—	—	Виклик клік-переходу на цільову сторінку. Посилання переходу може бути передано безпосередньо в коді креативу. Також посилання переходу може бути задано з шаблону заливки креативу в інтерфейсі користувача. Посилання, задане в коді, має більший пріоритет, ніж посилання, задане через шаблон, що може призвести до конфлікту. Тому для передачі посилання обов'язково використовувати тільки один із доступних способів.
click(URL)	URL (optional)	String	Посилання переходу
src(URL)	—	—	Метод повертає абсолютний шлях до файлу
src(URL)	URL (optional)	String	Відносний шлях до файлу

Відео

Якщо креатив містить відео, дотримуйтесь Інструкції з додавання відео в HTML5 банер.

Зображення

Підтримувані типи файлів: .jpg, .png, .gif, .svg

Також підтримуються файли CSS.

Облік подій

View/ Перегляд
Confirmed view/ Підтверджений перегляд
Click/ Клік
Expand by user/ Розхлоп банера користувачем
Auto-expand/ Автоматичний розхлоп банера
Collapse by user/ Згортання банера користувачем
Auto-collapse/ Автоматичне згортання банера
Play/ Запуск відеоролика
Pause/ Пауза
Resume/ Продовження перегляду відеоролика
Sound on/ Увімкнення звуку
Sound off/ Вимкнення звуку
Progress (firstQuartile, midpoint, thirdQuartile, complete)/ Перегляд відеоролика (перша чверть, середина, третя чверть, закінчення)

Chrome може обмежувати використання ресурсів рекламою (до взаємодії користувача з нею) шляхом видалення важкого креативу зі сторінки. Реклама вважається важкою, якщо користувач не взаємодіяв з нею (наприклад, не клікнув) і якщо вона відповідає будь-якому з таких критеріїв:
— Використовує основний потік загалом понад 60 секунд
— Використовує основний потік понад 15 секунд у будь-якому 30-секундному вікні
— Використовує більше 4 мегабайт пропускної здатності мережі

З питань технічних вимог до банерів, будь ласка, звертайтеся до менеджера підтримки вашого акаунта.

Оновлено 23 червня, 2025