• Справочное руководство
• Выбор баннера и технические требования
• Технические требования

Технические требования

TopLine

1. Карточка баннера

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

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

2.1. Flash-ролик для TopLine на всех кодах

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

if(ar_init == undefined){
 ar_init = true;
 System.security.allowDomain(_parent._url);
}

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

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

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

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

Обязательно используйте переменную link1 для подсчёта кликов.

Для того, чтобы открывать ссылку баннера в том же окне, укажите во flash-ролике _top.

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

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

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

Если вы хотите подгружать в flash-ролик дополнительные части, загруженные в баннер, то надо дописать к перeменной _root.ar_comppath имя подгружаемого компонента.

Например:

 _root.ar_comppath + 'flash_name.swf'

2.2. Скрипт для TopLine на коде poster

Распакуйте пример. Откройте текстовым редактором файл script.js. Внесите изменения только в верхнюю часть скрипта, отмеченную как editable block.

/* Last edited by Alexandr Zonov 10.03.2011 */

var ar_img		= 'mts121_760x60v1.gif',
	ar_swf		= 'mts121_760x60v1.swf',
	ar_flashver	= 6,
	ar_width		= '100%',
	ar_height		= '60',
	ar_img_click	= '',
	ar_wmode		= 'opaque',
	ar_flash_pixel	= '',
	ar_gif_pixel	= '',
	ar_quality		= 'best';

Переменные:

• ar_img — имя заглушки (gif). Может быть загружена со стороннего сервера. Заглушка показывается, если у посетителя отсутствует необходимый flash-плагин. Если вы не указали никакой заглушки, а flash-плагина у посетителя нет, посетитель ничего не увидит. Показ при этом все равно посчитается. Высота заглушки равна высоте flash-ролика. Ширина заглушки не указывается, браузер определяет её сам, место справа и слева заполняется определённым цветом.
• ar_swf — это имя flash-ролика. Впишите ваше имя файла. Если flash-ролик должен загружаться со стороннего сервера, то впишите полный адрес, начинающийся с «http://». В последнем случае, загружать его не придётся.
• ar_flashver — flash-плагин, который необходим постетилю для просмотра вашего flash-ролика. Проверяйте соответствие flash-плагина и ролика.
• ar_width, ar_height — ширина и высота flash-ролика. Ширина по умолчанию указана 100% (изменять не рекомендуется). Высоту в пикселях вы задаёте сами.
• ar_img_click — альтернативный клик по заглушке, если требуется. Обязательно должен начинаться с http://.
• ar_wmode — прозрачность (wmode). Можно указать одно из значений:
  • transparent (прозрачный) — делает прозрачными области flash-ролика, не заполненные графикой, сквозь прозрачный фон видны другие элементы страницы.
  • opaque (непрозрачный) — все области flash-ролика становятся непрозрачными (значение по умолчанию), flash-ролик перекрывает другие элементы страницы.
  • window (в своём окне) — flash-ролик отображается в самом верхнем слое (в собственном окне), независимо от прочего контента на странице.
• ar_flash_pixel — вызов стороннего счётчика для flash-ролика. Если не нужен, оставьте пустым.
• ar_gif_pixel — вызов стороннего счётчика для заглушки. Если не нужен, оставьте пустым.
• ar_quality — качество отображения flash-клипа (quality). Можно указать одно из значений:
  • low — проигрыватель показывает flash-ролик с наибольшей скоростью. Анти-алиасинг и сглаживание текстур не используются;
  • autolow — с первых кадров проигрыватель показывает ролик с наибольшей скоростью. Далее, если позволяют ресурсы процессора, качество воспроизведения улучшится (включится анти-алиасинг);
  • autohigh — при проигрывании ролика отдаётся большее предпочтение скорости воспроизведения, нежели качеству изображения. Первоначально включённый анти-алиасинг отключится, если частота пропуска кадров будет больше допустимого порога;
  • medium — при воспроизведении будет частично использован анти-алиасинг. Сглаживание текстур не используется. Качество воспроизведения при этой установке лучше чем при low, но хуже чем при high;
  • high — проигрыватель всегда использует анти-алиасинг, улучшая качество изображения. Сглаживание текстур используется только в кадрах без анимации;
  • best — проигрыватель покажет flash-ролик в самом лучшем качестве, не принимая в расчёт скорость воспроизведения. При проигрывании ролика всегда используется анти-алиасинг и сглаживание текстур (значение по умолчанию).

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

