AdRiver - система управления интернет-рекламой
О компании Справочное руководство Вход в систему
Рекламным агентствам  AdRiver DSP 
Владельцам сайтов  AdRiver SSP 
Управление рекламой

Функциональности баннеров

Все форматы

Выбор баннера по типу кода

1. Прошивка на клик кнопки во flash-ролике

1.1. Flash ролики в ActionScript 2

В первом кадре flash-ролика пропишите следующий скрипт:

if(ar_init == undefined){
 ar_init = true;
 System.security.allowDomain('*');
}
Читать дальше

System.security.allowDomain('*') разрешает доступ загрузчику к переменным баннера и позволяет правильно инициализировать переменную для клика (link1). При этом, в загрузчике не нужно специально разрешать доступ для загружаемых роликов.

Создайте элемент button. Для него пропишите следующий скрипт:

on (release) {
       getURL(_root.link1, "_blank");
}

Для перехода по клику используется функция getURL. Ей передаётся два параметра: куда переходить — переменная link1 и _blank — значение переменной target, чтобы открывать ссылку баннера в новом окне.

Чтобы открывать ссылку баннера в том же окне, укажите _top.

Для издателей:

Если вы, как рекламная площадка, используете AdRiver в качестве основной системы управления рекламой на сайте, то в flash-ролике пропишите скрипт:

on (release) {
       getURL(_root.link1, _root.target);
}

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

Прошивка кнопки на клик для учёта кликов одновременно в AdRiver и сторонней системе

В коде вызова баннера в параметре pass укажите ссылку на сторонний счетчик для учёта кликов.

Для элемента button во flash-ролике пропишите следующий скрипт:

on(release){
	 if (_root.ar_pass){
		var temp_mc = _root.createEmptyMovieClip("temp_mc", _root.getNextHighestDepth());
		temp_mc._x = -10000;
		var mcLoader = new MovieClipLoader();
		mcLoader.addListener({onLoadInit:function(mc:MovieClip){
			mcLoader.unloadClip(mc);
		}});
		mcLoader.loadClip(_root.ar_pass, temp_mc);
	}

	getURL(_root.link1, _root.target)
}

1.2. Для Flash-роликов в ActionScript 3

В ActionScript 3 для элемента button пропишите следующий скрипт:

function callLink(event:MouseEvent):void {	
	var url:String = LoaderInfo(this.root.loaderInfo).parameters['link1'];
	try {
		var ie:String = ExternalInterface.call("function(){return !!window.ActiveXObject}");
		if (ie == "true") ExternalInterface.call('window.open',url);
		else navigateToURL(new URLRequest(url), '_blank');
	}catch (e:Error){
		navigateToURL(new URLRequest(url), '_blank');
	}
}
click_btn.addEventListener(MouseEvent.CLICK, callLink);

Прошивка кнопки на клик для учёта кликов одновременно в AdRiver и сторонней системе

В коде вызова баннера в параметре pass укажите ссылку на сторонний счетчик для учёта кликов.

Для элемента button в flash-ролике пропишите следующий скрипт:

function callLink(event:MouseEvent):void {
	var pass:String = LoaderInfo(this.root.loaderInfo).parameters['ar_pass'];	
	if(pass&&pass!="undefined") (new Loader()).load(new URLRequest(pass));	
	
	var url:String = LoaderInfo(this.root.loaderInfo).parameters['link1'];
	try {
		var ie:String = ExternalInterface.call("function(){return !!window.ActiveXObject}");
		if (ie == "true") ExternalInterface.call('window.open',url);
		else navigateToURL(new URLRequest(url), '_blank');
	}catch (e:Error){
		navigateToURL(new URLRequest(url), '_blank');
	}
}
click_btn.addEventListener(MouseEvent.CLICK, callLink);

Примеры.

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

Скрыть

2. Подсчет наведений на баннеры

Подсчет наведений на баннеры позволяет вычислить частоту взаимодействия с баннером (Interaction Rate). Для подсчета используется одно из дополнительных событий (с номером 1). Вызов события происходит при соблюдении условия: пользователь навел курсор на баннер и не уводил его с баннера в течение минимум 1 секунды.

Данная инструкции может быть использована для баннеров, состоящих из одного flash-ролика (обычный Flash-баннер, Видеобаннер, TopLine, Rich-media, CatFish и т.д.).
Для баннеров типа ScreenGlide приведенные ниже коды необходимо прописать в большой flash-ролик, т.е. событие наведение считается через 1 секунду после расхлопа баннера.

