ADFOX Exchange Help

Шаблоны

Описание

У одного типа баннера может быть несколько разных шаблонов.
Шаблоны отвечают за внешний вид и функциональность баннеров на сайте.

Шаблоны бывают двух видов:
Системные - по умолчанию присутствуют в типе баннера;
Пользовательские - шаблоны, которые к типу баннера добавляет администратор аккаунта. Пользовательские шаблоны бывают предзаданные и собственные, созданные администратором.

Тип представления/Шаблон Стандартный (iframe) Безразмерный (JavaScript) XML
Системные HTML код + + -
JavaScript код - + -
Flash с заглушкой + включен, если в параметрах типа баннера разрешены "Базовые шаблоны" -
Flash без заглушки - включен, если в параметрах типа баннера разрешены "Базовые шаблоны" -
Изображение + включен, если в параметрах типа баннера разрешены "Базовые шаблоны" -
XML-баннер - - +

Пользовательские

Предзаданные шаблоны - + +
Собственные шаблоны + + +

Настройка видимости шаблонов

Во вкладке "Настройки" - "Типы баннеров" для каждого типа баннера есть кнопка "Шаблоны".

Нажмите кнопку "Шаблоны" откроется список предзаданных шаблонов.

Шаблоны, для которых стоит чекбокс в графе "Включен", отображаются в списке при добавлении баннера и с помощью этого шаблона можно создать баннер.
Если необходимо, чтобы какие-либо шаблоны не были видны при создании баннера, тогда выключите чекбокс возле необходимых шаблонов и нажмите "Изменить".

При удалении шаблонов, баннеры, созданные с помощью этих шаблонов, не будут показываться на сайте.
При выключении шаблона, добавленные с ним баннеры продолжат показываться на сайте.

Предзаданные шаблоны

Предзаданные шаблоны - это уже готовые шаблоны, которые можно самостоятельно добавить к безразмерным и XML типам баннеров.
Список готовых форматов можно посмотреть на сайте https://specs.adfox.ru.

  1. Откройте Настройки - Типы баннеров - Собственные - (Безразмерные).
  2. Создайте новый тип баннера или выберите уже существующий, для которого нужно добавить шаблон.
  3. Нажмите на значок "Шаблоны".
  4. Далее нажмите кнопку "Использовать предзаданные" и в списке, напротив нужного шаблона нажмите на стрелку. Откроется шаблон, нажмите кнопку "Добавить" внизу страницы.

Готово. Шаблон доступен для данного типа баннера.

Создание шаблонов

Чтобы создать собственный шаблон к любому типу баннера откройте вкладку "Настройки" - "Типы баннеров".
Выберите Собственные или Предопределённые.
Найдите нужный тип баннера и нажмите на значок "Шаблоны" - "Добавить".

Шаблон представляет собой 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 производит эскейп символов <,>,&

    %banner.user1:htmlenc%

    Пример: Исходное значение:

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

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

  2. Суффикс urlenc производит urlencode строки.

    %banner.user1:urlenc%

    Исходное значение:

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

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

  3. Суффикс jsenc производит экранирование (\) кавычек, переводов строк и слэшей.

    %rbanner.user1:jsenc%

    Исходное значение:

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

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

Описание переменной Имя переменной в коде
Ссылка на flash-ролик %banner.get_url%
Ссылка на изображение %banner.image_url%
Ссылка на FLV-ролик %banner.get_flv%
URL перехода %request.reference%
Параметр передачи перехода (название переменной, которая прописана во 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, где N — номер переменной от 1 до 25 %banner.userN%
Событие N, где N — номер события от 1 до 30 %banner.eventN%
Идентификатор баннера, который выбран для показа %banner.id%
Идентификатор рекламной кампании, которая выбрана для показа %campaign.id%
Идентификатор площадки, на которой размещен выбранный для показа баннер %place.id%
Идентификатор сайта, на котором размещен выбранный для показа баннер %site.id%
Идентификатор аккаунта %owner.id%
pr - переданный в запросе %request.page_random%
Ключевые слова, переданные в запросе %request.keywords%
Случайное число %system.random%
Протокол запроса за баннером. Например, http или https %request.protocol%
Значение puidN, переданное в запросе, где N - номер дополнительной характеристики от 1 до 63 %request.puidN%
Время запроса за баннером в uts, формат - количество секунд since unix epoch %request.timestamp%

Пример

При создании шаблона для показа простой перетяжки, в которой используются только gif-баннеры надо отметить в интерфейсе предопределенные переменные: "Ширина", "Высота", "Target ссылки", "URL перехода". Также надо отметить дополнительные параметры: "1-й параметр" и "2-й параметр", указав для них названия, например, "Левый gif" и "Правый gif" и тип: файл.
"Тип кода" - выберите HTML.
В поле "Код" вставьте код баннера, заменяя в коде значения атрибутов на переменные, которые будут заполняться из параметров баннера:

<table  width=100% cellspacing=0 cellpadding=0 border=0>
<tr valign=top>
<td width=49%>
<a href="%request.reference%" target="%banner.target%"><img src="%banner.user1%" width="100%" height="%banner.height%" border="0"></a><br>
</td>
<td width=2%>
<A href="%request.reference%" target="%banner.target%"><img src="%banner.user2%" width="%banner.width%" height="%banner.height%" border="0"></a><br>
</td>
<td width=49%>
<a href="%request.reference%" target="%banner.target%"><img src="%banner.user3%" width="100%" height="%banner.height%" border="0"></a><br>
</td>
</tr> 
</table>