Рекламная сеть «Soloway»
Совокупность интернет‑ресурсов (сайтов) и программ, включая мобильные приложения, предоставляющих Исполнителю по Договору рекламные места на основании заключённых договоров.
Сайты Soloway
Совокупность интернет‑ресурсов (сайтов) и программ, включая мобильные приложения, с владельцами которых у Исполнителя по Договору заключены договоры на предоставление рекламных мест с использованием технологической платформы Soloway.
Рекламно‑информационный модуль (РИМ)
Рекламный креатив в виде статического, анимированного, видео‑ или текстово‑графического блока прямоугольной, квадратной или иной формы, размещаемый на рекламных местах и содержащий одну или несколько ссылок (код перехода) на сайт Заказчика по Договору или его клиента.
Рекламное место
Область на веб‑странице сайта рекламной сети или сайте Soloway, выделенная в дизайне для показа РИМ, предоставленная Исполнителю по Договору владельцем сайта и используемая для показа РИМ Заказчика по Договору с помощью технических средств Заказчика при взаимодействии с Soloway SSP.
Код вызова РИМ / Код Оператора «Soloway»
Программный код (скрипт/тег), встраиваемый в HTML‑код веб‑страницы сайта рекламной сети или сайта Soloway и предназначенный для запроса и отображения РИМ через Soloway SSP.
Пользователь
Любое лицо, посещающее интернет‑ресурсы, в том числе сайты рекламной сети или сайты Soloway, на которых осуществляется показ РИМ.
Soloway SSP
Совокупность программ, размещённых на программно‑аппаратной платформе Исполнителя по Договору и предназначенная для:
- автоматического отбора и показа РИМ на рекламных местах в режиме реального времени, в том числе с использованием аукционов
- учёта объёма и стоимости оказанных Заказчику по Договору услуг
- обработки данных для таргетинга и оптимизации размещений в рамках применимого законодательства
Данные статистики
Электронные записи систем Soloway, содержащие сведения о показах, кликах и иных событиях, связанных с показом РИМ на рекламных местах, а также о стоимости услуг по Договору и других параметрах оказания услуг.
Данные доступны Заказчику в личном кабинете после авторизации под логином и паролем, предоставленными Исполнителем. Срок хранения и периодичность обновления статистики устанавливаются Исполнителем и могут быть изменены в одностороннем порядке с уведомлением Заказчика через интерфейс личного кабинета или иным согласованным способом.
OpenRTB
Программный интерфейс (API) взаимодействия приложений Заказчика по Договору с Soloway SSP, реализующий протокол OpenRTB. OpenRTB позволяет Заказчику участвовать в электронных торгах (real‑time bidding, RTB) и получать запросы на показ рекламы с последующей передачей ставок и креативов.
Использование OpenRTB
Любое использование программно‑аппаратного комплекса Заказчика для обмена данными по спецификации OpenRTB, включая, но не ограничиваясь:
- использование OpenRTB для взаимодействия с Soloway SSP
- использование технической спецификации OpenRTB и любых описанных в ней сервисов или типов данных
- разработку, использование и/или распространение приложений, взаимодействующих с Soloway SSP по протоколу OpenRTB
Техническая спецификация OpenRTB
Документ, содержащий технические требования и формат обмена данными для взаимодействия приложений с Soloway SSP по протоколу OpenRTB.
DSP Заказчика
Платформа demand‑side platform (DSP), используемая Заказчиком по Договору, и размещённая в сети Интернет, которая позволяет:
- задавать условия закупки рекламных показов (таргетинг, частота, бюджеты и т.п.)
- в автоматическом режиме участвовать в электронных торгах и размещать РИМ на рекламных местах через Soloway SSP или по протоколу OpenRTB
Электронные торги
Торги в режиме реального времени (RTB), проводимые между ставками на показ РИМ, предложенными DSP Заказчика по Договору и другими DSP, претендующими на показ своих РИМ или РИМ своих клиентов на конкретном рекламном месте.
Аукцион первой цены
Тип закрытого аукциона, при котором победителем признаётся DSP, предложившая наивысшую цену (без НДС) за показ РИМ на рекламном месте. Цена показа РИМ (без НДС) для победителя равна его ставке. Валюта аукциона — российский рубль (RUB).
Аукцион второй цены
Тип закрытого аукциона, при котором победителем признаётся DSP, предложившая наивысшую цену (без НДС) за показ РИМ на рекламном месте. Цена показа РИМ (без НДС) для победителя равна второму по величине предложению других участников аукциона («вторая цена») с учётом минимального шага торгов либо минимальной цены показа, установленной владельцем рекламного места и переданной в Soloway SSP. Валюта аукциона — российский рубль (RUB).
Метка трафика (deal id)
Буквенно‑цифровой идентификатор (deal ID), определяемый владельцем сайта рекламной сети или сайта Soloway и указываемый DSP Заказчика в ответе на запрос Soloway SSP. Метка используется Soloway SSP для идентификации условий частной сделки (private deal, preferred deal, programmatic guaranteed и др.) и даёт право соответствующей DSP размещать РИМ по согласованной фиксированной или приоритетной цене, в том числе без участия в открытых электронных торгах.
Процесс интеграции DSP-платформы с продуктом Soloway SSP описан в разделе «Подключение DSP».
Так же рекомендуем ознакомиться с форматами рекламных материалов участников RTB-торгов и требованиями, предъявляемыми к ним.
1. Параметры платформы Soloway SSP
1.1. Общие параметры платформы
| Параметр | Значение | Описание |
| Протокол | OpenRTB v2.0 | Спецификация протокола |
| Валюта аукциона | RUB | Российский рубль |
| Модель ставок | CPM (Cost-per-thousand impressions) |
Значение ставки за лот переводится в значение стоимости за тысячу показов рекламного блока |
| Тип аукциона | Аукцион второй цены |
Аукцион выигрывает DSP с максимальную ставкой. При этом покупка осуществляется по второй максимальной ставке (используется алгоритм «аукциона второй цены») плюс 1/100 единицы валюты аукциона. Например, на лот поступило три ставки: 10, 15 и 20 рублей. Выигрывает лот участник, сделавший ставку в 20 рублей, но покупка лота при этом происходит по стоимости 15,01 рубля. В случае, если ставки совпали — победитель выбирается случайно среди участников с одинаковыми ставками |
| Время отклика | 100 мс | Время отклика DSP-платформы не должно превышать 100 миллисекунд |
| Объект показа | banner | Баннер |
| Метод передачи рекламного блока | Через атрибуты adm или nurl |
Тело рекламного блока передаётся в атрибуте adm объекта bid. Если атрибута adm не задан — рекламный блок ожидается при вызове ссылки из атрибута nurl объекта bid. Поддерживается использование атрибута nurl для оповещения о победе в аукционе. В случае отказа от участия в аукционе, DSP-платформа должна ответить кодом 204 |
1.2. Макросы, поддерживаемые Soloway SSP
| Параметр | Пример | Описание |
| ${AUCTION_PRICE} |
https://mydsp.ru/ ?winnotice=1 &aid=![reqid] &aprice=${AUCTION_PRICE} |
Выигрышная цена |
|
//![rhost]/ cgi-bin/eclick.cgi ?xpid=![xpid] |
«nurl»: «https://dsp.domain.ru/ winnoticeurl &click=//![rhost]/ cgi-bin/eclick.cgi ?xpid=![xpid]» |
Отслеживании кликов в случае, когда DSP осуществляет перенаправление пользователя на целевой рекламный материал (ссылка для перехода) самостоятельно: Soloway SSP информирует DSP-платформу о победе в аукционе. В посылаемом bid-запросе значение атрибута nurl содержит переменную click (имя переменной может отличаться), значение которой содержит макрос оповещения. DSP вызывает макрос из переменной, тем самым оповещая систему AdRiver о клике |
|
//![rhost]/ cgi-bin/click.cgi ?xpid=![xpid] ?rleurl=url |
«nurl»: «http://dsp.domain.ru/ winnoticeurl &click=//![rhost]/ cgi-bin/click.cgi ?xpid=![xpid] ?rleurl=https://mydsp.ru» |
Отслеживании кликов в случае, когда перенаправление на целевой рекламный материал осуществляет Soloway SSP: При получении оповещения о победе в аукционе DSP вызывает макрос из переменной click с дополнительным параметром rleurl, содержащим ссылку для перехода. AdRiver осуществляет перенаправление посетителя по указанному в параметре rleurl адресу при вызове макроса |
| ![reqid] | «id»: «12345» | Уникальный идентификатор запроса |
| ![pos] | «pos»: 1 |
Положение рекламного блока на странице: 0 — неизвестно 1 — верх 2 — середина (в зависимости от разрешения экрана может быть виден или скрыт от посетителя) 3 – низ (скрыт от посетителя) |
| ![dsp_id] |
https://ssp.adriver.ru/ cgi-bin/sync.cgi ?dsp_id= YOUR_ID &external_id=USER_ID |
Идентификатор вашей DSP-платформы, назначенный Soloway SSP. Необходим для синхронизации кук |
2. Синхронизация кук
База синхронизации кук всегда находится на стороне Soloway SSP. В случае наличия идентификатора и у SSP, и у DSP — оба параметра передаются в bid-запросе от Soloway SSP. В случае отсутствия идентификатора у DSP — передаётся только идентификатор SSP.
Поддерживается как инициированная DSP, так и инициированная SSP синхронизация.
2.1. Синхронизация кук, инициированная DSP
Синхронизация кук осуществляется через следующий запрос:
http://ssp.adriver.ru/cgi-bin/sync.cgi?dsp_id=YOUR_ID&external_id=USER_ID
где:
- dsp_id=YOUR_ID — Идентификатор вашей DSP-платформы, назначенный Soloway SSP
-
external_id=USER_ID — DSP-кука
Кука может содержать только буквенно-цифровые символы. В случае наличия в куке символов отличных от букв и цифр, external_id должен быть закодирован при помощи escape-последовательности
Пример кода синхронизации:
<img width="0" height="0" src="http://ssp.adriver.ru/cgi-bin/sync.cgi?dsp_id=999&external_id=332244"/>
От ssp.adriver.ru будет получен ответ HTTP 204.
2.2. Синхронизация кук, инициированная Soloway SSP
Soloway SSP инициирует процесс синхронизации кук для каждого нового пользователя системы.
Синхронизация происходит следующим образом:
- Soloway SSP запрашивает от DSP ссылку синхронизации
- В полученной ссылке заменяет значение переменной ![cuid] на макрос
- Посылает запрос к DSP с подставленным значением
- Ожидает 302 ответа
- Осуществляет редирект на сервис синхронизации Soloway SSP
3. Параметры bid-запроса
3.1. Bid-запрос
| Атрибут | Тип | Описание |
| id | string | Уникальный идентификатор bid-запроса |
| imp | array of objects | Массив баннеров. В одном bid-запросе может быть указано несколько объектов. Наличие по крайней мере одного баннера — обязательно. |
| device | object | Описание устройства отображения баннера (например, мобильные устройства, десктоп и другие) и параметры отображения (например, поддержка flash) |
| user | object | Описание пользователя. Может включать уникальные идентификаторы пользователей |
| site | object | Объект сайта или мобильного приложения. Может содержать только одно из двух значений |
| bcat | array of strings | Заблокированные рекламные категории* |
| cur | array of strings | Валюта аукциона |
3.2. Impression
| Атрибут | Тип | Описание |
| id | string | Уникальный идентификатор показа в контексте bid-запроса |
| banner | object | Ссылка на объект баннера |
| bidfloor | float | Минимальная стоимость показа в CPM* |
| bidfloorcur | string | Валюта минимальной стоимости показа |
3.3. Banner
| Атрибут | Тип | Описание |
| w | integer | Ширина баннера в пикселях |
| h | integer | Высота баннера в пикселях |
| pos | integer | Позиция на странице |
| battr | array of integer | Типы баннеров, заблокированных пользователем* |
3.4. Site
| Атрибут | Тип | Описание |
| id | string | Идентификатор сайта |
| ref | optional | Ссылка реферера, с которого произошел переход на страницу сайта |
| page | string | Полная ссылка страницы, где произошел показ* |
| cat | array of strings | Массив категорий по стандарту IAB (5 на весь сайт) |
| sectioncat | array of strings | Массив категорий по стандарту IAB (5 на весь сайт) |
3.5. Device
| Атрибут | Тип | Описание |
| ua | string | Строка браузера посетителя |
| ip | string | Язык браузера; стандарт alpha-2/ISO 639-1 |
| geo | object | * |
| language | string | * |
3.6. Geo
| Атрибут | Тип | Описание |
| country | string | Страна, стандарт ISO 3166-1* |
| region | string | Регион, стандарт ISO 3166-2* |
| city | string | MaxMind GeoCity* |
| zip | string | Индекс* |
3.7. User
| Атрибут | Тип | Описание |
| id | >string | >Уникальный идентификатор пользователя |
| buyeruid | string | >* |
Отмеченные звездочкой (*) параметры не строго обязательны и заполняются по возможности
4. Параметры bid-ответа
4.1. Bid-ответ
| Атрибут | Тип | Описание |
| id | string | Идентификатор bid-ответа |
| seatbid | array of objects | Массив seatbid объектов |
4.2. Seatbid
| Атрибут | Тип | Описание |
| bid | array of objects | Идентификатор bid-запроса. Массив bid-объектов, каждый из которых соотносится с impression-объектом (объектом показа) bid-запроса. Каждый impression-объект может содержать несколько bid-объектов |
4.3. Bid
| Атрибут | Тип | Описание |
| id | string | Идентификатор bid-объекта |
| impid | string | Идентификатор impression-объекта, к которому относится bid-объект |
| price | float | Ставка в CPM |
| adid | string | Идентификатор рекламного блока, который будет показан в случае, если аукцион будет выигран |
| adomain | array of strings | Основной домен/домен верхнего уровня для проверки рекламодателя |
| nurl | string | Ссылка оповещения о выигрыше лота |
Ознакомьтесь с форматами рекламных материалов участников торгов и требованиями, предъявляемыми к ним.
1. Форматы рекламных материалов
Размер баннера:
- 240×400
- 336×280
- 160×600
- 728×90
- 300×250
- 970×90
- 200×200
- 300×600
- 320×100
- 320×50
- 580×400
- 320×480
- 970×250
- 600×300
- 300×300
- 240×600
- 400×240
Тип кода:
- Javascript
- IFrame
- HTML5
- VAST
- Редирект
Тип баннера:
- Image (jpeg, png, gif)
- Video (mp4, flv, webm)
Если вы не нашли искомого формата в списке — напишите нам на ящик ssp@soloway.ru об этом. Добавление баннеров нестандартных форматов обсуждается индивидуально.
2. Требования к рекламным материалам
Законодательство
Все рекламные материалы должны соответствовать действующему законодательству РФ, зарегистрированы в ОРД и промаркированы, и не должны содержать контент «для взрослых» и/или рекламу алкоголя
Имитация контента
Баннеры не должны имитировать какое-либо оригинальное содержимое сайта издателя (содержимое потенциального сайта показа рекламного материала)
Имитация элементов браузера/системы
Баннеры также не должны имитировать или быть похожими на системные оповещения, диалоговые окна, сообщения об ошибках как браузера, так и самой операционной системы посетителя рекламной площадки
Переход по ссылке
При переходе посетителя сайта по ссылке баннера, ваш целевой рекламный материал должен отобразиться в новом окне браузера
Идентификация
Рекламные материалы должны быть связаны как с рекламируемым продуктом, так и с рекламодателем, и предполагают соответствующее графическое оформление
Оформление
Изображения, содержащиеся в баннере, должны быть четкими, не подразумевающими двойственности. Текст должен быть разборчив, и не вызывать разночтений. Не допускается использование мерцающих, дергающихся эффектов и резких, едких цветов для дополнительного привлечения внимания, а так же эффектов размытия
Площадь баннера
Рекламный материал должен занимать все размерное пространство баннера и не может быть сдвинут, перевернут, выходить за его пределы. Не допускается разделение баннера на части и содержание в баннере его собственных копий
Рамка
Границы рекламного материала должны быть видны на сайте издателя. Объявления с частично черным, белым или прозрачным фоном, должны содержать рамку контрастного цвета, отличного от цвета фона
Звук
Использование звукового сопровождения возможно, но при загрузке баннера звук должен быть отключен. Баннер должен содержать как опцию включения звука, так и опцию его выключения
Курсор
Имитация движения курсора мыши для привлечения внимания посетителя рекламной площадки возможно, но не должно превышать 5 секунд
3. Технические требования
Время отклика
Время отклика DSP-платформы не должно превышать 100 миллисекунд
Размер файла баннера
Максимальный размер файла баннера — 150 Кб. Дополнительная его часть (до 2.2 Мб) может загружаться по инициативе пользователя (по клику)
При нарушении указанных требований и/или поступлении жалоб от издателей (владельцев сайтов), ваша рекламная кампания, вместе с рекламными материалами, может быть заблокирована, с предшествующим уведомлением.
