Форма интеграции AdRiver SSP и DSP

Система для управления и аудита рекламных кампаний в интернете
Форма интеграции AdRiver SSP и DSP
Пожалуйста, заполните форму ниже и верните ее по адресу dspssp@adriver.ru с пометкой в
заголовке “[НАЗВАНИЕ ВАШЕЙ КОМПАНИИ] - DSP интеграция с AdRriver SSP” или
ответьте в ту же цепочку писем.
Процесс интеграции
При подключении DSP мы сможем обслуживать доставку форматов, таргетированных на Desktop
инвентарь сети Adriver. Вы сможете размещать следующие размеры: 240x400, 728x90, 300x250, 120x600,
160x600, 336x280, 468x60, 250x250, 200x200. (Кастомные решения – по запросу)
Тип тегов: Javascript, IFrame, стандартный редирект, HTML5, VAST.
Типы креативов: Flash, Image (jpeg,png,gif), Rich-Media, Video, , Pixel ( Исследования: Аудитории, Брендузнаваемость, панельные, трекинг и подсчет показов и т.д.) Баннеры должны удовлетворять требованиям
Законодательству Российской Федерации. Во время тестирования необходимо совершить следующие шаги
для подтверждения успешности интеграции:



Заполнить и прислать форму
Подписать контракт
Тестирование:
1) Биддер отключен. Предоставить все варианты кодов для тестирования креативов. Проверка на нашей
стороне рекламных блоков переданных от DSP во всех браузерах и операционных системах
2) Биддер включен. Отправка bid request’ов к DSP для подтверждения корректности заполнения и
наличия всех необходимых полей согласно спецификации


Проверка рекламных блоков переданных от DSP во всех браузерах и операционных системах
Включение на небольшой части траффика и проверка статистики обеими сторонами
Общая информация по работе AdRiver SSP
Протокол
OpenRTB v2.0
Валюта аукциона
RUB
Модель ставок DSP
CPM
DSP посылает ставку в CPM и, в случае победы в аукционе,
получает оповещение о выплате в CPM
Тип аукциона
second price
Мах
интервал
для
подтверждения бида
Тип объекта показа
Метод передачи рекламы в
объекте bid
100мс
banner
adm или nurl
DSP, сделавший максимальную ставку побеждает и платит на
1/100 единицы валюты больше предшествующей ставки. Так
называемая win_price никогда не превышает bid_price. В
случае если ставки совпали, побеждает любая.
Если больше 100мс, система перестаёт ожидать bid response
В будущем будет возможность показа VAST и Mobile Ads?
 Ad served in the Bid, тело блока передаётся в атрибуте adm
объекта bid, если атрибута adm нет, то блок ожидается при
вызове ссылки из атрибута nurl (объект bid).
 Поддерживается атрибут nurl для оповещения о победе в
аукционе. Url полученный в атрибуте nurl вызывается
server-side методом GET.
 В случае отказа от аукциона (no bid) DSP должен ответить
кодом 204.
Система для управления и аудита рекламных кампаний в интернете
Поддерживаемые SSP макросы
Параметр
Описание
Пример
${AUCTION_PRICE}
Выигранная цена (Winning price) для нотификации
http://mydsp.ru/?winnotice=1&ai
d=![reqid]&aprice=${AUCTION
_PRICE}
//![rhost]/cgibin/eclick.cgi?xpid=![x
pid]
Трекинг кликов. После выигрыша аукциона и при
показе креатива DSP осуществляет редирект
пользователя самостоятельно, сообщив об этом
AdRiver при помощи вызова URL из макроса
//![rhost]/cgi-bin/eclick.cgi?xpid=![xpid],
который
SSP заполняет при информировании DSP о победе
(через NURL) в вашем параметре для подсчета кликов,
например click=
Уникальный идентификатор запроса
Местоположение баннера
 0 – неизвестна
 1 – верх
 2 – середина середина (Может быть как на
видимом так и на не видимом экране в
зависимости от разрешения.)
 3 – низ страницы (Вне поля зрения на экране.)
dsp_id=YOUR_ID – id назначенные DSP, необходимо
для синхронизации кук
“nurl”:”http://dsp.domen.ru/winn
oticeurl&click=//![rhost]/cgibin/eclick.cgi?xpid=![xpid] ”,
![reqid]
![pos]
![dsp_id]
“id”: “1234534625254”
“pos”:1,
http://ssp.adriver.ru/cgibin/sync.cgi?
dsp_id=99&external_user_id=33
2234
Синхронизация кук
База синхронизированных кук всегда находится у Adriver SSP. В случае наличия и SSP user id, и DSP user id
оба параметра передаются в bid request’e от AdRiver SSP. В случае отсутствия DSP user id передаётся только
SSP user id.
Поддерживается как инициированная DSP, так и инициированная SSP синхронизация кук.
Вариант 1. Синхронизация кук инициированная DSP
Синхронизация кук происходит через запрос на URL:
http://ssp.adriver.ru/cgi-bin/sync.cgi?dsp_id=YOUR_ID&external_id=USER_ID


