Функциональности устаревших форматов

1. Прошивка баннера на клик (обязательное требование для всех Flash-баннеров)

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

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

1.1. Прошивка на клик баннеров на ActionScript 2

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

if(ar_init == undefined){
   ar_init = true;
   System.security.allowDomain('*');
}

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

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

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

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

Если необходимо открывать ссылку баннера в текущем окне, значение _blank следует заменить на значение _top.

Важно: Наличие переменной link1 обязательно – она используется для подсчета кликов по баннеру, ее значение категорически нельзя изменять. Ссылка перехода при клике указывается при добавлении баннера в интерфейсе системы в поле Линк баннера.

Если вы, как рекламная площадка, используете AdRiver в качестве основной системы управления рекламой на сайте, то вторым параметром укажите _root.target:

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

Данный код позволит открывать ссылку баннера согласно тому параметру, который указан в коде рекламного места. Нужный параметр указывается при генерации HTML-кода в интерфейсе системы в зависимости от наличия галки Открывать ссылку баннера в новом окне (см. Получение и размещение HTML-кода).

Примечание: Если в коде баннера прописано значение переменной target, равное _top или _blank, то изменить его в интерфейсе системы будет невозможно. В этом случае наличие галки Открывать ссылку баннера в новом окне ни на что влиять не будет.

1.2. Прошивка на клик баннеров на 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);

Важно: Наличие переменной link1 обязательно – она используется для подсчета кликов по баннеру, ее значение категорически нельзя изменять. Ссылка перехода при клике указывается при добавлении баннера в интерфейсе системы в поле Линк баннера.

Если необходимо открывать ссылку баннера в текущем окне, значение _blank следует заменить на значение _top.

Если вы, как рекламная площадка, используете AdRiver в качестве основной системы управления рекламой на сайте, то значение _blank следует заменить на значение _root.target. Данное значение позволит открывать ссылку баннера согласно тому параметру, который указан в коде рекламного места.

Скрыть

2. Прошивка на альтернативные клики

Элементов типа button может быть несколько. В зависимости от того, на какой из элементов кликнули, посетитель может быть направлен на разные адреса. В этом случае вы можете явно указать, на какой адрес должен быть направлен посетитель. Обязательно кодируйте адрес функцией escape().

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

Пример для ActionScript 2

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

http://alternative.url.to.go/path?search#hash – адрес перехода.

Пример для ActionScript 3

function callLink(event:MouseEvent):void {
    var url:String = LoaderInfo(this.root.loaderInfo).parameters['link1'];
    var alt_url= escape("http://alternative.url.to.go/path?search#hash");
    try {
        var ie:String = ExternalInterface.call("function(){return !!window.ActiveXObject}");
         if (ie == "true") ExternalInterface.call('window.open',url+alt_url);
        else navigateToURL(new URLRequest(url+alt_url), '_blank');
    }catch (e:Error){
        navigateToURL(new URLRequest(url+alt_url), '_blank');
    }
}
 click_btn.addEventListener(MouseEvent.CLICK, callLink);

http://alternative.url.to.go/path?search#hash – адрес перехода.

Скрыть

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

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

3.1. Для баннеров на ActionScript 2

В коде вызова баннера в параметре 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)
}

3.2. Для баннеров на ActionScript 3

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

В ActionScript 3 для элемента 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);
Скрыть

4. Подгрузка в баннер дополнительных компонент

Вместе с баннером IFrame или не стандартным баннером типа Generic-Ajax в AdRiver могут быть загружены дополнительные части (flv, swf, xml-файлы)

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

4.1. IFrame баннеры и Generic-Ajax баннеры

Вместе с баннером IFrame или не стандартным баннером типа Generic-Ajax в AdRiver могут быть загружены дополнительные части (flv, swf, xml-файлы). Для этого в форме загрузки IFrame-баннера есть специальное поле Дополнительная компонента. В форме загрузки Generic-Ajax баннера компоненты выбираются с помощью кнопки Обзор. Чтобы подгружать в Flash-ролик дополнительные части, загруженные в баннер, необходимо дописать к перeменной _root.ar_comppath имя подгружаемого компонента.

