ADFOX Sites Help

События в баннерах

Для чего нужны события

ADFOX предоставляет возможность учитывать не только количество показов баннеров и количество переходов по ним, но и любые другие события, связанные с баннером. Например, у вас есть flash-ролик и вы хотите узнать сколько человек досмотрело его до конца, сколько до середины, сколько закрыли сразу. Либо при наведении мышки на баннер вы хотите включать какие-либо эффекты. Всё это делается с помощью событий.

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

В шаблонах, которые доступны для добавления из предзаданных, все необходимые события уже прописаны и вызываются. Список событий смотрите в технических требованиях к формату.

В баннерах, добавленных с помощью шаблонов с включенным флагом "Для кода вставки с loader.js", дополнительно производится подсчет события "Видимый показ". Он также учитывается в отчете по событиям.

Настройка событий в ADFOX

Для того чтобы настроить события в баннере, вам необходимо для нужного типа баннера создать шаблон, который будет содержать переменные типа %event1%, то есть переменные учёта событий в баннере. Чтобы создать шаблон перейдите во вкладку "Настройки" - "Типы баннеров", нажмите значок "Шаблоны" у типа баннера.

Максимальное число событий в баннере 30.

Гибкий учет событий

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

Для некоторых баннеров может потребоваться защита от накрутки событий (например, при неправильном поведении баннера при каких-то условиях, или при умышленном вызове событий).

Защита от накрутки событий реализуется на уровне шаблона баннера следующим образом:

В администраторском доступе перейдите во вкладку "Настройки" - "Типы баннеров" - "Шаблоны", зайдите в "Параметры" необходимого шаблона.

Напротив каждого события есть поле "Ограничение на сессию". Укажите в этом поле число - максимальное количество событий, которое может быть засчитано для конкретного события одного баннера (отданного на страницу пользователя) в течении 30 минут.

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

Приведём пример: от баннера, выгруженного на страницу, пришло 5 событий номер 1. В шаблоне для этого баннера было установлено ограничение - 4. В таком случае пятое событие, превышающее указанный лимит за сессию, будет проигнорировано и не засчитается в счетчиках и отчетах по событиям.

Ограничение показов баннера по событию 1

Вы также можете настроить ограничения по событиям. Зайдите в баннере во вкладку "События". Надо помнить, что ограничения будут относиться только к первому событию. Иначе говоря, по переменной %event1%.

После того, как для баннера будет выкручено указанное в ограничении количество событий, баннер останется со статусом "активный", но перестанет выбираться для показа.

Вызов событий из HTML-кода (в том числе шаблона)

При подготовке html-кода, например, шаблона учет событий будет осуществляться путем вызова ссылок, которые автоматически генерируются при помощи переменных вида %event1%, %event2% etc. В нужно месте кода необходимо вызвать ссылку учета события.

Пример вызова:
<script type="text/javascript">
var Pixel = new Image();
...
Pixel.src = '%event1%';
</script>

Вызов событий из flash-баннеров

Есть два основных способа использования учета событий во flash-баннерах: через flashvars и прописывание прямых ссылок на событие для каждого баннера. Рекомендуемый способ - flashvars. Если Вы используете системные шаблоны для показа flash-баннеров, все готово к вызову событий. Если же Вы используете собственный шаблон - в него необходимо внести небольшие изменения.

Вызов из flash-баннера при использовании системного шаблона.

Во flash-баннере вызов заданных через flashvars событий может производится через fscommand или loadMovieNum. Используются следующие названия flashvars: event_1 , event_2 и т.д. до event_30
Пример вызова: loadMovieNum(_root.event_1, 300)
Изменения в собственных шаблонах вызова flash-баннера

Если вы хотите использовать учет событий с вызовом из flash-баннера, используя собственные ("пользовательские") шаблоны, в эти шаблоны надо внести изменения:

1) Объявить следующую переменную:

var AdFox_FlashVars = 'event_1=%eventEncoded1%&event_2=%eventEncoded2%&event_3=%eventEncoded3%&event_4=%eventEncoded4%&event_5=%eventEncoded5%&event_6=%eventEncoded6%&event_7=%eventEncoded7%&event_8=%eventEncoded8%&event_9=%eventEncoded9%&event_10=%eventEncoded10%&event_11=%eventEncoded11%&event_12=%eventEncoded12%&event_13=%eventEncoded13%&event_14=%eventEncoded14%&event_15=%eventEncoded15%&event_16=%eventEncoded16%&event_17=%eventEncoded17%&event_18=%eventEncoded18%&event_19=%eventEncoded19%&event_20=%eventEncoded20%&event_21=%eventEncoded21%&event_22=%eventEncode22%&event_23=%eventEncoded23%&event_24=%eventEncoded24%&event_25=%eventEncoded25%&event_26=%eventEncoded26%&event_27=%eventEncoded27%&event_28=%eventEncoded28%&event_29=%eventEncoded29%&event_30=%eventEncoded30%';

Заметим что в одинарных кавычках нет никаких пробелов!

2) Использовать ее для object части кода показа flash:

 <\param name="FlashVars" value="'+AdFox_FlashVars+'"> 

3) Использовать ее для embed части: FlashVars="'+AdFox_FlashVars+'"