Ответ DSP
Заявка на участие в аукционе передается методом POST в формате json (Content-Type: application/json).
Тело ответа
В теле ответа содержится объект Bid Response.
Внимание
Пиксели статистики должны поддерживать HTTPS.
{
"id": "(string)",
"cur": "(string)",
"seatbid": [
{
"bid": [
{
"impid": "(string)",
"id": "(string)",
"price": "(float)",
"adid": "(string)",
"adomain": [
"(array of strings)"
],
"payload": "(string)",
"cid": "(string)",
"crid": "(string)",
"lurl": "(string)",
"nurl": "(string)",
"burl": "(string)",
"adm": "(string)",
"cat": [
"(array of strings)"
],
"exp": "(int)",
"iurl": "(string)",
"protocol": "(int)",
"ext": {
"nroa": {
"erid": "(string)",
"has_nroa_markup": "(int)",
"client": {
"inn": "(string)",
"legal_form": "(string)",
"name": "(string)",
"mobile_phone": "(string)",
"epay_number": "(string)",
"reg_number": "(string)",
"alternative_inn": "(string)",
"oksm_number": "(string)"
}
},
"skadn": {
"campaign": "(string)",
"fidelities": [
{
"fidelity": "(int)",
"nonce": "(string)",
"signature": "(string)",
"timestamp": "(string)"
}
],
"itunesitem": "(string)",
"network": "(string)",
"sourceapp": "(string)",
"version": "(string)"
},
"storeurl": "(string)"
}
}
]
}
]
}
Параметры ответа
|
Параметр |
Описание |
Обязательность |
|
Bid Response object |
||
|
id |
Идентификатор аукциона, полученный из RTB-хоста. |
да |
|
cur |
Валюта, в которой указана ставка – параметр Seatbid.Bid.price. Возможные варианты:
|
да |
|
seatbid |
Массив объектов |
да |
|
Seatbid object |
||
|
bid |
Массив объектов |
да |
|
Seatbid.Bid object |
||
|
impid |
Идентификатор объекта |
да |
|
id |
Идентификатор рекламного блока на HTML-странице, полученный из ORTB-хоста. |
да |
|
price |
Ставка — цена показа, устраивающая DSP. Указывается за 1000 показов. |
да |
|
adid |
Идентификатор баннера в DSP. |
да |
|
adomain |
Домен рекламодателя, чью рекламу содержит ответ DSP. Допустимо только одно значение в массиве. |
да |
|
payload |
JSON, полученный от DSP. Максимум 1024 символа. Может быть передан в Bid Loss Notification. |
нет |
|
cid |
Идентификатор рекламной кампании на стороне DSP. |
да |
|
crid |
Идентификатор рекламного блока на HTML-странице, полученный из ORTB-хоста. |
нет |
|
lurl |
URL, вызываемый в случае проигрыша в аукционе. |
нет |
|
nurl |
URL, вызываемый при победе в аукционе. |
нет |
|
burl |
URL, вызываемый в момент списания средств за платное событие. |
нет |
|
adm |
XML-код, предназначенный для встраивания в плеер. Может содержать макросы, которые будут заменены при отрисовке креатива. Содержит объект в формате VAST. |
нет |
|
cat |
Категории контента IAB для креатива. |
нет |
|
iurl |
Ссылка на изображение из контента кампании для проверки качества и безопасности рекламы. |
нет |
|
protocol |
Поддерживаемый видео протокол. |
нет |
|
ext |
Объект с дополнительными параметрами. |
нет |
|
Bid.ext object |
||
|
nroa |
Родительский объект для расширения. |
нет |
|
skadn |
Родительский объект для SKAdNetwork. |
нет |
|
storeurl |
Начальный url-адрес App Store для приложения, к которому будет осуществлен переход. |
нет |
|
nroa object |
||
|
erid |
ЕРИД. |
нет |
|
has_nroa_markup |
Включает ли креатив маркировку согласно законодательству. Принимает значения 0 или 1. |
нет |
|
contractor |
Информация об исполнителе по изначальному договору. |
нет |
|
client |
Информация о заказчике по изначальному договору. |
нет |
|
initial_contract |
Информация об изначальном договоре. |
нет |
|
parent_contracts |
Список «родительских» договоров. Если изначальный договор клиента имеет тип «дополнительное соглашение», необходимо передать информацию о соответствующем исходном договоре |
Обязателен для дополнительных соглашений |
|
Client object |
||
|
inn |
ИНН физического или юридического лиц. |
нет |
|
legal_form |
Тип организации из списка «Список типов организации». |
нет |
|
name |
ОПФ и юридическое наименование. |
нет |
|
mobile_phone |
Номер телефона. Заполняется для иностранных физических и юридических лиц в соответствии с требованиями ЕРИР. |
нет |
|
epay_number |
Номер банковского счета, номер электронного кошелька или подобные номера, за исключением номера банковской карты. |
нет |
|
reg_number |
Регистрационный номер либо его аналог. Заполняется для иностранных физических и юридических лиц в соответствии с требованиями ЕРИР. |
нет |
|
alternative_inn |
Номер налогоплательщика либо его аналог в стране регистрации. Заполняется для иностранных физических и юридических лиц в соответствии с требованиями ЕРИР. |
нет |
|
oksm_number |
Код страны регистрации юридического лица в соответствии с ОКСМ. Заполняется для иностранных юридических лиц в соответствии с требованиями ЕРИР. |
нет |
|
skadn object |
||
|
campaign |
Идентификатор кампании, соответствующий спецификации Apple. Начиная с версии 2.0, представляет собой целое число от 1 до 100, в формате строки. |
нет |
|
fidelities |
Список поддерживаемых типов fidelity, представленных в SKAdNetwork v2.2. |
нет |
|
itunesitem |
Идентификатор приложения рекламодателя в Apple App Store. Должен совпадать с |
нет |
|
network |
Идентификатор рекламной сети, используемый в подписи. Должен совпадать с одним из элементов массива |
нет |
|
sourceapp |
Идентификатор приложения-издателя в Apple App Store. Должен совпадать с |
нет |
|
version |
Версия SKAdNetwork. |
нет |
|
fidelities object |
||
|
fidelity |
Точность воспроизведения. |
нет |
|
nonce |
Идентификатор, уникальный для каждого Bid Response. Требования к формату UUID приведены в документации Apple. |
нет |
|
signature |
Подпись SKAdNetwork, соответствующая спецификации Apple. |
нет |
|
timestamp |
Unix-время в миллисекундах на момент создания подписи. |
нет |
Пример ответа
{
"bidid": "9218750a64d68fb3ae3b8d5d849c9d63",
"cur": "RUB",
"id": "2071435468055052649",
"seatbid": [
{
"bid": [
{
"adid": "6256ab117bc72f01b40e8af5",
"adm": "<?xml version=\"1.0\" encoding=\"utf-8\" ?><VAST version=\"4.0\"><Ad id=\"6256ab117bc72f01b40e8af5\"><InLine><AdSystem>dspname</AdSystem><AdTitle><![CDATA[VTR.mp4]]></AdTitle><Error><![CDATA[https://dsa.dspname.ai/DeliverySeance/SaveErrorEvent2?ssp=182&sid=__33_e5qqr3dz1e9cx9qubkzpt89g5naeb7wyg6k8dy9c6x4fgkiczewdjttt734gj6nw8x47eahstg4qe&err=[ERRORCODE]&r=]]></Error><Impression><![CDATA[https://dsa.dspname.ai/DeliverySeance/SaveImpression2?ssp=182&sid=__33_sdrxb1q6oespyikbribry7ryidtowfd8i8o91qh8kwi4np151exo3tte7hcxt9on3jfrh14tph86s&adid=__33_c9ot7f34znk39gtef3hxepe78szytf65ny15pbtoxc7boaka4nh9iswewtrasapcgma6whrxp4f6r&p=&rdu=&r=]]></Impression><Impression><![CDATA[https://ad.adriver.ru/cgi-bin/rle.cgi?sid=1&ad=735441&bt=21&pid=3368131&bid=7829021&bn=7829021&rnd=1535275276]]></Impression><Creatives><Creative><Linear><Duration>00:00:13</Duration><TrackingEvents><Tracking event=\"start\"><![CDATA[https://dsa.dspname.ai/DeliverySeance/SaveStartEvent2?ssp=182&sid=__33_e5qqr3dz1e9cx9qubkzpt89g5naeb7wyg6k8dy9c6x4fgkiczewdjttt734gj6nw8x47eahstg4qe&r=]]></Tracking><Tracking event=\"firstQuartile\"><![CDATA[https://dsa.dspname.ai/DeliverySeance/SaveView2?ssp=182&sid=__33_a1togz6kyzr9dubjysqysb3i3jm3ans1tpuf1sp1qd7kzzzp719gfhrqkp1indfjiqagd5zmbdsqs&r=]]></Tracking><Tracking event=\"firstQuartile\"><![CDATA[https://dsa.dspname.ai/DeliverySeance/SaveFirstQuartileEvent2?ssp=182&sid=__33_e5qqr3dz1e9cx9qubkzpt89g5naeb7wyg6k8dy9c6x4fgkiczewdjttt734gj6nw8x47eahstg4qe&r=]]></Tracking><Tracking event=\"midpoint\"><![CDATA[https://dsa.dspname.ai/DeliverySeance/SaveMidpointEvent2?ssp=182&sid=__33_e5qqr3dz1e9cx9qubkzpt89g5naeb7wyg6k8dy9c6x4fgkiczewdjttt734gj6nw8x47eahstg4qe&r=]]></Tracking><Tracking event=\"thirdQuartile\"><![CDATA[https://dsa.dspname.ai/DeliverySeance/SaveThirdQuartileEvent2?ssp=182&sid=__33_e5qqr3dz1e9cx9qubkzpt89g5naeb7wyg6k8dy9c6x4fgkiczewdjttt734gj6nw8x47eahstg4qe&r=]]></Tracking><Tracking event=\"complete\"><![CDATA[https://dsa.dspname.ai/DeliverySeance/SaveCompleteEvent2?ssp=182&sid=__33_e5qqr3dz1e9cx9qubkzpt89g5naeb7wyg6k8dy9c6x4fgkiczewdjttt734gj6nw8x47eahstg4qe&r=]]></Tracking><Tracking event=\"mute\"><![CDATA[https://dsa.dspname.ai/DeliverySeance/SaveMuteEvent2?ssp=182&sid=__33_e5qqr3dz1e9cx9qubkzpt89g5naeb7wyg6k8dy9c6x4fgkiczewdjttt734gj6nw8x47eahstg4qe&r=]]></Tracking><Tracking event=\"unmute\"><![CDATA[https://dsa.dspname.ai/DeliverySeance/SaveUnmuteEvent2?ssp=182&sid=__33_e5qqr3dz1e9cx9qubkzpt89g5naeb7wyg6k8dy9c6x4fgkiczewdjttt734gj6nw8x47eahstg4qe&r=]]></Tracking><Tracking event=\"pause\"><![CDATA[https://dsa.dspname.ai/DeliverySeance/SavePauseEvent2?ssp=182&sid=__33_e5qqr3dz1e9cx9qubkzpt89g5naeb7wyg6k8dy9c6x4fgkiczewdjttt734gj6nw8x47eahstg4qe&r=]]></Tracking><Tracking event=\"rewind\"><![CDATA[https://dsa.dspname.ai/DeliverySeance/SaveRewindEvent2?ssp=182&sid=__33_e5qqr3dz1e9cx9qubkzpt89g5naeb7wyg6k8dy9c6x4fgkiczewdjttt734gj6nw8x47eahstg4qe&r=]]></Tracking><Tracking event=\"resume\"><![CDATA[https://dsa.dspname.ai/DeliverySeance/SaveResumeEvent2?ssp=182&sid=__33_e5qqr3dz1e9cx9qubkzpt89g5naeb7wyg6k8dy9c6x4fgkiczewdjttt734gj6nw8x47eahstg4qe&r=]]></Tracking><Tracking event=\"fullscreen\"><![CDATA[https://dsa.dspname.ai/DeliverySeance/SaveFullscreenEvent2?ssp=182&sid=__33_e5qqr3dz1e9cx9qubkzpt89g5naeb7wyg6k8dy9c6x4fgkiczewdjttt734gj6nw8x47eahstg4qe&r=]]></Tracking><Tracking event=\"expand\"><![CDATA[https://dsa.dspname.ai/DeliverySeance/SaveExpandEvent2?ssp=182&sid=__33_e5qqr3dz1e9cx9qubkzpt89g5naeb7wyg6k8dy9c6x4fgkiczewdjttt734gj6nw8x47eahstg4qe&r=]]></Tracking><Tracking event=\"collapse\"><![CDATA[https://dsa.dspname.ai/DeliverySeance/SaveCollapseEvent2?ssp=182&sid=__33_e5qqr3dz1e9cx9qubkzpt89g5naeb7wyg6k8dy9c6x4fgkiczewdjttt734gj6nw8x47eahstg4qe&r=]]></Tracking><Tracking event=\"acceptInvitation\"><![CDATA[https://dsa.dspname.ai/DeliverySeance/SaveAcceptInvitationEvent2?ssp=182&sid=__33_e5qqr3dz1e9cx9qubkzpt89g5naeb7wyg6k8dy9c6x4fgkiczewdjttt734gj6nw8x47eahstg4qe&r=]]></Tracking><Tracking event=\"close\"><![CDATA[https://dsa.dspname.ai/DeliverySeance/SaveCloseEvent2?ssp=182&sid=__33_e5qqr3dz1e9cx9qubkzpt89g5naeb7wyg6k8dy9c6x4fgkiczewdjttt734gj6nw8x47eahstg4qe&r=]]></Tracking></TrackingEvents><VideoClicks><ClickThrough><![CDATA[https://dsa.dspname.ai/DeliverySeance/SaveClick2?sid=__33_wpucgzrpt5g9bs5nsbc11nx8naddt6nz4nkppqpgbdf55w1k1ox3d3fyjswgj6b93z165kgnaazae&ssp=182&bn=__33_y5wbgpyx8ihucfd3cs94oz6sj46g7jwh3mfaqwcfmwqncb6eozhbeokqo1wc3ctisouhh64674znh&dst=__33_h63mwajiyeg76rudc3drjw7kwfet7h3sh4s6467jr63h9rdax1xbbkut3acncd9dj6t9wwkytq9xebh9tacr5if8wgx1t9tsqjcbgo8j5bz569kgwiw5epk5erx56cbkgwq8mjyintnw1n8uk7wdnmmz7q4shtowj1d8rj5cgt75n9e3nai3ttas9pgyzm9stgeuse9u1n16n&bct=&r=]]></ClickThrough></VideoClicks><MediaFiles><MediaFile delivery=\"progressive\" type=\"video/x-flv\" bitrate=\"7717\" width=\"1920\" height=\"1080\"><![CDATA[https://content.dspname.ai/dspname/90/15/9015D1B05995C9263F7598EB8B2A6F66.flv]]></MediaFile><MediaFile delivery=\"progressive\" type=\"video/mp4\" bitrate=\"9140\" width=\"1920\" height=\"1080\"><![CDATA[https://content.dspname.ai/dspname/BB/48/BB486A4504ED516F956E78DBAFFED661.mp4]]></MediaFile><MediaFile delivery=\"progressive\" type=\"video/webm\" bitrate=\"8515\" width=\"1920\" height=\"1080\"><![CDATA[https://content.dspname.ai/dspname/76/88/768891ED424907E2710F3511C33F91F3.webm]]></MediaFile><MediaFile delivery=\"progressive\" type=\"video/x-ms-wmv\" bitrate=\"200\" width=\"1920\" height=\"1080\"><![CDATA[https://content.dspname.ai/dspname/C2/5B/C25B86B85243C25375375A598E8FE820.wmv]]></MediaFile></MediaFiles></Linear></Creative></Creatives><Extensions></Extensions></InLine></Ad></VAST>",
"adomain": [
"kontur.ru"
],
"burl": "https://dssa.dspname.ai/openrtb/bil/182/?r=9547351836376329&sid=__33_6hb3sm9y5hrusrs1d8u8tcbnanpjo589b4ytsazxhofsdt8cys6d4dbgxj4bx1kidt947484roits&adid=__33_p4dcrkpsgddfbr4ssyjbtjspp6u5y5yxnot9gmd8yb9cbice99qm1k6y61hw7qdteek9xzr3hur6q&p=${AUCTION_PRICE}",
"cat": [
"IAB3"
],
"cid": "6256aae67bc72f01b40e8ae8",
"crid": "6256ab117bc72f01b40e8af5",
"exp": 7200,
"ext": {},
"id": "1e66c5dda15e8ae37bbb2f8f62d87575",
"impid": "14",
"iurl": "https://content.dspname.ai/dspname/BB/48/BB486A4504ED516F956E78DBAFFED661.mp4",
"nurl": "https://dssa.dspname.ai/openrtb/video2/182/?r=9547351836376329&sid=__33_6hb3sm9y5hrusrs1d8u8tcbnanpjo589b4ytsazxhofsdt8cys6d4dbgxj4bx1kidt947484roits&adid=__33_p4dcrkpsgddfbr4ssyjbtjspp6u5y5yxnot9gmd8yb9cbice99qm1k6y61hw7qdteek9xzr3hur6q&p=${AUCTION_PRICE}&adm=False",
"payload": "1e66c5dda15e8ae37bbb2f8f62d87575",
"price": 55,
"protocol": 7,
"ext": {
"nroa": {
"erid":"efr23i",
"has_nroa_markup":0,
"client":{
"inn":"71445203",
"name":"ООО Неваляшка",
"legal_form":"ul"
}
},
"skadn": {
"campaign": "11",
"fidelities": [
{
"fidelity": 0,
"nonce": "f9f8be1b-a396-4ff6-95e5-b50508caa18",
"signature": "MDUCGQD4bhRqyMk2lcz3/mi0943580485038Owgcz9tcS8acHhxMxqJ0K6P968spxQ==",
"timestamp": "1730704281000"
},
{
"fidelity": 1,
"nonce": "a5914e5b-4f06-4278-bc39-d0550678ff72",
"signature": "MDUCGH9mfWRIErBnitWx2/Vsx809485034858340VSXgsVCh2BHUXXvq54XcT/2qyaBYkw==",
"timestamp": "1730704280000"
}
],
"itunesitem": "911804296",
"network": "w9q455wk68.skadnetwork",
"sourceapp": "6471572249",
"version": "3.0"
},
"storeurl": "https://apps.apple.com/app/id1579364157"
}
}
]
}
]
}
Пример атрибута для маркировки рекламы.
Добавляется в XML-код из поля seatbid.bid.adm:
<Ad>
...
<InLine>
<Extensions>
<Extension type="nroa_inform">
<Url>https://example.com/...</Url>
</Extension>
</Extensions>
</InLine>
</Ad>