Получить доступ к загруженному файлу из Flash-ролика на AS2 можно следующим образом:

_root.ar_comppath + 'имя загруженного файла'

Получить доступ к загруженному файлу из Flash-ролика на AS3 можно следующим образом:

my_adriver.ar_comppath + 'имя загруженного файла'

Если загружен swf-файл, то для его подгрузки в Flash-ролик можно использовать код вида:

on (release){
loadMovieNum(_root.ar_comppath + 'имя загруженного файла', 500);
}

Если загружен xml-файл, то для его подгрузки в Flash-ролик можно использовать код вида:

myXML = new XML();
myXML.load(_root.ar_comppath + 'имя загруженного файла');

Если загружен flv-файл, то для его подгрузки можно использовать Netstream или FLVPlayBack.

Пример 1:

var nс:NetConnection = new NetConnection();
nс.connect(null);
var ns:NetStream = new NetStream(nс);
videoContainer.attachVideo(ns); //videoContainer - это объект, который позволяет воспроизводить видеофайлы во flash-ролике 
ns.play(_root.ar_comppath + 'имя загруженного файла');

Пример 2:

var myVideo:FLVPlayback = new FLVPlayback();
myVideo.source = _root.ar_comppath + 'имя загруженного файла';

4.2. Для баннеров на ActionScript 3

Для баннеров на кодах Ajax (не Generic), Extension, Poster, JavaScript дополнительные компоненты должны быть загружены на сторонний сервер. Все компоненты баннера должны быть расположены в одной папке. Для подгрузки компоненты в Flash-файл необходимо указывать полный путь до нее на сервере, начиная с http:// или https://.

Скрыть

5. Размещение flv-видеороликов в видеоконтенте

Рекламный продукт представляет собой preroll, который показывается перед основным видеороликом. Для таргетирования (поведенческие таргетинги, дата, время, частота показа, география) используется система AdRiver. AdRiver позволяет управлять демонстрацией роликов, получать статистику по проведённым размещениям.

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

См. также: XML-баннер.

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

5.1. Подготовка загрузчика

Скачать пример исходников загрузчика.

Рекомендации.

  • Используйте восьмую версию Flash и выше.
  • Используйте для видео FLV. Кодек может быть любой, рекомендуется использовать On2 (ориентируясь на восьмую версию Flash).
  • Начинайте проигрывание видеоролика сразу, либо после загрузки 400 Кб видео. Не ожидайте полной загрузки ролика, в процессе проигрывания видеофайл загрузится полностью.

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

Описание работы плеера, размещаемого на сайте.

  • При загрузке страницы сайта, загружается сам плеер.
  • Плеер открывает netstream, обращается к AdRiver и устанавливает таймаут.

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

    Примечание: Кроме формирования адреса запроса и клика внутри плеера можно использовать передачу готовых параметров из HTML через переменную. Такой способ удобен, когда на некоторых страницах реклама не показывается. В этом случае в плеер не передаётся запрос на показ, а в плеере делается соответствующая проверка. Если плеер встроен во Flash-сайт, то код удобнее формировать внутри плеера.

  • Если таймаут закончился, но ничего не произошло, например, AdRiver не успел ответить или недоступен, то плеер пропускает загрузку рекламного ролика, закрывает netstream и загружает основной видеоконтент.

    AdRiver в любом случае отвечает что-либо, независимо от того, нужно показывать баннер или нет. Значит плеер должен уметь корректно обрабатывать заглушки. В качестве заглушки можно использовать пустой FLV-файл, в котором в MetaData заданы параметры, определяющие, что это заглушка. Например: минимальная продолжительность ролика, размер ролика (ширина, высота). Для Adobe video exporter продолжительность — 0,001 секунды, размер — 32 px.

    Скачать пример заглушки.

  • Если за время таймаута получен ответ от AdRiver (то есть, у netstream сработал обработчик onMetadata), то анализируется metadata загружаемого ролика.
    • Если загружаемый ролик — это заглушка, то этот netstream закрывается и загружается основной видеоконтент.
    • Если загружаемый ролик — это не заглушка, то поверх слоя с видеоплеером показывается слой с кнопкой для клика и начинается воспроизведение рекламного видеоролика.

    Слой с кнопкой для клика — это элемент button, который располагается в самом верхнем прозрачном слое. В обработчике событий элемента button пропишите следующий скрипт:

    on (release) {
         getURL(_root.link1, "_blank");
    }
    
  • После завершения рекламного ролика происходит показ основного видеоконтента. Кнопка при этом скрывается.

