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

CatFish

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

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

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

Подготовьте два варианта Flash-баннера: Flash-ролик (.swf) и заглушку .gif или .jpeg, чтобы демонстрировать её тем посетителям сайта, у которых нет необходимой версии Flash-плагина.

2.1. Баннеры на ActionScript 2

 

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

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

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

Например, для .swf файлов:

 _root.ar_comppath + 'flash_name.swf'

2.2. Баннеры на ActionScript 3

 

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

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

2.3. HTML-баннеры

Для подготовки HTML-файла следуйте данной инструкции.

3. Подготовка скрипта

3.1. Скрипт для обычного CatFish

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

var ar_img_name  = '1.jpg',
    ar_html      = '1.html',
    ar_swf       = '',
    ar_width     = '100%',
    ar_height    = '200',
    ar_alt_link  = '',
    ar_zeropixel = '',
    ar_flash_ver = 8,
    ar_wmode     = 'opaque';

Переменные:

ar_img_name
имя заглушки (gif или jpg). Впишите ваше имя файла. Если заглушка загружается со стороннего сервера, впишите полный адрес, начинающийся с «http://» или «https://». В последнем случае, загружать файл через интерфейс системы не нужно
ar_html
имя html-файла. Впишите ваше имя файла. Если html-файл должен загружаться со стороннего сервера, впишите полный адрес, начинающийся с «http://» или «https://». В последнем случае, загружать файл через интерфейс системы не нужно
ar_swf
имя flash-ролика. Впишите ваше имя файла. Если flash-ролик должен загружаться со стороннего сервера, впишите полный адрес, начинающийся с «http://» или «https://». В последнем случае, загружать файл через интерфейс системы не нужно
ar_width
ширина баннера
ar_height
высота баннера
ar_alt_link
альтернативный клик по заглушке. Если не нужен, оставьте пустым
ar_zeropix
вызов стороннего счётчика. Если не нужен, оставьте пустым
ar_flash_ver
версия flash-плагина (для баннеров с flash-креативами). Выберите минимальную версию flash-плагина, которая необходима посетителю для просмотра вашего баннера
ar_wmode
прозрачность, wmode (для баннеров с flash-креативами). Можно указать одно из значений:
transparent
прозрачный — делает прозрачными области flash-ролика, не заполненные графикой, сквозь прозрачный фон видны другие элементы страницы
opaque
непрозрачный — все области flash-ролика становятся непрозрачными (значение по умолчанию), flash-ролик перекрывает другие элементы страницы
window
в своём окне — flash-ролик отображается в самом верхнем слое (в собственном окне), независимо от прочего контента на странице

Сохраните файл script.js. Баннер готов к загрузке.

Если в баннере необходимо реализовать кнопку Закрыть, в Flash-ролике создайте кнопку, при клике по которой баннер будет закрываться. Для этой кнопки пропишите следующий код:

on(release)
{
    flash.external.ExternalInterface.call("adriver('" + _root.ar_ph + "').hide");
}

Если вы готовите HTML-файл баннера, то на элемент, при клике по которому баннер будет закрыться, следует вызвать функцию parent.postMessage('hideSG', '*');.

Отследить событие click в HTML можно любым удобным для разработчика способом, например так:

var close = document.getElementById('close');
close.addEventListener("click", function( event ) 
{
  console.log('click close');
  parent.postMessage('hideSG', '*');
  event.stopPropagation()
}
);

3.2. Скрипт для CatFish, раскрывающегося по наведению курсора

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

var ar_img_name     = '1.jpg',
    ar_html_small   = 'Small.html',
    ar_swf_small    = '',
    ar_width_small  = '100%',
    ar_height_small = '125',
    ar_html_big     = 'Big.html',
    ar_swf_big      = '',
    ar_width_big    = '100%',
    ar_height_big   = '200',
    ar_valign       = '0',
    ar_align        = '3',
    ar_flash_ver    = '8',
    ar_alt_link     = '',
    ar_zeropixel    = '',
    ar_wmode        = 'opaque';

Переменные:

