Расширение протокола openrtb

Bid-response

В ставках к SSP системе DSP передает идентификатор креатива ОРД в отдельном extension’е на уровне креатива.

атрибут	тип	Описание
nroa	массив	Массив идентификаторов, принадлежащих креативу, делающего ставку, минимально — один идентификатор

Пример bid-response

Общий случай:

{
   "id":"1234567890",
   "bidid":"abc1123",
   "cur":"USD",
   "seatbid":[
      {
         "seat":"512",
         "bid":[
            {
               "id":"1",
               "impid":"102",
               "price":9.43,
               "nurl":"http://adserver.com/winnotice?impid=102",
               "iurl":"http://adserver.com/pathtosampleimage",
               "adomain":[
                  "advertiserdomain.com"
               ],
               "cid":"campaign111",
               "crid":"creative112",
               "ext":{
                  "nroa":{
                     "erid":[
                        "token1",
                        "token2"
                     ]
                  }
               },
               "attr":[
                  1,
                  2,
                  3,
                  4,
                  5,
                  6,
                  7,
                  12
               ]
            }
…

Нативный креатив в ставке.

"native":{
   "assetsurl":"“http"://www.myadserver.com/getad123nativejson.php”,
   "link":{
      "url":"http: //i.am.a/URL"
   },
   "assets":[
      {
         "id":123,
         "required":1,
         "title":{
            "text":"Learn about this awesome thing"
         },
         "ext":{
            "nroa":[
               "token1",
               "token2"
            ]
         }
      },
      {
         "id":124,
         "required":1,
         "img":{
            "url":"http://www.myads.com/thumbnail1.png"
         },
         "ext":{
            "nroa":[
               "token1",
               "token2"
            ]
         }
      },
      {
         "id":128,
         "required":1,
         "img":{
            "url":"http://www.myads.com/largethumb1.png"
         },
         "ext":{
            "nroa":[
               "token1",
               "token2"
            ]
         }
      },
      {
         "id":126,
         "required":1,
         "data":{
            "value":"My Brand"
         }
      },
      {
         "id":127,
         "required":1,
         "data":{
            "value":"Learn all about this awesome story of someone using my product"
         }
      }
   ]
}

Сервис по предоставлению данных для подачи отчетности.

Авторизация.
Доступ к сервису осуществляется с использованием логина/пароля (или ключа).
Аутентификация.
Реализуется аутентификация по паре логин — токен.
Методы API.
1. Получение данных по договору по ЕРИР-идентификатору креатива
  GET /contracts/tokenID={tokenID}?startdate-stopdate

Параметры запроса

Атрибут	Тип	Комментарий
tokenID	string; required	Идентификатор, назначенный креативу на стороне ОРД
startdate	date	Дата начала периода
stopdate	date	Дата окончания периода

Ответ системы

Атрибут	Тип	Комментарий
creativeID	number	Идентификатор креатива системы Soloway из ставки
tokenID	string	Идентификатор, назначенный креативу на стороне ОРД
contractid	string	ID договора
startdate	date	Дата начала периода
stopdate	date	Дата окончания периода
contracttype	string	Тип договора
subtype	string	Вид договора
date	date	Дата заключения договора; дата принятия оферты.
contractor_inn	string	ИНН исполнителя
client_inn	string	ИНН заказчика
contractor_legal_name	string; base64 encoded	Юридическое наименование исполнителя
client_legal_name	string; base64 encoded	Юридическое наименование заказчика

3.2 Получение данных по договору по идентификатору креатива в системе Soloway
GET /contracts/creativeID={creativeID}?startdate-stopdate

Параметры запроса

Атрибут	Тип	Комментарий
creativeID	number	Идентификатор креатива системы Soloway из ставки
startdate	date	Дата начала периода
stopdate	date	Дата окончания периода

Ответ системы

Атрибут	Тип	Комментарий
creativeID	number; required	Идентификатор креатива системы Soloway из ставки
tokenID	string	Идентификатор, назначенный креативу на стороне ОРД
contractid	string	ID договора
startdate	date	Дата начала периода
stopdate	date	Дата окончания периода
contracttype	string	Тип договора
subtype	string	Вид договора
date	date	Дата заключения договора; дата принятия оферты.
contractor_inn	string	ИНН исполнителя
client_inn	string	ИНН заказчика
contractor_legal_name	string; base64 encoded	Юридическое наименование исполнителя
client_legal_name	string; base64 encoded	Юридическое наименование заказчика

3.4 Получение данных по договору по всем креативам, показывающимся в SSP от системы Soloway
GET /contracts/ssp_id={sspID}?startdate-stopdate

Параметры запроса

Атрибут	Тип	Комментарий
ssp_id	int64; required	Идентификатор SSP системы
startdate	date	Дата начала периода
stopdate	date	Дата окончания периода

Ответ системы

Атрибут	Тип	Комментарий
ssp_id	int64	Идентификатор SSP системы
creativeID	number; required	Идентификатор креатива системы Soloway из ставки
tokenID	string	Идентификатор, назначенный креативу на стороне ОРД
contractid	string	ID договора
startdate	date	Дата начала периода
stopdate	date	Дата окончания периода
contracttype	string	Тип договора
subtype	string	Вид договора
date	date	Дата заключения договора; дата принятия оферты.
contractor_inn	string	ИНН исполнителя
client_inn	string	ИНН заказчика
contractor_legal_name	string;base64 encoded	Юридическое наименование исполнителя
client_legal_name	string;base64 encoded	Юридическое наименование заказчика

3.5 Примеры

GET /contracts/tokeniID=ORD1-AXZR1Vfcct86mrcZfNysTvM63A?startdate=2022-08-01&stopdate=2022-09-01

{
"creativeID" : 8045257,
"tokenID" : "ORD1-AXZR1Vfcct86mrcZfNysTvM63A",
"contractid" : "N630-8264K",
"startdate" : "2022-08-01",
"stopdate" : "2022-09-01",
"contracttype" : "",
"subtype" : "",
"date" : "2022-07-31",
"contractor_inn" : "6449013711",
"client_inn" : "6449013712",
"contractor_legal_name" : "ООО Ромашка",
"client_legal_name" : "ООО Цветочек"
}

GET /contracts/creativeID=8045257?startdate=2022-08-01&stopdate=2022-09-01

{
"creativeID" : 8045257,
"tokenID" : "ORD1-AXZR1Vfcct86mrcZfNysTvM63A",
"contractid" : "N630-8264K",
"startdate" : "2022-08-01",
"stopdate" : "2022-09-01",
"contracttype" : "",
"subtype" : "",
"date" : "2022-07-31",
"contractor_inn" : "6449013711",
"client_inn" : "6449013712",
"contractor_legal_name" : "ООО Ромашка",
"client_legal_name" : "ООО Цветочек"
}

GET /contracts/ssp_id=55?startdate=2022-08-01&stopdate=2022-09-01

{“creatives”:[
{
"creativeID" : 8045257,
"tokenID" : "ORD1-AXZR1Vfcct86mrcZfNysTvM63A",
"contractid" : "N630-8264K",
"startdate" : "2022-08-01",
"stopdate" : "2022-09-01",
"contracttype" : "",
"subtype" : "",
"date" : "2022-07-31",
"contractor_inn" : "6449013711",
"client_inn" : "6449013712",
"contractor_legal_name" : "ООО Ромашка",
"client_legal_name" : "ООО Цветочек"
},
{
"creativeID" : 8045258,
"tokenID" : "ORD1-SCJRH1Vsss1586mrcZfNysTmT14C",
"contractid" : "N630-8264K",
"startdate" : "2022-08-01",
"stopdate" : "2022-09-01",
"contracttype" : "",
"subtype" : "",
"date" : "2022-07-31",
"contractor_inn" : "6449013711",
"client_inn" : "6449013712",
"contractor_legal_name" : "ООО Ромашка",
"client_legal_name" : "ООО Цветочек"
}
]
}