 Система для управления и аудита рекламных кампаний в интернете Форма интеграции 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
|
DSP, сделавший максимальную ставку побеждает и платит на 1/100 единицы валюты больше предшествующей ставки. Так называемая win_price никогда не превышает bid_price. В случае если ставки совпали, побеждает любая.
|
Мах интервал для подтверждения бида
|
100мс
|
Если больше 100мс, система перестаёт ожидать bid response
|
Тип объекта показа
|
banner
|
В будущем будет возможность показа VAST и Mobile Ads?
|
Метод передачи рекламы в объекте bid
|
adm или nurl
|
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&aid=![reqid]&aprice=${AUCTION_PRICE}
|
//![rhost]/cgi-bin/eclick.cgi?xpid=![xpid]
|
Трекинг кликов. После выигрыша аукциона и при показе креатива DSP осуществляет редирект пользователя самостоятельно, сообщив об этом AdRiver при помощи вызова URL из макроса //![rhost]/cgi-bin/eclick.cgi?xpid=![xpid], который SSP заполняет при информировании DSP о победе (через NURL) в вашем параметре для подсчета кликов, например click=
|
“nurl”:”http://dsp.domen.ru/winnoticeurl&click=//![rhost]/cgi-bin/eclick.cgi?xpid=![xpid] ”,
|
![reqid]
|
Уникальный идентификатор запроса
|
“id”: “1234534625254”
|
![pos]
|
Местоположение баннера
0 – неизвестна
1 – верх
2 – середина середина (Может быть как на видимом так и на не видимом экране в зависимости от разрешения.)
3 – низ страницы (Вне поля зрения на экране.)
|
“pos”:1,
|
![dsp_id]
|
dsp_id=YOUR_ID – id назначенные DSP, необходимо для синхронизации кук
|
http://ssp.adriver.ru/cgi-bin/sync.cgi?
dsp_id=99&external_user_id=332234
| Синхронизация кук
База синхронизированных кук всегда находится у 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
Сервис 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
|
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
|
device
|
object
|
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)
|
user
|
object
|
This object describes the user, and may include unique identifiers for the user
|
site
|
object
|
Either a site or app object may be included – not both. Neither is required
|
bcat
|
array of string
|
Blocked Advertiser Categories *
|
cur
|
array of string
|
Currency of the auction
| Impression
Параметр
|
Тип
|
Описание
|
id
|
string
|
A unique identifier for this impression within the context of the bid request
|
banner
|
object
|
A reference to a banner object
|
bidfloor
|
float
|
Bid floor for this impression in CPM *
|
bidfloorcur
|
string
|
Currency of bidfloor attribute
| Banner
Параметр
|
Тип
|
Описание
|
w
|
integer
|
Width of the impression in pixels
|
h
|
integer
|
Height of the impression in pixels
|
pos
|
integer
|
Ad Position
|
battr
|
Array of integer
|
Specifies the types of creatives blocked by publisher*
| Site
Параметр
|
Тип
|
Описание
|
id
|
string
|
Site ID on the exchange
|
ref
|
optional
|
Referrer URL that caused navigation to the
current page *
|
page
|
string
|
Full url of the page where impression to be occur *
|
cat
|
array of string
|
Array of IAB content categories for 5 the overall site
|
sectioncat
|
array of string
|
Array of IAB content categories for the current subsection of the site.
| Device
Параметр
|
Тип
|
Описание
|
ua
|
string
|
Browser user agent string
|
ip
|
string
|
Browser language; use alpha-2/ISO 639-1 codes.
|
geo
|
object
|
*
|
language
|
String
|
*
| Geo
Параметр
|
Тип
|
Описание
|
country
|
string
|
Country, using ISO 3166-1. (See Appendix)*
|
region
|
string
|
Region, using ISO 3166-2.*
|
city
|
string
|
MaxMind GeoCity name (External reference - http://dev.maxmind.com/geoip/le gacy/geolite/)*
|
zip
|
string
|
Zip/postal codes*
| User
Параметр
|
Тип
|
Описание
|
id
|
string
|
Unique consumer ID of this user on the exchange
|
buyeruid
|
string
|
Buyer’s user ID for this user as mapped by exchange for the buyer*
|
Пример bid request
{
"id": "1234534625254",
"imp": [
{
"id": "5",
"bidfloor": "1.2",
"bidfloorcur": "RUB",
"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
|
string
|
ID of the bid request
|
seatbid
|
array of objects
|
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
|
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
|
impid
|
string
|
ID of the impression object to which this bid applies
|
price
|
float
|
Bid price in CPM
|
adid
|
string
|
ID that references the ad to be served if the bid wins
|
adomain
|
array of strings
|
Advertiser’s primary or top-level domain for advertiser checking. This can be a list of domains if there is a rotating creative
|
nurl
|
string
|
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-kM3VETDbZ2fagMmIwn-46pjb&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 во время показа рекламного блока?
| [Да] [Нет] [Браузерные] [Да] [Нет] [Флешевые]
[Да] [Нет] [Другие LSO]
|
Перечислите домены и поддомены с которых устанавливаются Cookies
| [http://sub.foo.com] |
Укажите полный URL для синхронизации кук
| [Cookie syncking URL] |
Укажите полный URL биддера, порт
| [Bidder URL] |
Максимальное число запросов в секунду
| [QPS] |
Поддерживаете ли вы Click Macro?
| [Да] [Нет] [YOUR_CLICK_MACRO PARAMETER] Параметр будет передан в макросе click=//![rhost]/cgi-bin/eclick.cgi?xpid=![xpid] |
Поддерживаете ли вы Cachebuster
| [Да] [Нет] Автоматически передаем CACHEBUSTER
[Да] [Нет] Требуется замена на вашей стороне [OUR_CACHEBUSTER_PARAMETER]
|
Поддерживаете ли вы категории и в каком справочнике?
| [Да] [Нет] Категории будут передаваться в параметре bcat=
Используемый справочник [TNS] [IAB] [Google]
|
Какие метрики обсчитываются в отчетах?
| |
Какая задержка по подсчету?
| [Да] [Нет] задержка по подсчету показов. Какая?
[Да] [Нет] задержка по подсчету кликов. Какая?
|
Есть ли фильтрование в отчетах, как реализовано?
| [Да] [Нет] Показы. Как? [Да] [Нет] Клики. Как? |
Известны ли какие-то причины расхождения в отчетах?
| |
В каких странах есть сервера?
| |
Какая пропускная способность задействована в датацентре?
| [Bandwidth utilized in %] |
Существует ли метод мониторинга серверов?
| [Да] [Нет] Как происходит мониторинг?
Время доставки баннеров?
Доступность сервера?
|
Существует ли мониторинг на вирусы и вредоносные программы?
| [Да] [Нет] Как реализован? | Теги для траффикинга – пришлите все варианты тегов, которые будут проходить через Adriver SSP.
Допустимо использовать ЛИБО только javascript тэги, либо только iframe тэги.
Javascript 240x400 | Нужно заполнить одно из этих полей | IFrame 240x400 | Нужно заполнить одно из этих полей | VAST | | Другие | | |