Читать дальше

Баннеры, сделанные в ActionScript2

Скачайте файлы events.as и overtrack.as и сохраните их в папку с разрабатываемым баннером; в первом кадре flash-ролика пропишите следующий скрипт:

#include "overtrack.as"

Баннеры, сделанные в ActionScript3

Скачайте и сохраните папку adriver в папку с разрабатываемым баннером;
создайте объект my_adriver, через который будут вызываться события наведения курсора на баннер. Для этого в первой строке первого кадра flash-ролика пропишите следующий скрипт:

import adriver.overtrack3;
var my_adriver:overtrack3 = new overtrack3(this, stage);
Скрыть

3. Синхронизация нескольких flash-роликов

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

Читать дальше

Подготовка синхронизированных flash-роликов

Подготовьте два flash-ролика. Один flash-ролик — главный, второй вспомогательный.
Скачайте библиотеку. Сохраните в одну папку файл arSync.as и исходники главного и второстепенных flash-роликов. Для создания эффекта синхронизации пропишите в главном flash-ролике следующий скрипт:

import arSync;

var s = new arSync("master", ["panel"]);
s.onLoad = function(){
	gotoAndPlay("start_point");
}
s.fSyncPoint1 = function() {
	gotoAndPlay("sync_point1");
}

stop();

Где new arSync("master", ["panel"]) — команда на создание синхронного баннера.
master — имя главного flash-ролика, panel — имя второстепенного flash-ролика.
Если второстепенных роликов несколько, то укажите имена через запятую, например, new arSync("master", ["panel", "panel1", "panel2"])

Во второстепенном ролике пропишите следующий скрипт:

import arSync;

var s = new arSync("panel");
s.onLoad = function(){
	gotoAndPlay("start_point");
}

stop();

Для каждого второстепенного flash-ролика укажите его имя (выделено красным).

Как только все flash-ролики синхронизируются, вызывается функция onLoad, поэтому в ней надо прописать начальные действие (например переход к кадру с меткой start_point).

Передавать команды между flash-роликами можно следующим образом:

s.sendCommand('<имя ролика, которому передаём>', '<название команды>', <параметры>);

Параметры опциональны, их можно не указывать.

Например, в 4 кадре второстепенного ролика отправляем команду второму ролику:

s.sendCommand('master', 'fSyncPoint1'); // отправка команды второму ролику

Примеры.

Скрыть

4. Учёт дополнительных событий в баннере

В мультипанельных баннерах (MPU, FlyScreen, OverLay) учёт событий уже встроен.

Читать дальше

Для того, чтобы учитывать события в баннере, выполните следующие действия:

  • скачайте файл events.as и сохраните его в папку с разрабатываемым баннером;
  • в первом кадре flash-ролика пропишите следующий ActionScript:
    #include "events.as"
    
  • в тех местах ролика, где происходит какое-либо действие, инициированное пользователем (наведение курсора мыши на активную область или клик по ссылке, открывающей дополнительную информацию), добавьте в код команду с номером закладки:
    _root.ar_TrackStage(1)
    

    Номер может быть от 1 до 9. Использовать 0 нельзя, так как это событие зарезервировано под показ баннера и вызывается автоматически.

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

  • в первом кадре flash-ролика пропишите следующий ActionScript:
    #include "events.as"
    
    var ar_url1 = "http://example1.com/";
    var ar_url2 = "http://example2.com/";
    var ar_url3 = "http://example3.com/";
    var ar_url4 = "http://example4.com/";
    

    где http://example1.com/ — http://example4.com/URL для альтернативных точек выхода. Впишите ваши URL. Если точек выхода меньше, оставьте только нужные переменные. Если альтернативных точек выхода нет, можно не задавать переменные, тогда для клика будет использоваться ссылка, прописанная в поле «URL баннера».

  • в тех местах ролика, где происходит какое-либо действие, инициированное пользователем (наведение курсора мыши на активную область или клик по ссылке, открывающей дополнительную информацию), добавьте в код команду с номером закладки:
    _root.ar_TrackStage(1)
    

    Номер может быть от 1 до 4. Использовать 0 нельзя, так как это событие зарезервировано под показ баннера и вызывается автоматически. События с 5 по 9 зарезервированы под клики по разным ссылкам.

  • в тех зонах, где происходит переход на сайт, добавьте команду:
    _root.ar_Link(0)

    Номер может быть от 1 до 4. Номер 0 используется для клика, который прописан в поле «URL баннера» (generic link).

