Проброс кода

Описание

Примечание. Шаблон работает только на кодах вставок, использующих библиотеку loader.js — в инструкции такие коды имеют пометку NEW.

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

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

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

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

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

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

  1. Максимально допустимое количество символов в HTML-коде — 65 000.
  2. JavaScript и CSS необходимо размещать внутри HTML-кода баннера.
    Если итоговый HTML-код превышает максимально допустимое количество символов, то необходимо уменьшить код за счет вынесения JavaScript и CSS в отдельные файлы:
    • сохраните js и css код в отдельные файлы с расширением .js или .css;
    • файлы добавьте во вкладку Файлы рекламной кампании, скопируйте ссылки и укажите их в HTML-коде.
  3. Можно установить произвольный HTML-код, код вставки ADFOX с библиотекой loader.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.

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