dsp_id=YOUR_ID – id назначенное для DSP в AdRiver SSP
external_id=USER_ID – кука DSP. Может содержать только буквенно-цифровые символы. В случае
наличия в куке символов отличных от букв и цифр external_id в запросе должен быть url encoded
(escaped url) Пример кода синхронизации в ответе пользователю DSP
<img width="0" height="0" src=“http://ssp.adriver.ru/cgi-bin/sync.cgi?dsp_id=99&external_id=332234”/>
Сервис ssp.adriver.ru ответит заголовком «204 No Content».
Вариант 2. Синхронизация кук инициированная AdRiver SSP:
AdRiver SSP инициирует куки матчинг для каждого нового юзера, появившегося в системе. DSP
предоставляет свою ссылку. AdRiver SSP заменяет макрос ![cuid], посылает запрос к DSP, ожидает ответа
302 и редиректа на URL синхронизатора AdRiver SSP .
Параметры BID Request и BID Response в AdRiver SSP
Bid request
Параметр
id
Тип
string
Описание
Unique ID of the bid request, provided by the exchange
Система для управления и аудита рекламных кампаний в интернете
imp
array of objects
device
object
user
object
site
bcat
cur
object
array of string
array of string
Array of impression objects. Multiple impression auctions may be specified
in a single bid request. At least one impression is required for a valid bid
request
This object describes the device the ad impression will be delivered to (e.g.,
mobile phone, computer, set top box, etc.) and its capabilities (e.g., flash
support)
This object describes the user, and may include unique identifiers for the
user
Either a site or app object may be included – not both. Neither is required
Blocked Advertiser Categories *
Currency of the auction
Impression
Параметр
id
banner
bidfloor
bidfloorcur
string
object
float
string
Тип
Описание
A unique identifier for this impression within the context of the bid request
A reference to a banner object
Bid floor for this impression in CPM *
Currency of bidfloor attribute
Тип
integer
integer
integer
Array of integer
Описание
Width of the impression in pixels
Height of the impression in pixels
Ad Position
Specifies the types of creatives blocked by publisher*
Параметр
id
ref
Тип
string
optional
page
cat
sectioncat
string
array of string
array of string
Описание
Site ID on the exchange
Referrer URL that caused navigation to the
current page *
Full url of the page where impression to be occur *
Array of IAB content categories for 5 the overall site
Array of IAB content categories for the current subsection of the site.
Banner
Параметр
w
h
pos
battr
Site
Device
Параметр
ua
ip
geo
language
Тип
Описание
Browser user agent string
Browser language; use alpha-2/ISO 639-1 codes.
*
*
Тип
Описание
Country, using ISO 3166-1. (See Appendix)*
Region, using ISO 3166-2.*
MaxMind
GeoCity
name
(External
http://dev.maxmind.com/geoip/le gacy/geolite/)*
Zip/postal codes*
string
string
object
String
Geo
Параметр
country
region
city
string
string
string
zip
string
reference
User
Параметр
id
buyeruid
Тип
string
string
Пример bid request
{
"id": "1234534625254",
"imp": [
{
"id": "5",
"bidfloor": "1.2",
"bidfloorcur": "RUB",
Описание
Unique consumer ID of this user on the exchange
Buyer’s user ID for this user as mapped by exchange for the buyer*
-
Система для управления и аудита рекламных кампаний в интернете
"banner": {
"w": 300,
"h": 250,
"pos": 1
}
}
],
"site": {
"id": "234563",
"page": "siteabcd.com/folder1/folder2/topic.html",
"name": "siteabcd.com"
},
"device": {
"ip": "64.124.253.1",
"ua": "Mozilla/5.0(Macintosh;U;IntelMacOSX10.6;en-US;rv: 1.9.2.16)"
},
"user": {
"id": "65555424-750f-4100-b2d3-f1dba8bea04d-1",
"buyeruid": "45asdf987656789adfad4678rew656789"
},
"cur": [
"RUB"
]
}
Объекты JSON могут находиться в произвольном порядке. Значения полей могут быть пустыми.
Bid Response
Параметр
id
seatbid
Тип
string
array of objects
Описание
ID of the bid request
Array of seatbid objects
Seat bid
Параметр
bid
Тип
array of objects
Описание
ID of the bid request.Array of bid objects; each bid object relates to an imp
object in the bid request. Note that, if supported by an exchange, one imp
object can have many bid objects
Bid
Параметр
Тип
id
string
impid
price
adid
adomain
string
float
string
array of strings
nurl
string
Описание
ID for the bid object chosen by the bidder for tracking and debugging
purposes. Useful when multiple bids are submitted for a single impression
for a given seat
ID of the impression object to which this bid applies
Bid price in CPM
ID that references the ad to be served if the bid wins
Advertiser’s primary or top-level domain for advertiser checking. This can
be a list of domains if there is a rotating creative
Win notice URL
Пример bid response
{
"id": "85e6debb-8aa9-4010-85ed-14a9256de597",
Система для управления и аудита рекламных кампаний в интернете
"bidid": "C7hzK05T-kM3VETDbZ2fagMmIwn-46pjb",
"seatbid": [
{
"bid": [
{
"id": "1",
"impid": "C7hzK05T-kM3VETDbZ2fagMmIwn-46pjb",
"price": 44.59,
"adid": "2077705",
"adomain": [
"http://www.quelle.ru/"
],
"nurl":
"http://rad.adriver.ru/cgi-bin/erle.cgi?expid=C7hzK05T-kM3VETDbZ2fagMmIwn46pjb&wprc=${AUCTION_PRICE}&pass=![pass]&tuid=-1",
"cid": "254015"
}
]
}
],
"cur": "RUB"
}
* параметры заполняются не всегда, при наличии технической возможности
Подробную информацию о Real Time Bidding и описание протокола можно найти по следующей ссылке:
http://www.adriver.ru/rtb/
Пожалуйста, заполните форму ниже и верните ее по адресу dspssp@adriver.ru с пометкой в
заголовке “[НАЗВАНИЕ ВАШЕЙ КОМПАНИИ] - DSP интеграция с AdRiver SSP” или
ответьте в ту же цепочку писем.
Компания (полное
юридическое название)
Адрес (почтовый)
Веб-сайт продукта
Ссылка на политику
конфиденциальности
Ссылка на отписку от
кук
Кто заполнял форму /
Ответственный за
интеграцию
[Cookie Opt-Out link]
[ФИО][e-mail][Рабочий тел.][Мобильный тел.][Должность]
Система для управления и аудита рекламных кампаний в интернете
Бизнес контакт для
подписания контрактов
[ФИО][e-mail][Рабочий тел.][Мобильный тел.][Должность]
Техподдержка
[ФИО][e-mail][Рабочий тел.][Мобильный тел.][Должность]
Бизнес модель DSP
Собственный биддер?
Лицензированная
технология RTB?
Используете ли вы
технологию
Fingerprinting?
[Да] [Нет]
[Да] [Нет] Если да, то на основе какой технологии и какой протокол взаимодействия?
[Да] [Нет] В каких случаях?
Инвентарь [Мобильный App] [Мобильный Web] [Desktop]
[http://sub.foo.com]
Перечислите домены и
поддомены доставки
рекламы
Проставляете ли Вы
куки Cookies во время
показа рекламного
блока?
Перечислите домены и
поддомены с которых
устанавливаются
Cookies
Укажите полный URL
для синхронизации кук
Укажите полный URL
биддера, порт
Максимальное число
запросов в секунду
Поддерживаете ли вы
Click Macro?
Поддерживаете ли вы
Cachebuster
Поддерживаете ли вы
категории и в каком
справочнике?
Какие метрики
обсчитываются в
отчетах?
Какая задержка по
подсчету?
Есть ли фильтрование в
отчетах, как
реализовано?
Известны ли какие-то
причины расхождения
в отчетах?
В каких странах есть
сервера?
Какая пропускная
способность
задействована в
датацентре?
Существует ли метод
[Да] [Нет] [Браузерные]
[Да] [Нет] [Флешевые]
[Да] [Нет] [Другие LSO]
[http://sub.foo.com]
[Cookie syncking URL]
[Bidder URL]
[QPS]
[Да] [Нет] [YOUR_CLICK_MACRO PARAMETER]
Параметр будет передан в макросе click=//![rhost]/cgi-bin/eclick.cgi?xpid=![xpid]
[Да] [Нет] Автоматически передаем CACHEBUSTER
[Да] [Нет] Требуется замена на вашей стороне [OUR_CACHEBUSTER_PARAMETER]
[Да] [Нет] Категории будут передаваться в параметре bcat=
Используемый справочник [TNS] [IAB] [Google]
[Да] [Нет] задержка по подсчету показов. Какая?
[Да] [Нет] задержка по подсчету кликов. Какая?
[Да] [Нет] Показы. Как?
[Да] [Нет] Клики. Как?
[Bandwidth utilized in %]
[Да] [Нет] Как происходит мониторинг?
Система для управления и аудита рекламных кампаний в интернете
мониторинга серверов?
Существует ли
мониторинг на вирусы
и вредоносные
программы?
Время доставки баннеров?
Доступность сервера?
[Да] [Нет] Как реализован?
Теги для траффикинга – пришлите все варианты тегов, которые будут проходить через
Adriver SSP.
Допустимо использовать ЛИБО только javascript тэги, либо только iframe тэги.
Javascript 240x400
IFrame 240x400
VAST
Другие
Нужно заполнить одно из этих полей
Нужно заполнить одно из этих полей