Управление событиями из HTML-баннеров

Для того, чтобы сгенерировать событие для HTML-баннера, необходимо загрузить с сервера AdRiver определённый адрес. Адрес составляется следующим образом:

<script type="text/javascript">
	function ar_event(n) {
		if ((location.href.indexOf('mngcgi') !== -1)) return false;
		var d = document, b = d.body, send,
			src = ('https:' === location.protocol ? 'https:' : 'http:') + '//' + ar_rhost + '/cgi-bin/event.cgi?' + ar_p('bid', ar_bid) + ar_p('&sid', ar_sid) + ar_p('&bt', ar_bt) + ar_p('&ad', ar_ad) + ar_p('&ntype', ar_ntype) + ar_p('&nid', ar_nid) + ar_p('&sliceid', ar_sliceid) + ar_p('&rnd', ar_rnd) + ar_p('&xpid', ar_xpid) + '&type=';

		if (b) {
			send = function(src) {
				var i = d.createElement('img');
				i.style.width = i.style.height='0px'; i.style.position = 'absolute';
				i.onload = i.onerror = function(){b.removeChild(i)};
				i.src = src;
				b.insertBefore(i, b.firstChild);
			}
		} else { send = function(src) { new Image().src = src; } }

		send(src + n);
		ar_event = function(n) { send(src + n); }
	}

	ar_event(0);
</script>

Для учета событий вызовите функцию ''ar_event(n)'', где n - номер события. В примере указан номер 0.

Вставьте в код необходимый номер события.

События нумеруются от 0 до 9. События с номерами больше 9 рассматриваются как ошибка и не засчитываются. События с 1 по 9 засчитываются только если произошло событие 0.

Если вы используете функцию подсчета Viewability баннера, то использовать 0-ое событие нельзя, т.к. оно автоматически вызывается для подсчета Viewability.

Управление событиями из JavaScript-баннеров

Для того, чтобы сгенерировать событие для JavaScript-баннера, необходимо загрузить с сервера AdRiver определённый адрес. Адрес составляется следующим образом:

function ar_event(n) {
	if ((location.href.indexOf('mngcgi') !== -1)) return false;

	var d = document, b = d.body, send,
		p = function(param, value) { return typeof(value) === 'undefined' ? '' : param + '=' + value; },
		src = ('https:' === location.protocol ? 'https:' : 'http:') + '//' + ar_rhost + '/cgi-bin/event.cgi?' + p('bid', bid) + p('&sid', ar_siteid) + p('&bt', ar_bt) + p('&ad', ar_adid) + p('&ntype', ar_ntype) + p('&nid', ar_nid) + p('&sliceid', sliceid) + p('&rnd', RndNum4NoCash) + p('&xpid', ar_xpid) + '&type=';

	if (b) {
		send = function(src) {
			var i = d.createElement('img');
			i.style.width = i.style.height='0px'; i.style.position = 'absolute';
			i.onload = i.onerror = function(){b.removeChild(i)};
			i.src = src;
			b.insertBefore(i, b.firstChild);
		}
	} else { send = function(src) { new Image().src = src; } }

	send(src + n);
	ar_event = function(n) { send(src + n); }
}

ar_event(0);

Для учета событий вызовите функцию ''ar_event(n)'', где n - номер события. В примере указан номер 0.

События с 1 по 9 засчитываются, только если произошло событие 0.

Если вы используете функцию подсчета Viewability баннера, то использовать 0-ое событие нельзя, т.к. оно автоматически вызывается для подсчета Viewability.

Использование событий в баннерах с ActionScript 3

