Интеграция AdFox с сайтом

Начало | Начало | Интеграция AdFox с сайтом



Интеграция AdFox с сайтом

На сайте (в верстке страницы или через CMS) размещается код вставки в том месте, где должен произойти показ рекламного баннера за исключением случаев размещения следующих типов баннеров:

  1. - код вставки размещается сразу после открывающего тега <body>:
  2. - код вставки размещается перед закрывающим тегом </body>:
  3. - ссылка на XML размещается в видео плеере:

Когда на сайт заходит посетитель, браузер отправляет запрос в AdFox на показ баннера.

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

На основании полученных данных AdFox начинает искать подходящий баннер для сайта. Система перебирает все активные рекламные кампании, затем определяется по настройкам уровней, приоритетов, таргетирований и ограничений подходящий для показа рекламный баннер. Если в системе отсутствует баннер для показа (сработали ограничения или таргетинги), то система ищет баннер по умолчанию (заглушку).
Если не задана заглушка для площадки, показывается заглушка для типа баннеров. Если заглушка для данного типа тоже не задана, показывается стандартная заглушка с логотипом AdFox.

Синхронный и асинхронный код вставки

Синхронный код вставки

HTML устроен так, что веб-страница загружается, синхронно (строка за строкой) загружая по очереди все включенные в html-код элементы. Таким образом, загрузка тормозится в местах с кодами вставки AdFox, так как это javascript строки.

Синхронный код вставки генерируется в системе автоматически, то есть это обычные коды вставки. При установке на сайте они не требуют подключения каких-либо дополнительных скриптов или библиотек.

Асинхронный код вставки

Когда загрузка страницы доходит до кода вставки AdFox, браузер отправляет запрос к системе AdFox и не ожидая ответа продолжает загрузку страницы. В свою очередь AdFox подгружает результат запроса (баннер или заглушку) параллельно загрузке страницы как будто в отдельное окно (iframe), а только потом уже выгружает данные на страницу, даже тогда, когда она полностью сформирована и загружена. Асинхронный код вставки не позволяет "вешать" загрузку страницы, но и не ждать, когда загрузится вся страница.

Асинхронные шаблоны

Для асинхронных кодов вставки в системе необходимо использовать асинхронные шаблоны.

    Асинхронные шаблоны имеются для следующих типов баннеров:
  • Flash баннер (с заглушкой или без заглушки);
  • Flash с видео;
  • Flash из нескольких частей;
  • Flash с несколькими кнопками перехода;
  • Сторонний код вставки;
  • Картинка;
  • Screenglide/Expandable баннер;
  • Screenglide/Expandable с видео;
  • HTML-код (без подключения скриптов);
  • Баннер по умолчанию.

Заметим, что на асинхронном коде вставки баннер, добавленный через синхронный (обычный) шаблон, не покажется.

Виды асинхронный кодов

    Асинхронный код вставки бывает двух видов:
  • асинхронный код, который подгружает результат запроса (баннер или заглушку) параллельно загрузке страницы с момента запроса страницы;
  • асинхронный код с проверкой скролла (обычно используется на площадках во втором и ниже экранах), который отправляет запрос на сервер AdFox только тогда, когда эта площадка (с асинхронным кодом с проверкой скролла) попала в область видимости на экране монитора посетителя сайта.

Генерация и установка на сайт асинхронных кодов

Асинхронный код вставки подготавливается специалистами AdFox. Вам необходимо получить обычный код вставки и направить его в службу технической поддержки с просьбой подготовить асинхронный код или асинхронный код с проверкой скролла.

Как правильно установить на сайте полученные коды вставок смотрите соответствующую инструкцию:

Подстановка параметров в код AdFox

Подстановка параметров при таргетировании по ключевым словам/фразам или при дополнительном (пользовательском) таргетировании

При использовании таргетирования по ключевым словам/фразам или дополнительном (пользовательском) таргетировании в код вставки необходимо передавать значения параметров в соответствии с описанием:

Принудительное указание URL страницы

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

Например, в случае с видео-рекламой в видео-плеере каждый браузер передает referer по-разному: Safari передает адрес видео-плеера, а Firefox вообще не передает referer.
Добавление параметра dl:

http://ads.adfox.ru/******/getCodeTest?p1=*****,p2=****,pfc=*,pfb=*,dl=
Добавление значения к параметру dl:
http://ads.adfox.ru/******/getCodeTest?p1=*****,p2=****,pfc=*,pfb=*,dl=http://site.ru/news/
Добавление параметра dl со значением к коду вставки:
<script type="text/javascript">
<!--
if (typeof(pr) == 'undefined') { var pr = Math.floor(Math.random() * 1000000); }
if (typeof(document.referrer) != 'undefined') {
if (typeof(afReferrer) == 'undefined') {
afReferrer = escape(document.referrer);
}
} else {
afReferrer = '';
}
var addate = new Date();
document.write('<scr' + 'ipt type="text/javascript" src="http://ads.adfox.ru/******/prepareCode?pp=*&ps=***&p2=****&pct=*&plp=*&pli=*&pop=*&pr=' + pr +'&pt=b&pd=' + addate.getDate() + '&pw=' + addate.getDay() + '&pv=' + addate.getHours() + '&prr=' + afReferrer + ';&dl=http://site.ru/news/"><\/scr' + 'ipt>');
// -->
</script>

Параметры для сбора дополнительной статистики

Для сбора какой-либо дополнительной статистики можно передавать в код вставки значения параметров eid1 и eid2.

Статистика доступна только в дополнительных отчётах при выгрузке EventLog. Формат выгрузки и периодичность обсуждаются по каждому конкретному случаю со службой технической поддержки.

Добавление параметров eid1 и eid2 со значениями к коду вставки:

<script type="text/javascript">
<!--
if (typeof(pr) == 'undefined') { var pr = Math.floor(Math.random() * 1000000); }
if (typeof(document.referrer) != 'undefined') {
if (typeof(afReferrer) == 'undefined') {
afReferrer = escape(document.referrer);
}
} else {
afReferrer = '';
}
var addate = new Date();
document.write('<scr' + 'ipt type="text/javascript" src="http://ads.adfox.ru/******/prepareCode?pp=*&ps=***&p2=****&pct=*&plp=*&pli=*&pop=*&pr=' + pr +'&pt=b&pd=' + addate.getDate() + '&pw=' + addate.getDay() + '&pv=' + addate.getHours() + '&prr=' + afReferrer + ';&eid1=23;&eid2=man"><\/scr' + 'ipt>');
// -->
</script>

Последнее изменение: 20.02.2012