- 10.01.2019
- Налаштування видимості шаблонів
- предзаданного шаблони
- створення шаблонів
- Приклад коду банера:
- зумовлені змінні
- додаткові змінні
- події
- Кодування значень змінних
- Список доступних змінних в шаблонах
- Заборона на редагування
- Приклад додавання власних шаблонів для кодів вставки з бібліотекою loader.js
Стаття була оновлена
10.01.2019
опис
У одного типу банера може бути кілька різних шаблонів.
Шаблони відповідають за зовнішній вигляд і функціональність банерів на сайті.
Тип подання / Шаблон Стандартний (iframe) Безрозмірний (JavaScript) XML Системні HTML код + + - JavaScript код - + - Flash з заглушкою + - - Зображення + - - XML-банер - - +
призначені для користувача
Предзаданного шаблони - + + Власні шаблони + + +
Налаштування видимості шаблонів
У вкладці "Налаштування" - "Типи банерів" для кожного типу банера є кнопка "Шаблони".
Натисніть кнопку "Шаблони" відкриється список предзаданного шаблонів.
Шаблони, для яких варто чекбокс в графі "Включений", відображаються в списку при додаванні банера і за допомогою цього шаблону можна створити банер .
Якщо необхідно, щоб будь-які шаблони не були видні при створенні банера, тоді вимкніть чекбокс біля необхідних шаблонів і натисніть "Змінити".
При видаленні шаблонів, банери, створені за допомогою цих шаблонів, які не будуть показуватися на сайті.
При виключенні шаблону, додані з ним банери продовжать показуватися на сайті.
предзаданного шаблони
Предзаданного шаблони - це вже готові шаблони, які можна самостійно додати до безрозмірним і XML типам банерів. Список готових форматів, технічні вимоги до форматів, приклади та порядок додавання банерів в інтерфейс ADFOX можна подивитися на сайті .
Детальніше про додавання предзаданного шаблонів див. статтю .
створення шаблонів
Щоб створити власний шаблон до будь-якого типу банера відкрийте вкладку "Налаштування" - "Типи банерів".
Виберіть Власні або зумовленості.
Знайдіть потрібний тип банера і натисніть на значок "Шаблони" - "Додати".
Шаблон являє собою HTML або JavaScript код, який містить ряд змінних.
Для Стандартних типів банерів в шаблонах тип коду може бути тільки HTML.
Для безрозмірні типів банерів в шаблонах тип коду може бути або HTML, або JavaScript.
Для створення шаблону пройдіть кілька кроків:
1. підготуйте код банера
Приклад коду банера:
<Table width = 100% cellspacing = 0 cellpadding = 0 border = 0> <tr valign = top> <td width = 49%> <a href="http://adfox.ru" target="_blank"> <img src = "http://example.com/image_left.png" width = "100%" height = "90px" border = "0"> </a> <br> </ td> <td width = 2%> <A href="http://adfox.ru" target="_blank"> <img src = "http://example.com/image_center.png" width = "400px" height = "90px" border = "0 "> </a> <br> </ td> <td width = 49%> <a href="http://adfox.ru" target="_blank"> <img src =" http: // example. com / image_right.png "width =" 100% "height =" 90px "border =" 0 "> </a> <br> </ td> </ tr> </ table>
2. замініть в коді все значення атрибутів, які можуть змінюватися від одного банера до іншого, на змінні.
зумовлені змінні
В інтерфейсі додати шаблон присутні зумовлені змінні, які можна включити і вказати ім'я змінної в коді шаблону.
додаткові змінні
Для шаблону можливо додати 25 додаткових змінних (% banner.userN%, де N - від 1 до 25).
Увімкніть змінну, вкажіть ім'я для змінної, яке буде відображатися в інтерфейсі додавання банера.
вкажіть:
обов'язковість змінної;
тип змінної: рядок, текст, файл (для файлу можливо вказати додатково ще і тип файлу: картинка, flash, flv);
довжина значення: актуально для рядка і тексту;
значення за замовчуванням.
події
Для шаблону можливо додати 30 подій (% banner.eventN%, де N - від 1 до 30).
Події потрібні для отримання інформації про будь-які дії в банері, наприклад, расхлоп банера, наведення покажчика миші на кнопку.
Кодування значень змінних
За замовчуванням значення змінних передаються в код шаблону банера без змін.
Але для деяких змінних потрібно кодування значень.
Кодування значень проводиться за допомогою суфіксів, які підставляються через двокрапку до назви змінної в шаблоні.
Є три види кодування:
Суфікс htmlenc виробляє ескейп символів <,>, &
Приклад: Початкове значення:
hello // "world", & hello 'world'! + Good morning! <Good afternoon!Результат кодування:
Суфікс urlenc виробляє urlencode рядки.
Початкове значення:
hello // "world", & hello 'world'! + Good morning! <Good afternoon!Результат кодування:
Суфікс jsenc виробляє екранування (\) лапок, перекладів рядків і Слеш.
Початкове значення:
hello // "world", & hello 'world'! + Good morning! <Good afternoon!Результат кодування:
Список доступних змінних в шаблонах
Опис змінної Ім'я змінної в коді Посилання на flash-ролик% banner.get_url% Посилання на зображення% banner.image_url% Посилання на FLV-ролик% banner.get_flv% URL переходу (зумовлена змінна)% request.reference% URL переходу (додаткова змінна , де N - номер змінної від 1 до 25). Проводить підрахунок кліків по посиланню. % Banner.reference_userN% Параметр передачі переходу (назва змінної, яка прописана у flash-ролику і приймає значення змінної "URL переходу")% banner.flash_parameter_name% Параметр передачі "target"% banner.target_parameter_name% Ширина (в пікселях. Для вказівки ширини в% необхідно використовувати додаткову змінну)% banner.width% Висота (в пікселях. Для вказівки висоти в% необхідно використовувати додаткову змінну)% banner.height% Текст "ALT" зображення% banner.alt% "TARGET" посилання. Значення береться або з параметрів банера, або з параметра запиту - p3. % Banner.target% Колір фону% banner.background_color% Посилання на промерочной піксель. За замовчуванням буде підставлена значення "https://banners.adfox.ru/transparent.gif". % Banner.tracking_url% Додаткова змінна, де N - номер змінної від 1 до 25% banner.userN% Подія, де N - номер події від 1 до 30% banner.eventN% Ідентифікатор банера, який обраний для показу% banner.id% ідентифікатор рекламної кампанії, яка обрана для показу% campaign.id% ідентифікатор майданчика, на якій розміщений обраний для показу банер% place.id% ідентифікатор сайту, на якому розміщений обраний для показу банер% site.id% ідентифікатор облікового запису% owner.id% число, отримане із запиту в параметрі pr% request.page_random% Ключові слова, отримані з запиту в параметрі pk% r equest.keywords% Генератор випадкового числа% system.random% Протокол запиту за банером. Наприклад, http або https% request.protocol% Значення, отримане із запиту в параметрі puidN, де N - номер додаткової характеристики від 1 до 63% request.puidN% Значення, отримане із запиту в параметрі eidN, де N - номер змінної від 1 до 2% request.eidN% Час запиту за банером в uts, формат - кількість секунд since unix epoch% request.timestamp% Ідентифікатор рекламного місця, отриманий із запиту в параметрі phid% request.placeholder_id% Випадкове число, сгенерированное на майданчику для асинхронних кодів . Приходить в запиті в параметрі pr1% request.place_random%
Заборона на редагування
Для розширення функціональності шаблонів до додаткових змінним доданий прапор Заборона на редагування, який доступний для настройки тільки при створенні шаблону.
Якщо хоча б 1 прапор був активований при створенні шаблону - то колонка буде показуватися в параметрах шаблону, інакше вся колонка ховається.
Змінні без прапора "Заборона на редагування" (за замовчуванням):
- в шаблоні - при зміні значення за замовчуванням в шаблоні для цієї змінної, нове значення не застосовується до раніше створеним банерів, але буде застосовуватися до нових банерів.
- в банері - при додаванні банера поле для цієї змінної заповнюється значенням за замовчуванням з шаблону і може бути змінено (в тому числі при редагуванні банера).
При відключенні змінної в шаблоні:
- в шаблоні - значення, вказане в полі "Значення за замовчуванням" буде видалено;
- в банерах - змінна разом зі своїм значенням повністю буде видалена у всіх раніше створених банерах.
При повторному включенні змінної в шаблоні:
- в шаблоні - можливо вказівку нового значення в поле "Значення за замовчуванням", яке буде застосовуватися тільки до новоствореним банерів;
- в банерах - змінна з'явиться у всіх раніше створених банерах або зі старим значенням, яке було зазначено в поле "Значення за замовчуванням" на рівні шаблону до відключення змінної, або зі зміненим, якщо воно було перевизначити на рівні банера.
Змінні з прапором "Заборона на редагування":
- в шаблоні - можна редагувати значення за замовчуванням і зміни будуть застосовуватися в тому числі і до всіх раніше створеним банерах.
- в банері - поле для цієї змінної заповнюється значенням за замовчуванням з шаблону і недоступно для редагування.
При відключенні змінної в шаблоні:
- в шаблоні - значення, вказане в полі "Значення за замовчуванням" буде видалено. Прапор "Заборона на редагування" залишиться активованим;
- в банерах - змінна разом зі своїм значенням повністю буде видалена у всіх раніше створених банерах.
При повторному включенні змінної в шаблоні:
- в шаблоні - можливо вказівку нового значення в поле "Значення за замовчуванням";
- в банерах - змінна з'явиться у всіх раніше створених банерах або з порожнім значенням, або з новим значенням, зазначеним у поле "Значення за замовчуванням" на рівні шаблону.
Розглянемо приклад:
У шаблоні дві додаткові змінні:
user1 "Ширина": значення за замовчуванням - 100px, заборони на редагування немає.
user2 "Текст на плашки": значення за замовчуванням - "Реклама", включена заборона на редагування.
Створимо банер, в якому для кожної змінної будуть застосовані значення за замовчуванням.
Мінлива user2 "Текст на плашки" недоступна для редагування в параметрах банера.
Тепер в шаблоні змінимо значення за замовчуванням:
У банері буде автоматично змінено значення тільки для змінної user2 "Текст на плашки", а значення для змінної user1 залишилося без зміни:
Приклад додавання власних шаблонів для кодів вставки з бібліотекою loader.js
Щоб додати шаблон, який буде коректно працювати на коді вставки з бібліотекою loader.js, необхідно:
1. Написати HTML код. наприклад:
<Div style = "max-width: 500px;"> <h1 style = "text-align: center;"> <a style = "text-decoration: none; color: red;" href = "https://adfox.ru/ru/"> ADFOX </a> </ h1> <div style = "display: inline-flex; padding-left: 5px;"> <a href = "https: //adfox.ru/ru/product/adfox_sites/ "target =" _ blank "> <img src =" https://adfox.ru/m/pic/2013/08/19/06/32/05/products_logo_1. png "> </a> <a href =" https://adfox.ru/ru/product/adfox_sites/ "target =" _ blank "style =" text-decoration: none; color: black; padding-left: 5px ; "> ADFOX Sites. Розміщення і управління рекламою на сайтах </a> </ div> <div style = "display: inline-flex; padding-left: 5px;"> <a href = "https://adfox.ru/ru/product/ adfox_ssp / "target =" _ blank "> <img src =" https://adfox.ru/m/pic/2013/08/31/02/19/41/ssp-color.png "> </a> < a href = "https://adfox.ru/ru/product/adfox_ssp/" target = "_ blank" style = "text-decoration: none; color: black; padding-left: 5px;"> Монетизація. Доповнення до ADFOX Sites - підключення до RTB-аукціону Рекламної Мережі Яндекса </a> </ div> <div style = "display: inline-flex; padding-left: 5px;"> <a href = "https: // adfox .ru / ru / product / adfox_adv / "target =" _ blank "> <img src =" https://adfox.ru/m/pic/2013/08/19/06/35/24/products_logo_2.png "> </a> <a href="https://adfox.ru/ru/product/adfox_adv/" target="_blank" style="text-decoration: none; color:black; padding-left: 5px;"> ADFOX ADV. Незалежний аудит контроль проведення кампанія </a> </ div> </ div>
2. У коді необхідно виділити ті значення, які будуть змінними , Тобто можуть змінюватися від одного банера до іншого. Наприклад, це можуть бути розміри, картинки, посилання для переходу, текст.
Якщо в параметрах шаблону для посилань для переходу включаєте додаткові змінні, то для підрахунку кількості кліків використовуйте макроси% banner.reference_userN%, де N - номер включеної додаткової змінної.
Приклад коду зі змінними:
<Div style = "max-width: 500px;"> <h1 style = "text-align: center;"> <a style = "text-decoration: none; color: red;" href = "% banner.user25%">% banner.user2% </a> </ h1> <div style = "display: inline-flex; padding-left: 5px;"> <a href = "% banner. reference_user5% "target =" _ blank "> <img src ="% banner.user4% "> </a> <a href ="% banner.reference_user5% "target =" _ blank "style =" text-decoration: none; color: black; padding-left: 5px; ">% banner.user3% </a> </ div> <div style =" display: inline-flex; padding-left: 5px; "> <a href ="% banner.reference_user8% "target =" _ blank "> <img src ="% banner.user7% "> </a> <a href ="% banner.reference_user8% "target =" _ blank "style =" text-decoration: none; color: black; padding-left: 5px; ">% banner.user6% </a> </ div> <div style =" display: inline-flex; padding-left: 5px; "> <a href = "% banner.reference_user11%" target = "_ blank"> <img src = "% banner.user10%"> </a> <a href = "% banner.reference_user11%" target = "_ blank" style = "text- decoration: none; color: black; padding-left: 5px; ">% banner.user9% </a> </ div> </ div>
3. В інтерфейсі ADFOX перейдіть до типу банера, в якому буде знаходиться новий шаблон. Додайте з предзаданного шаблон "Проброс коду [loader]".
4. У параметрах шаблону "Проброс коду [loader]" включите необхідні змінні (які ви використовуєте в своєму HTML коді)
5. У полі Значення за замовчуванням для додаткової змінної №1 вставте підготовлений HTML код. Рекомендуємо також включити прапор "Заборона на редагування" .
6. Шаблон готовий, можна додавати банери.