ar_img_name
имя заглушки (gif или jpg). Впишите ваше имя файла. Если заглушка загружается со стороннего сервера, впишите полный адрес, начинающийся с «http://» или «https://»
ar_html_small
имя маленького html-креатива. Впишите ваше имя файла. Если файл загружается со стороннего сервера, впишите полный адрес, начинающийся с «http://» или «https://»
ar_swf_small
имя маленького flash-ролика (swf). Впишите ваше имя файла. Если файл загружается со стороннего сервера, впишите полный адрес, начинающийся с «http://» или «https://»
ar_width_small
ширина маленького баннера
ar_height_small
высота маленького баннера
ar_html_big
имя большого html-креатива. Впишите ваше имя файла. Если файл загружается со стороннего сервера, впишите полный адрес, начинающийся с «http://» или «https://»
ar_swf_big
имя большого flash-ролика (swf). Впишите ваше имя файла. Если файл загружается со стороннего сервера, впишите полный адрес, начинающийся с «http://» или «https://»
ar_width_big
ширина большого баннера
ar_height_big
высота большого баннера
ar_valign
разворот по вертикали. Впишите 0, если баннер должен разворачиваться вверх; 1, если баннер должен разворачиваться вниз; 3, если баннер должен разворачиваться к центру
ar_align
разворот по горизонтали. Впишите 0, если баннер должен разворачиваться влево; 1, если баннер должен разворачиваться вправо; 3, если баннер должен разворачиваться к центру.
ar_flashver
версия flash-плагина (для баннеров с flash-креативами). Укажите минимальную версию flash-плагина, которая необходима посетителю для просмотра вашего баннера
ar_alt_link
альтернативный клик по заглушке. Если не нужен, оставьте пустым
ar_zeropixel
вызов стороннего счётчика для баннера. Если не нужен, оставьте пустым
ar_wmode
прозрачность (wmode) (для баннеров с flash-креативами). Можно указать одно из значений:
transparent
прозрачный — делает прозрачными области flash-ролика, не заполненные графикой, сквозь прозрачный фон видны другие элементы страницы
opaque
непрозрачный — все области flash-ролика становятся непрозрачными (значение по умолчанию), flash-ролик перекрывает другие элементы страницы
window
в своём окне — flash-ролик отображается в самом верхнем слое (в собственном окне), независимо от прочего контента на странице

Сохраните файл script.js. Баннер готов к загрузке.

Если в баннере необходимо реализовать кнопку Закрыть, в Flash-ролике создайте кнопку, при клике по которой баннер будет закрываться. Для этой кнопки пропишите следующий код:

on(release)
{
    flash.external.ExternalInterface.call("adriver('" + _root.ar_ph + "').hide");
}

Если вы готовите HTML-файл баннера, то на элемент, при клике по которому баннер будет закрыться, следует вызвать функцию parent.postMessage('hideSG', '*');.

Отследить событие click в HTML можно любым удобным для разработчика способом, например так:

var close = document.getElementById('close');
close.addEventListener("click", function( event ) 
{
  console.log('click close');
  parent.postMessage('hideSG', '*');
  event.stopPropagation()
}
);

4. Загрузка баннера

  1. Подготовьте баннер согласно п. 2 и п. 3 инструкции.
  2. Добавьте баннер special--->AjaxJS--->Generic-AjaxJS
  3. Укажите ссылку на сайт рекламодателя в поле Линк Баннера. При необходимости, укажите другие параметры.
  4. Нажмите на кнопку Добавить баннер. Вы попадете на страницу редактирования параметров баннера.
  5. Включите баннер (галочка Вкл.), укажите распределение в течение дня, задайте необходимые ограничения по количеству показов/кликов. При необходимости, настройте другие параметры. Для сохранения введенных настроек нажмите на кнопку Сохранить.
  6. Кликните по ссылке Загрузить баннер.
  7. Выберите с помощью кнопки Обзор все файлы баннера, не забудьте загрузить заглушку и файл script.js. В качестве креативов баннера загружаются либо flash-креативы (большой и маленький), либо html-креативы (большой и маленький).
  8. Нажмите на кнопку Загрузить.

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

 

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

Последнее обновление: 11.10.2016