Проброс кода

Описание

Проброс кода — позволяет установить произвольный HTML-код в контейнер баннера. Если код содержит скрипты, они будут выполнены в контексте страницы.

Возможности баннера, доступные при добавлении в ADFOX:

  • в качестве кода может быть установлен как HTML5-код, так и асинхронный код вставки от любой системы управления рекламой;
  • к размещению принимается HTML-код, который может выходить за пределы контейнера, например, показывающий Fullscreen, Background или баннеры с расхлопом.

Особенности формата:

Для размещения кода вставки ADFOX с библиотекой context.js воспользуйтесь шаблоном Проброс кода ADFOX [loader].

Требования к коду

  1. Максимально допустимое количество символов в HTML-коде — 65 000.
  2. JavaScript и CSS необходимо размещать внутри HTML-кода баннера.
    Если итоговый HTML-код превышает максимально допустимое количество символов, необходимо уменьшить код за счет вынесения JavaScript и CSS в отдельные файлы:
    • сохраните JS и CSS-код в отдельные файлы с расширением .js или .css;
    • файлы добавьте на вкладку Файлы рекламной кампании, скопируйте ссылки и укажите их в HTML-коде.
  3. Можно установить произвольный HTML-код, код вставки ADFOX с библиотекой context.js или асинхронный код вставки другой рекламной системы (без функции document.write).
Примечание. Если в HTML-коде, который требуется добавить в ADFOX в качестве баннера, присутствует document.write, использовать шаблон Проброс кода [loader] нельзя. В таком случае рекомендуем добавить код через шаблон HTML код [sync_async] или Banner HTML5 [loader].

Требования для подсчета кликов в баннере с HTML5-кодом

  1. Подсчет кликов в баннере.

    Чтобы в ADFOX у баннера считалась статистика по кликам, необходимо в HTML-коде в теге а для атрибута href прописать переменную:

    %banner.reference_user25%

    Также для ссылок используйте атрибут target с переменной %banner.target% в значении атрибута. Если атрибут отсутствует, ссылка откроется внутри iframe, то есть рекламируемый сайт откроется на баннерном месте.

    Пример HTML-кода для подсчета кликов по баннеру:
    <a href="%banner.reference_user25%" target="%banner.target%">Сайт рекламодателя</a>
  2. Подсчет кликов с нескольких ссылок в баннере.

    Допустим, в баннере есть несколько ссылок для перехода, ведущих на разные страницы рекламируемого сайта, и по каждой из них нужно получить количество переходов.

    <a href="http://site.ru" target="_blank">Первая ссылка</a>
    <a href="http://site.ru/about/" target="_blank">Вторая ссылка</a>

    Замените значения атрибута href на переменные %request.reference%@%banner.eventN%, где вместо N должен быть номер события с 1 по 28.

    Например:
    <a href="%request.reference%@%banner.event1%" target="%banner.target%">Первая ссылка</a>  
    <a href="%request.reference%@%banner.event2%" target="%banner.target%">Вторая ссылка</a>

    Соответствие ссылок и переменных нужно сообщить менеджеру, добавляющему баннер в ADFOX. Так как при добавлении баннера нужно будет на вкладке События указать для События 1 первую ссылку, а для События 2 — вторую ссылку.

Добавление баннера

  1. Чтобы добавить баннер с кодом, используйте шаблон Проброс кода [loader].
  2. Если в типе баннера такой шаблон отсутствует, добавьте его из предзаданных.
  3. При добавлении баннера укажите параметры:
    • ссылка на промерочный пиксель — по умолчанию используется пиксель ADFOX //banners.adfox.ru/transparent.gif, при необходимости вести учет показов в сторонней системе, удалите пиксель ADFOX и укажите другую ссылку;
    • HTML-код вставки — вставьте HTML-код;
    • URL перехода — укажите ссылку для перехода на сайт рекламодателя, при условии, что в HTML-коде выполнены требования по вставке кода для обработки клика.
  4. Если HTML-код содержит несколько ссылок на разные страницы рекламируемого сайта, поле URL перехода оставьте пустым, а ссылки укажите на вкладке События после добавления баннера.
  5. Для корректной работы перехода обязательно проверьте наличие протокола в ссылке (http:// или https://).
  6. Имя атрибута class контейнера баннера — при необходимости укажите имя (или несколько имен через пробел) для атрибута class контейнера с баннером.

Добавление баннера по умолчанию

  1. Чтобы добавить баннер по умолчанию с произвольным HTML-кодом воспользуйтесь генератором кода.
  2. Выберите тип кода Сторонний код вставки и вставьте HTML-код в поле для ввода кода.
  3. Добавьте при необходимости промерочные пиксели.
  4. Скопируйте полученный код и установите его в поле Код с типом JavaScript.

Пример размещения стороннего кода: