Шаблони - Допомога по ADFOX Sites

1. 10.01.2019
2. Налаштування видимості шаблонів
3. предзаданного шаблони
4. створення шаблонів
5. Приклад коду банера:
6. зумовлені змінні
7. додаткові змінні
8. події
9. Кодування значень змінних
10. Список доступних змінних в шаблонах
11. Заборона на редагування
12. Приклад додавання власних шаблонів для кодів вставки з бібліотекою 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).
Події потрібні для отримання інформації про будь-які дії в банері, наприклад, расхлоп банера, наведення покажчика миші на кнопку.

Кодування значень змінних

За замовчуванням значення змінних передаються в код шаблону банера без змін.
Але для деяких змінних потрібно кодування значень.
Кодування значень проводиться за допомогою суфіксів, які підставляються через двокрапку до назви змінної в шаблоні.

Є три види кодування:

1. Суфікс htmlenc виробляє ескейп символів <,>, &

   Приклад: Початкове значення:

   hello // "world", & hello 'world'! + Good morning! <Good afternoon!

   Результат кодування:

   

2. Суфікс urlenc виробляє urlencode рядки.

   Початкове значення:

   hello // "world", & hello 'world'! + Good morning! <Good afternoon!

   Результат кодування:

   

3. Суфікс 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. Шаблон готовий, можна додавати банери.