При использовании в основном видеоконтенте cue-points, можно реализовать альтернативную логику, когда рекламный ролик размещается не строго в начале трансляции, а может быть расположен в любом месте сюжета. В таком случае в загрузчик добавляется обработчик cue points, по приходу cue point (e.g. «banner») основной контент приостанавливается, идёт обращение к AdRiver и показ видеорекламы. При этом в cue point можно передавать параметр, например ключевое слово или номер ролика (1 — начало трансляции, 2 — второй ролик, 3 — третий ролик и т.д.)

5.2. Получение кода баннера

Код баннера для preroll представляет собой обычное баннерное место формата Flv video. Так как по URL определить зону сайта в данном случае невозможно, то в код, при необходимости, добавляется параметр sz. При вызове могут использоваться и другие переменные pz, bn, ключевые слова и т.д.

Например, если одновременно используются preroll и postroll, то для preroll формируется код Flv video с параметром bn=1, а для postroll формируется код код Flv video с параметром bn=2.

  • Сгенерируйте код для баннерного места Flv video.

    Модифицируйте полученный код, удалив значение случайного числа (выделено красным):

    http://ad.adriver.ru/cgi-bin/erle.cgi?sid=92926&bn=1&target=top&bt=53&pz=0&rnd=1195980430
    http://ad.adriver.ru/cgi-bin/click.cgi?sid=92926&bn=1&bt=53&pz=0&rnd=1195980430
    
  • Сформируйте итоговую ссылку, например, вот так:
    var ar_sz = "news";
    var RndNum4NoCash = Math.round(Math.random() * 1000000000);
    var ar_src = 'http://ad.adriver.ru/cgi-bin/erle.cgi?sid=92926&bn=1&target=top&bt=53&pz=0&rnd=' + RndNum4NoCash + '&sz=' + ar_sz;
    var ar_click = 'http://ad.adriver.ru/cgi-bin/click.cgi?sid=92926&bn=1&bt=53&pz=0&rnd=' + RndNum4NoCash + '&sz=' + ar_sz; 
    

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

5.3. Настройка рекламной кампании

  • Добавьте сайт на ваш аккаунт в системе AdRiver.
  • Разделите сайт на тематические зоны (если это предусматривается). При задании зон сайта используйте алиасы, а не шаблоны URL.

    Например, зона Главная страница с алиасом main.

  • Сгенерируйте HTML-код типа Flv video для каждой зоны сайта (или код, без указания конкретной зоны сайта, когда алиас подставляется динамически).
  • Добавьте в кампанию по умолчанию баннер-заглушку типа Flv video.

    Параметры баннера-заглушки должны однозначно интерпретироваться загрузчиком, как заглушка (duration, width, height, и др.)

  • Реализуйте загрузчик.

    Проверьте работоспособность плеера. Должны происходить следующие события:

    • в AdRiver засчитываются запросы кода на сайте по зонам сайта;
    • в кампании по умолчанию засчитываются показы заглушки;
    • основной видеоконтент показывается.
  • Создайте рекламную кампанию, включите её, передайте необходимое количество кредитов или установите галочку Использовать общие кредиты — в этом случае рекламная кампания будет работать, пока на аккаунте есть кредиты.
  • В рекламную кампанию добавьте сценарий и, при необходимости, настройте таргетинг.
  • Разместите в AdRiver рекламный ролик клиента. Если видеоролик располагается на видеохостинге, то при загрузке баннера укажите ссылку на показ в поле Location, а ссылку на клик в поле Линк Баннера.
  • В сценарий добавьте баннер типа Flv video.
