Skip to main content

SSP - Video - Request

Эта страница документации описывает структуру запроса к эндпоинту, который наша SSP-платформа отправляет для проведения аукциона за инвентарь видеорекламы.

Видеозапрос (Video Bid Request) содержит параметры, необходимые для закупки видеорекламы. Помимо стандартных данных о сайте и пользователе, он детально описывает форматы и технические требования к креативу.

{
"id": "CghSUi1tcy5oYhDzp4G6BhimjZPAAiDNk5L9Bg**",
"cur": ["RUB"],
"badv": [],
"source": {
"fd": 1,
"ext": {
"network": "ms.hb"
}
},
"tmax": 100,
"imp": [{
"id": "0",
"metric": [{
"type": "viewability",
"value": 0.80000000000000004
}],
"video": {
"mimes": ["video/x-flv", "video/mp4"],
"minduration": 5,
"maxduration": 300,
"protocols": [2, 3, 4, 5, 6, 7, 8],
"w": 1920,
"h": 1080,
"startdelay": 0,
"placement": 1,
"pos": 0,
"minbitrate": 0,
"maxbitrate": 1500,
"playbackmethod": [6],
"delivery": [2]
},
"tagid": "3985",
"bidfloor": {
BF_MACROS .0
},
"bidfloorcur": "RUB",
"ext": {
"placementid": "3985",
"hbblockid": "871"
}
}],
"bcat": [],
"site": {
"id": "871",
"name": "Demo",
"domain": "http://demo.terratraf.com ",
"page": "https://demo.terratraf.com/",
"cat": ["IAB3-1"],
"publisher": {
"id": "273000266"
},
"ext": {
"network": "Demo"
}
},
"device": {
"ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36",
"ip": "81.163.28.82"
},
"user": {
"eids":[{"source":"RTK","uids":["ba259169dcd89028"]}],
"id": "3d276c2c-111b-11ee-86e0-002590c0647c",
"buyeruid": ""
}
}
KeyValueComment
currubВалюта
badvНапример: [ "apple.com", "go-text.me", "heywire.com" ]Блокировка списка рекламодателей по их доменам (например, “Apple ”). В ответе ожидаются креативы, у которых конечный домен "adomain" будет отличным от доменов в списке badv.
source
fd1Кто принимает решение о выигрыше: 0 - SSP, 1 - Апстрим
ext -> networkms.hbИсточник трафика
imp
metric -> viewabilityНа текущий момент передается только одна метрика viewability, для тех блоков, для которых накоплено не достаточно данных данная метрика будет отсутствовать в запросе
site
site -> catIAB24IAB категория площадки
user
user → eids → uidsStable IDУникальный идентификатор на основе данных оператора в момент, когда пользователь заходит на веб-ресурс или обращается к сервису.