TopLine на коде extension может быть двух видов:

• TopLine с растягивающимся flash-роликом. Flash-ролик позиционно занимает всю ширину окна браузера или дизайна сайта. И при изменении размеров окна растягивается или сжимается.
• TopLine с отдельными элементами:
  • средняя часть баннера — flash-ролик определённого размера;
  • правая и/или левая растягивающиеся части для flash-ролика (.swf);

  Размеры растягивающихся частей:

  • если однотонные, то высота и ширина — 1x1 px;
  • если используется градиент или цвета меняются по высоте, то ширина — 1px, высота равна высоте баннера.

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

• в поле ширина укажите значение, равное 100%;
• в поле высота укажите высоту вашего flash-ролика.

3. Загрузка flash-баннера на коде ajax

1. Подготовьте баннер согласно п. 2.1 инструкции.
2. Добавьте баннер special--->special--->Flash-AjaxJS.
3. Кликните по ссылке Загрузить баннер.
4. Загрузите flash-ролик и заглушку. Для баннера TopLine укажите ширину — 100%.
5. Укажите друге необходимые параметры.
6. Нажмите на кнопку Загрузить.

4. Как обеспечить учёт через стороннюю систему

4.1. Обеспечить демонстрацию баннера через Location сторонней системы

Компоненты баннера располагаются в сторонней системе и flash-ролик сделан по специальным требованиям для передачи сторонней системе. В этом случае баннер TopLine загружается как Generic-Extension, или GenericPoster.

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

• ссылку на показ для flash-ролика впишите как значение переменной ar_swf;
• ссылку на клик по flash-ролику впишите в поле Линк Баннера при добавлении баннера;
• ссылку на показ для заглушки впишите как значение переменной ar_gif;
• ссылку на клик по заглушке впишите как значение переменной ar_img_click.

4.2. Обеспечить аудит пиксель-аудитом сторонней системы

Компоненты баннера располагаются в системе AdRiver. В этом случае баннер TopLine загружается как стандартный на коде extension.

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

• впишите ссылку сторонней системы на клик по flash-ролику в поле Линк Баннера;
• впишите ссылку сторонней системы на клик по заглушке в поле Альтернативный клик на заглушку. Если не нужен, оставьте пустым;
• впишите ссылку сторонней системы на показ пикселя в поле Вызов стороннего счётчика.

Сторонняя система должна обеспечить корректный переход на сайт рекламодателя.

4.3. Загрузка кода сторонней системы со специальным скриптом

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

Компоненты баннера располагаются в сторонней системе. Сторонняя система предоставляет код баннера.

• Распакуйте пример. Откройте текстовым редактором файл script.js. Внесите изменения только в верхнюю часть скрипта, отмеченную как editable block.

  //Last edited 19.07.2009 by Alexandr Zonov
  var ar_width = '100%';
  var ar_height = '60';
  

  Переменные:

  • ar_width — ширина баннера. Рекомендуем оставить значение по умолчанию — 100%;
  • ar_height — высота баннера. Впишите ваш размер.
• Создайте файл следующего содержания и назовите его index.html:

  <html>
  <body topmargin="0" leftmargin="0" marginwidth="0" marginheight="0">
  
  <!-- Сюда поместите присланный вам код -->
  
  </body>
  </html>

• Добавьте в AdRiver баннер Generic-Extension, или GenericPoster и загрузите файлы index.html и script.js.

5. Полезные ссылки

• Типы кодов в AdRiver.
• Expandable.
• ExpandableMove