Скрыть

6. Синхронизация нескольких 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'); // отправка команды второму ролику
Скрыть

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

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

7.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 — полный путь к видеофайлу на стороннем сервере.

7.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 — полный путь к видеофайлу на стороннем сервере.

7.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— время в миллисекундах.
Скрыть

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

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

sendSync("showPanel2");

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

sendSync("hidePanel2");

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

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

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

Скачайте пример комплекта файлов для баннера. Сохраните в одну папку файл 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.

Скрыть

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

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

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

10.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 — размеры изображения.

10.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-файл не загрузится.

Скрыть

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

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

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

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

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

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

В нужном кадре 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. clipMovieClip во Flash-ролике, в который будут загружаться баннеры. Он должен быть заранее создан.

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

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

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

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

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

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

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

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

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

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

#include "overtrack.as"

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

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

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

13. Пиксель-аудит в Flash-баннерах

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

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

13.1. Использование AdRiver для независимого аудита показов баннера в сторонней системе

В первом кадре 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)));
}

Если размещением баннеров занимаются менеджеры AdRiver, то перешлите им ваш баннер. Если размещением баннера занимаетесь вы сами, то:

  1. Получите код audit или counter. Пример полного кода:
    <script language="javascript" type="text/javascript"><!--
    var RndNum4NoCash = Math.round(Math.random() * 1000000000);
    var ar_Tail='unknown'; if (document.referrer) ar_Tail = escape(document.referrer);
    document.write('<img src="http://ad.adriver.ru/cgi-bin/rle.cgi?' + 'sid=1&ad=159407&bt=21&pid=539398&bid=1019129&bn=1019129&rnd=' + RndNum4NoCash + '&tail256=' + ar_Tail + '" border=0 width=1 height=1>')
    //--></script>
    <noscript><img src="http://ad.adriver.ru/cgi-bin/rle.cgi?sid=1&ad=159407&bt=21&pid=539398&bid=1019129&bn=1019129&rnd=1999914475" border=0 width=1 height=1></noscript>
    
  2. Модифицируйте полученный код, оставив часть кода, выделенную красным. Пример:
    http://ad.adriver.ru/cgi-bin/rle.cgi?sid=1&ad=159407&bt=21&pid=539398&bid=1019129&bn=1019129&rnd=
  3. Замените слово «pixel» на модифицированный код.

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

    if (ar_init == undefined)
    {
    var ar_init = 1;
    loadMovieNum("http://ad.adriver.ru/cgi-bin/rle.cgi?sid=1&ad=159407&bt=21&pid=539398&bid=1019129&bn=1019129&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=159407&bt=21&pid=539398&bid=1019129&bn=1019129&rnd=" + Math.round(Math.random() * 1000000)));
    }
    

13.2. Использование сторонних систем для аудита показов в AdRiver

Для обычного Flash-баннера

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

  • В поле Сторонний зеропиксель для Flash-клипа укажите код сторонней системы для подсчёта показов Flash-баннера.
  • В поле Сторонний зеропиксель для картинки укажите код сторонней системы для подсчёта показов заглушки.
  • В поле Альтернативный клик на заглушку укажите код сторонней системы для подсчёта кликов по заглушке.
  • Для учёта кликов при добавлении баннера нужного типа вместо прямой ссылки на сайт рекламодателя указывайте код для клика сторонней системы.