Для того, чтобы учитывать события в баннере, выполните следующие действия:

  • скачайте и сохраните папку adriver в папку с разрабатываемым баннером;
  • создайте объект my_adriver, через который будут вызываться все события и клики. Для этого в первой строке первого кадра flash-ролика пропишите следующий скрипт:
    import adriver.events3;
    var my_adriver:events3 = new events3(this, stage);
    
  • в тех местах ролика, где надо вызвать событие, добавьте в код команду с номером события (#):
    my_adriver.ar_TrackStage(#);
    

    События с 1 по 9 засчитываются, только если произошло событие 0. Нулевое событие вызывается автоматически библиотекой.

  • если есть несколько альтернативных точек выхода, то для учёта кликов, пропишите следующий скрипт:
    в первом кадре определяем переменные с URL перехода:
    this.ar_url1 = 'http://example1.com/';
    this.ar_url2 = 'http://example2.com/';
    
    назначаем клики на кнопки:
    function callLink_1(event:MouseEvent):void {
       my_adriver.ar_Link(1)
    }
    function callLink_2(event:MouseEvent):void {
       my_adriver.ar_Link(2)
    }
    btn1.addEventListener(MouseEvent.CLICK, callLink_1);
    btn2.addEventListener(MouseEvent.CLICK, callLink_2);
    

Если точка выхода всего одна, то для учёта кликов в общей статистике баннера можно использовать функцию ar_MakeClick. Она вызывается следующим образом:

my_adriver.ar_MakeClick();
в качестве параметра функции можно передать альтернативный URL перехода:
my_adriver.ar_MakeClick('http://example.com/');

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

function clk(event:MouseEvent):void {
   my_adriver.ar_MakeClick();
}
button.addEventListener(MouseEvent.CLICK, clk);
Скрыть

5. Подгрузка дополнительных частей, загруженных в баннер (flash, видео, аудио)

К переменной _root.ar_comppath допишите имя подгружаемого компонента. Например:

_root.ar_comppath + 'flash_name.swf'

6. Ограничения на размер загружаемых файлов

  • графические файлы (в интерфейсе обозначены img width x height) — 200 Кб;
  • swf-файлы (в интерфейсе обозначены flash width x height) — 200 Кб;
  • другие типы файлов — 200 Кб;
  • для многокомпонентных баннеров ограничения проверяются отдельно для каждой составляющей.

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

Читать дальше

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

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

Скрыть

7. Прошивка на клик нескольких кнопок во flash-ролике

Во flash-ролике может быть несколько элементов типа button. В зависимости от того, на какой из элементов кликнули, посетитель может быть направлен на разные адреса. В этом случае вы можете явно указать, на какой адрес должен быть направлен посетитель. Пример:

on (release) {
       getURL(_root.link1+escape("http://alternative.url.to.go/path?search#hash"),_root.target);
}

Обязательно кодируйте адрес функцией escape().


8. Лёгкий загрузчик и подгрузка внешнего контента

Подгружать можно и тяжелый контент (видео, звук, flash), компонент может быть несколько. Выделим три случая размещения:

  1. Тяжёлый контент и лёгкий загрузчик располагаются в AdRiver.
  2. Тяжёлый контент и лёгкий загрузчик располагаются на площадке. Аудит размещения в AdRiver.
  3. Тяжёлый контент располагается в AdRiver, лёгкий загрузчик располагается на площадке. Аудит размещения в AdRiver
Читать дальше

Скачать пример и исходники лёгкого загрузчика. По умолчанию пытается загрузить файл big.swf.

1. Тяжёлый контент и лёгкий загрузчик располагаются в AdRiver

Для того, чтобы подгрузить в загрузчик тяжёлый контент, пропишите в загрузчике следующий ActionScript:

loadMovieNum(_root.ar_comppath + 'flash_name.swf', 500);

Где

  • flash_name.swf — имя тяжёлого баннера. Впишите ваше имя файла;
  • _root.ar_comppath — переменная, содержащая путь к баннеру в AdRiver.

Прошивка на клик по требованиям AdRiver.

2. Тяжёлый баннер и лёгкий загрузчик располагаются на площадке. Аудит размещения в AdRiver

Для аудита такого размещения, выполните следующие действия.

  • Добавьте баннер audit.
  • Получите ссылки на показ и на клик. Например:
    Счётчик:
    http://ad.adriver.ru/cgi-bin/rle.cgi?sid=1&ad=119706&bt=55&pid=250384&bid=482081&bn=482081&rnd=788518980
    
    Ссылка для клика:
    http://ad.adriver.ru/cgi-bin/click.cgi?sid=1&ad=119706&bt=55&pid=250384&bid=482081&bn=482081&rnd=788518980
    
  • Впишите эти ссылки в поля для аудита в сторонней системе (как в AdRiver есть поля для сторонних счётчиков).

При использовании пиксель-аудита в самом flash-ролике, выполните следующие действия:

  • Добавьте баннер audit.
  • Получите ссылки на показ и на клик. Например:
    Счётчик:
    http://ad.adriver.ru/cgi-bin/rle.cgi?sid=1&ad=119706&bt=55&pid=250384&bid=482081&bn=482081&rnd=788518980
    
    Ссылка для клика:
    http://ad.adriver.ru/cgi-bin/click.cgi?sid=1&ad=119706&bt=55&pid=250384&bid=482081&bn=482081&rnd=788518980
    
    Удалите значение случайного числа (выделено красным).
  • В первом кадре flash-ролика пропишите следующий скрипт:
    if (ar_init == undefined)
    {
    var ar_init = 1;
    loadMovieNum("pixel" + Math.round(Math.random() * 1000000), 500);
    }
    

    В ActionScript 3 используйте следующий скрипт:

    if(!this['ar_init']){
       this['ar_init'] = true;
       (new Loader()).load(new URLRequest("pixel" + Math.round(Math.random() * 1000000)));
    }
    
  • Замените слово «pixel» на соответствующий код для подсчёта показов в AdRiver.

    Пример кода (изменения выделены красным):

    if (ar_init == undefined)
    {
    var ar_init = 1;
    loadMovieNum("http://ad.adriver.ru/cgi-bin/rle.cgi?sid=1&ad=119706&bt=55&pid=250384&bid=482081&bn=482081&rnd=" + Math.round(Math.random() * 1000000), 500);
    }
    

    Пример кода в ActionScript 3 (изменения выделены красным):

    if(!this['ar_init']){
       this['ar_init'] = true;
       (new Loader()).load(new URLRequest("http://ad.adriver.ru/cgi-bin/rle.cgi?sid=1&ad=119706&bt=55&pid=250384&bid=482081&bn=482081&rnd=" + Math.round(Math.random() * 1000000)));
    }
    
  • Ссылку для клика впишите в соответствующее поле в сторонней системе.

Прошивка на клик по требованиям площадки.

3. Тяжёлый баннер располагается в AdRiver, лёгкий загрузчик располагается на площадке. Аудит размещения в AdRiver

Для аудита такого размещения, выполните следующие действия.

  • Добавьте в AdRiver баннер redirect-flash (swf-компонента) или flv-video (flv-компонента). Так как эти типы баннеров позволяют передавать сторонней системе location на баннер, загруженный в AdRiver. Включите баннер.

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

  • Сгенерируйте код баннера. Из всего кода вам понадобится ссылка на показ (выделена красным). Например:
    <!--  AdRiver code START. Type:Redirect240x400 Site: example PZ: 0 BN: 0 -->
    <script language="javascript" type="text/javascript"><!--
    var RndNum4NoCash = Math.round(Math.random() * 1000000000);
    var ar_flashver = 6;
    var ar_html     = '';
    var ar_metrics  = ' width=240  height=400';
    var ar_redirect = 'link1=' + escape('http://ad.adriver.ru/cgi-bin/click.cgi?sid=94499&bt=44&pz=0&rnd=' + RndNum4NoCash + '&target=top');
    var ar_Tail='unknown'; if (document.referrer) ar_Tail = escape(document.referrer);
    
    ar_flashver = parseInt(ar_flashver);if(isNaN(ar_flashver)) ar_flashver = 0;
    
    function ar_flver(d,n,m,f){
        n = navigator;
        f = 'Shockwave Flash';
        if ((m = n.mimeTypes) && (m = m["application/x-shockwave-flash"]) && m.enabledPlugin && (n=n.plugins) && n[f]) {d = n[f].description;}
        else if(window.ActiveXObject) { try { d=(new ActiveXObject((f + '.' + f).replace(/ /g,''))).GetVariable('$version')}catch(e){}}
        return d ? d.replace(/\D+/,'').split(/\D+/)[0] : 0;
    }
    
    if(ar_flashver <= ar_flver()) {
            var ar_src = 'http://ad.adriver.ru/cgi-bin/erle.cgi?sid=94499&target=top&bt=44&pz=0&rnd=' + RndNum4NoCash + '&tail256=' + ar_Tail;
            ar_html = '<object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"' + ar_metrics + '>'
            + '<param name=movie value="' + ar_src + '&' + ar_redirect + '">'
            + '<param name=play value=true>'
            + '<param name=loop value=true>'
            + '<param name=quality value=high>'
            + '<param name=menu value=false>'
            + '<param name=flashvars value="' + ar_redirect + '">'
            + '<param name=allowscriptaccess VALUE=always>'
            + '<embed type="application/x-shockwave-flash" src="' + ar_src + '"' + ar_metrics
            + ' play=true loop=true quality=high menu=false  flashvars="' + ar_redirect + '"></embed>'
    
            + '</object>';
    } else {
            ar_html = '<img src="http://mirror.adriver.ru/expelled.gif"' + ar_metrics + ' alt="You do not have a flash plugin" border=0>';
    }
    document.write(ar_html);
    //--></script>
    <script language="JavaScript" type="text/javascript" src="http://mirror.adriver.ru/ieupdate.js"></script><!--  AdRiver code END  -->
    
  • В итоге ссылка на показ будет выглядеть следующим образом. Пример:
    http://ad.adriver.ru/cgi-bin/erle.cgi?sid=94499&target=top&bt=44&pz=0&rnd=[случайное число]
    
  • Клики можно учитывать, добавив кликовый баннер.
  • Ссылки для показа и клика пропишите в загрузчике в соответствии с требованиями сторонней системы.

Прошивка на клик по требованиям площадки.

Скрыть

9. Запуск видеобаннера по различным действиям пользователя

  1. По наведению курсора мыши
  2. По клику
  3. Без каких-либо действий пользователя через время
Читать дальше

1. Запуск видеобаннера по наведению курсора мыши

Видеоролик загружен в AdRiver вместе с баннером.

В нужном кадре flash-ролика пропишите следующий скрипт:

on (rollOver){
        loadMovieNum(_root.ar_comppath + 'flash_name.swf', 500);
}

flash_name.swf — имя видеоролика, загруженного в AdRiver вместе с баннером.

Видеоролик располагается на стороннем сервере.

В нужном кадре flash-ролика пропишите следующий скрипт:

on (rollOver){
        loadMovieNum('http://www.example.com/video.swf', 500);
}

http://www.example.com/video.swf — полный путь к видеофайлу на стороннем сервере.

2. Запуск видеобаннера по клику

Видеоролик загружен в AdRiver вместе с баннером.

В нужном кадре flash-ролика пропишите следующий скрипт:

on (release){
        loadMovieNum(_root.ar_comppath + 'flash_name.swf', 500);
}

flash_name.swf — имя видеоролика, загруженного в AdRiver вместе с баннером.

Видеоролик располагается на стороннем сервере.

В нужном кадре flash-ролика пропишите следующий скрипт:

on (release){
        loadMovieNum('http://www.example.com/video.swf', 500);
}

http://www.example.com/video.swf — полный путь к видеофайлу на стороннем сервере.

3. Запуск видеобаннера без каких-либо действий пользователя через время

Видеоролик загружен в AdRiver вместе с баннером.

В нужном кадре flash-ролика пропишите следующий скрипт:

function time(){
        loadMovieNum(_root.ar_comppath + 'flash_name.swf', 500);
		}
	setTimeout(time, 3000);
  • flash_name.swf — имя видеоролика, загруженного в AdRiver вместе с баннером.
  • 3000— время в миллисекундах.

Видеоролик располагается на стороннем сервере.

В нужном кадре flash-ролика пропишите следующий скрипт:

function time(){
		loadMovieNum('http://www.example.com/video.swf', 500);
		}
	setTimeout(time, 3000);
  • http://www.example.com/video.swf — полный путь к видеофайлу на стороннем сервере.
  • 3000— время в миллисекундах.

Примеры.

Скрыть

10. Таймер обратного отсчёта для баннеров FullScreen и FlashFull

var timerSec = 15;
function set_timer(){
    _root.txt.text = "возврат на сайт " + _root.site_name + " через " + timerSec + " секунд";
    var aaa = setInterval(function(){
        if (timerSec == 0) {
            clearInterval(aaa);
            getURL(_root.ar_backref, "_self");
            stop();
            return;
        }
        --timerSec;
        _root.txt.text = "возврат на сайт " + _root.site_name + " через " + timerSec + " секунд";
    }
    , 1000);
};
set_timer(); 

11. Кнопка «закрыть» для баннеров FullScreen, FlashFull и Rich-media

  1. Для баннеров FullScreen, FlashFull.
  2. Для баннеров Rich-media.
Читать дальше

1. Кнопка «закрыть» для баннеров FullScreen, FlashFull

on(release)
{
     getURL(_root.ar_backref, "_self");
}

2. Кнопка «закрыть» для баннеров Rich-media

on (release) {
    richClose();
}

FullScreen, FlashFull, Rich-media.

Скрыть

12. Расхлоп/вылет панелей по наведению курсора мыши. Убирание/сворачивание панелей при отводе курсора мыши. Для баннеров MPU

Расхлоп/вылет панелей по наведению курсора мыши:

on(rollOver){
sendSync("showPanel2")
}

Убирание/сворачивание панелей при отводе курсора мыши:

on(rollOut){
sendSync("hidePanel2")
}

13. Расхлоп/вылет панелей по истечении времени. Убирание/сворачивание панелей по истечении времени. Для баннеров MPU

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

sendSync("showPanel2")

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

sendSync("hidePanel2")

Примеры.


14. Использование данных со страницы, например, имени пользователя, названия статьи

Рассмотрим пример использования имени пользователя в баннере.

Читать дальше

Скачайте пример комплекта файлов для баннера. Сохраните в одну папку файл siteData.as и исходники баннера.

В нужном кадре flash-ролика пропишите следующий скрипт:

var sd = new siteData("http://www.site.ru/storage.swf",{name : "Дорогой друг"});

var l = {
    onLoadComplete: function (){
        _root._txt1.text = 'Привет, ' + sd.name + '!';
    }
}

sd.addEventListener("onLoadComplete", l);
  • http://www.site.ru/storage.swf — путь к файлу storage.swf на вашем сайте.
  • Дорогой друг — имя пользователя по умолчанию.
  • _root._txt1.text = 'Привет, ' + sd.name + '!'; — часть скрипта для вывода текста в баннер в заранее созданное текстовое поле _txt1.

В файле index.html приведён пример размещения кода на странице. Обязательно размещайте на странице скрипт для storage.

Пример.

Скрыть

15. Показ баннера по условиям, заданным другим баннером (для кодов ajax)

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

Читать дальше

15.1. С использованием пользовательского таргетинга

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

Для первого баннера в поле Alt (Альтернативный текст) задается ключевое слово. На странице размещается два кода вызова. После ответа AdRiver на вызов первого баннера, срабатывает событие onLoadComplete и вызывается второй баннер, при этом ключевое слово из поля Alt первого баннера подставляется в параметр custom второго баннера на первую позицию. Таким образом, второй баннер вызывается в соответствии с указанным пользовательским таргетингом.

Пример кода:

new adriver('banner1', {bt: 52, sid: 103134, bn: 1}).onLoadComplete(function(){
	new adriver('banner2', {bt: 52, sid: 103134, bn: 2, custom: {1: this.reply.alt}});
});

15.2. С использованием таргетинга по ключевым словам

Для первого баннера в поле Alt (Альтернативный текст) задается ключевое слово. На странице размещается два кода вызова. После ответа AdRiver на вызов первого баннера, срабатывает событие onLoadComplete и вызывается второй баннер, при этом ключевое слово из поля Alt первого баннера подставляется как keyword второго баннера. Таким образом, второй баннер вызывается в соответствии с настроенным таргетингом по ключевым словам.

Пример кода:

new adriver('banner1', {bt: 52, sid: 123456, bn: 1}).onLoadComplete(function(){
	new adriver('banner2', {bt: 52, sid: 123456, bn: 2, keyword: this.reply.alt});
});
Скрыть

16. Подгрузка обновляемой витрины (или иного xml-контента)

Витрина — это flash-баннер, который показывает изображение и подпись к нему. При загрузке баннера показывается одно изображение, при следующей загрузке баннера покажется другое изображение. При клике по разным изображениям происходит переход на разные URL-адреса. Для реализации витрины потребуется flash-ролик необходимого размера, который вызывает xml-файл, созданный специально для конкретного баннера и содержащий ссылки на изображения, ссылки для кликов и описание. Изображения и xml-файл располагаются на стороннем сервере. В AdRiver засчитываются показы flash-баннера и сумма кликов по всем изображениям в баннере. То есть, в статистике баннера будет сумма всех показов/кликов.

Пример.

Читать дальше

16.1. Подготовка flash-ролика

В нужном кадре flash-ролика пропишите следующий скрипт:

if (_root.ar_comppath == undefined) {
    _root.ar_comppath = '';
}

function _rand(n){ // возвращает целое число в диапазоне [0..n]
    return Math.round(Math.random()*n)
}

var reviews_xml:XML = new XML();//создать объект типа XML
reviews_xml.ignoreWhite = true;// игнорировать пустые строки
reviews_xml.onLoad = function(success:Boolean):Void  {
    if (success) {//  XML пришёл успешно
        var childItems:Array = reviews_xml.firstChild.childNodes;

        // получаем случайный item из массива
        childItems = childItems[_rand(childItems.length-1)].childNodes;

        var r = {};//  создать объект r, в который запишем все переменные
        for (var i:Number = 0; i<childItems.length; i++) {
            r[childItems[i].nodeName] = childItems[i].firstChild.nodeValue;
        }
        _root.link1 += r['ar_cgihref'];// в переменную _root.link1 дописать значение ar_cgihref (клик) из XML
        _root.txt.text = r['ar_text'];// вывод текста из XML
        if (r['ar_image'].indexOf('http://') != 0) {// если адрес изображения не начинается с http://, то это изображение загружено в баннер
            r['ar_image'] = _root.ar_comppath+r['ar_image'];
        }
        // загружаем изображение в ролик pict
        var mcLoader:MovieClipLoader = new MovieClipLoader();
        var listener = {
            onLoadInit:function (mc:MovieClip) {
                mc._width = 200;
                mc._height = 200;
            }
        };
        mcLoader.addListener(listener);
        mcLoader.loadClip(r['ar_image'],_root.pict);
    } else {
        trace("Unable to load external file.");// обработка ошибки, если XML не пришёл.
    }
};
reviews_xml.load(_root.ar_comppath+'0.xml?'+Math.round(Math.random()*1000000));// вызываем XML 

mc._width, mc._height — размеры изображения.

16.2. XML-файл

Пример xml-файла:

<?xml version="1.0" encoding="UTF-8"?>
<root>
<item>
<ar_image>http://example.com/soloway_200.png</ar_image>
<ar_text>«Соловей» — первый оператор селективной рекламы.</ar_text>
<ar_cgihref>http://www.soloway.ru/</ar_cgihref>
</item>
<item>
<ar_image>http://example.com/adriver1.gif</ar_image>
<ar_text>AdRiver — система управления интернет-рекламой номер один.</ar_text>
<ar_cgihref>http://www.adriver.ru</ar_cgihref>
</item>
<item>
<ar_image>http://example.com/rle.gif</ar_image>
<ar_text>RLE — крупнейшая баннерообменная сеть в Рунете.</ar_text>
<ar_cgihref>http://www.rle.ru/</ar_cgihref>
</item>
</root>

Здесь каждая часть item — это набор следующих составляющих:

  • ar_image — изображение;
  • ar_text — текст;
  • ar_cgihref — ссылка для клика.

Части item в баннере для ротации выбираются случайным образом.

При загрузке баннера, если xml-файл располагается на стороннем сервере, то добавьте обычный flash-баннер нужного размера. Кликните «загрузить баннер» и загрузите компоненты баннера. В поле «Линк Баннера» можно указать дефолтный клик, чтобы баннер был кликабельным в том случае, если xml-файл не загрузится.

Скрыть

17. Вежливая загрузка (оценка скорости канала пользователя)

Данный скрипт подходит для оценки скорости канала пользователя для всех типов кодов в AdRiver.

Если скорость выше заданного значения, то проигрывается flash-ролик. Если скорость недостаточная, то отображается gif-заглушка, flash-ролик не проигрывается.

Читать дальше

Подготовка баннера

Скачайте библиотеку измерения скорости канала и пример исходников.

В нужном кадре flash-ролика пропишите следующий скрипт:

import speedLoad;

new speedLoad([
	[0, _root.ar_comppath + '0.gif'],
	[5000, _root.ar_comppath + '0.swf'],
	[200000, 'http://example.com/1383/big_fp8.swf']
], clip);

Описание:

  1. import speedLoad — подключить библиотеку;
  2. speedLoad — команда на загрузку баннера с измерением скорости канала. Формат команды:
    new speedLoad([
    	 [0, <заглушка или лёгкий баннер>],
    	 [<скорость в килобитах>, <более тяжёлый баннер>],
    	 ...
    ], <клип>);
    • если лёгкий/тяжёлый баннер загружен в AdRiver, то путь к нем указывается в формате _root.ar_comppath + '0.gif', где 0.gif — имя баннера;
    • если лёгкий/тяжёлый баннер загружается со стороннего сервера, то указывается полный путь до баннера в формате http://example.com/1383/big_fp8.swf.
  3. clip — MovieClip во flash-ролике, в который будут загружаться баннеры. Он должен быть заранее создан.

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

Cкорость канала измеряется следующим образом.

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

Пример.

Скрыть
 
Последнее обновление: 2015072119