Примечание: Если у вас есть только один код сторонней системы для подсчёта показов, то впишите его и в поле Сторонний зеропиксель для Flash-клипа, и в поле Сторонний зеропиксель для картинки.

Примечание: Если у вас есть только один код сторонней системы для подсчёта кликов, то впишите его вместо прямой ссылки на сайт рекламодателя. Поле Альтернативный клик на заглушку оставьте пустым.

Важно: Ссылки на показ и на клик должны обязательно начинаться с «http[s]://».

Примечание: Для предотвращения кеширования добавляйте к вызову стороннего пикселя и коду для клика случайное число — параметр &parameterName=![rnd].

Код для показа сторонней системы управления рекламой имеет вид:

пример 1: http://m2k.ru/cgi-bin/t2-requester?account=761&network=1&format=468|60

пример 2: http://body.imho.ru/image.ng/impt=imp&place=e_pixel&id=03090840&transactionID= 

пример 3: http://engine.awaps.net/0/8002/001001.gif?0-0--0-la:68020p:36732&send_pixel=1

пример 4: http://s0b.bluestreak.com/ix.e?ir&s=7998584&n=Insert_Time_Date_Stamp_Here

После добавления случайного числа код будет выглядеть следующим образом (изменения выделены красным):

пример 1: http://m2k.ru/cgi-bin/t2-requester?account=761&network=1&format=468|60&parameterName=![rnd]

пример 2: http://body.imho.ru/image.ng/impt=imp&place=e_pixel&id=03090840&transactionID=![rnd]

пример 3: http://engine.awaps.net/0/8002/001001.gif?0-0-![rnd]-0-la:68020p:36732&send_pixel=1

пример 4: http://s0b.bluestreak.com/ix.e?ir&s=7998584&n=![rnd]

Баннер должен соответствовать требованиям к Flash-баннерам в системе AdRiver.

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

Примечание: После изменения оригинальных ссылок, а также перед тем, как прописать их в баннер, проверьте как они отработают в браузере. Если браузер выдаёт какие-либо сообщения об ошибках или по кликовой ссылке не происходит переход на нужный сайт, сообщите об этом в службу технической поддержки по адресу support@adriver.ru.

Для баннеров Pop-Under/Rich-media/Flash Poster/TopLine/ScreenGlide

При использовании пиксель-аудита в первом кадре 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» на код для подсчёта показов в вашей системе.

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

Баннер должен соответствовать требованиям к Flash-баннерам в системе AdRiver.

Скрыть

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

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

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

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

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

  • скачайте файл 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).

14.2. Использование событий в баннерах с 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);
Скрыть

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

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

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

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

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

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

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

Где

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

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

15.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)));
    }
    
  • Ссылку для клика впишите в соответствующее поле в сторонней системе.

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

15.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=[случайное число]
    
  • Клики можно учитывать, добавив кликовый баннер.
  • Ссылки для показа и клика пропишите в загрузчике в соответствии с требованиями сторонней системы.

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

Скрыть

16. Таймер обратного отсчёта для баннеров 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(); 

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

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

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

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

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

on (release) {
    richClose();
}
Скрыть

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

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

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

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

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

19. Использование событий в баннерах с 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);
Скрыть

20. Размещение Flash-баннеров на Flash-сайте

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

  • возможность размещать на странице сайта несколько баннеров;
  • минимальная адаптация баннеров (к баннерам, которые размещаются на Flash-сайте, не предъявляется специальных требований);
  • обеспечение защиты Flash-сайта от вредоносных баннеров (т.е. Flash-сайт не открывает баннеру доступ к своим свойствам и методам).
Читать дальше

См. также: XML-баннер.

20.1. Подготовка загрузчика

  • используйте седьмую версию Flash и старше;
  • используйте класс adriverBanner.as;
  • определите кадр, в который будет загружаться баннер. Для этого пропишите в нужном кадре ролика следующий скрипт:
    banner1 = createEmptyMovieClip("banner1",getNextHighestDepth());
    
  • создайте экземпляр класса adriverBanner. Для этого пропишите в нужном кадре ролика следующий скрипт:
    b1 = new adriverBanner(banner1, {sid:1, bt:46, sz: "main", pz:0, bn:1});
    

Параметры:

  • banner1 — кадр, в который будет загружен баннер;
  • {sid:1, bt:46, sz: «main», pz:0, bn:1} — объект, содержащий идентификаторы баннерного места.

Примечание. Интеграция баннерного места во flash-сайт каждый раз может иметь свои особенности.

Экземпляр класса загружает баннер и инициализирует все необходимые переменные для корректной обработки клика. Event Object события содержит ссылку на экземпляр adriverBanner в свойстве target.

Класс adriverBanner умеет передавать события. Их можно использовать для того, чтобы отслеживать процесс загрузки баннера (пример 1) или момент завершения загрузки баннера (пример 2).

Пример 1:

var p = {
onLoadProgress : function (mc, l, t){
trace ("loaded " + l + " of " + t);
}
}

b1.loader.addListener(p);

Пример 2:

var l = {
onLoadComplete: function (e){
trace ("loading banner " + e.target.mc + "done");
}
}

b1.addEventListener("onLoadComplete", l);

Через свойство loader доступен экземпляр класса movieClipLoader, который используется для загрузки баннера.

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

b1.reload();

20.2. Получение идентификаторов баннерного места

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

  • Добавьте в систему AdRiver баннер типа redirect-flash.
  • Разделите сайт на зоны. Так как по URL определить зону сайта в данном случае невозможно, то при разделении сайта на зоны используйте алиасы, а не шаблоны URL.
  • Получите код для баннера по вашей зоне сайта (в примере используется параметр sz: «main»).
  • Из сгенерированного кода получите значения sid, bt, pz, bn.

20.3. Подготовка Flash-баннера

При создании Flash-ролика (баннера) в первом кадре ролика пропишите следующий скрипт:

if(ar_init == undefined){
 ar_init = true;
 System.security.allowDomain('*');
}

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

При этом в загрузчике не нужно специально разрешать доступ для загружаемых роликов.

Элемент button должен располагаться в самом верхнем прозрачном слое Flash-ролика. Для элемента button пропишите следующий скрипт:

button1.onRelease = function (){
    getURL(_root.link1, "_blank");
}

Использование _root обязательно, так как загрузчик на flash-сайте устанавливает _lockroot у того кадра, в который загружается баннер. Загрузчик также инициализирует переменные link1 и ar_bid.

Flash-баннер, который вы добавляете в систему AdRiver обязательно должен иметь имя 0.swf.

Такой способ может использоваться как для сайтов, так и для разовых размещений (в этом случае в идентификаторы баннерного места добавляются параметры pid, bid, ad)

20.4. Настройка рекламной кампании в AdRiver

Добавьте сайт на ваш аккаунт в системе AdRiver.

Выделите зону сайта (в примере название зоны сайта main, алиас main).

Зона сайта имеет перечисленные ниже атрибуты.

  • Имя.
  • Алиас.
  • Список шаблонов адресов.

Имя зоны сайта может быть любым, оно для вашего личного использования. Алиас — это тоже имя зоны сайта для системы. Алиас используется для идентификации зоны сайта при вызове кода тогда, когда нет возможности определить раздел сайта по рефереру.

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

В рекламную кампанию добавьте сценарий и, при необходимости, настройте таргетинг.

В сценарий добавьте баннер типа redirect flash. Загрузите файл, содержащий flash-ролик (он обязательно должен иметь имя 0.swf). Если не заданы ограничения по количеству показов баннера в сутки, то распределение в течение дня должно быть с максимальной скоростью.

Статистику по показам и кликам вы можете посмотреть в интерфейсе AdRiver.

Скрыть