---
metadata:
- name: generator
content: Diplodoc Platform v5.50.3
alternate:
- https://yandex.ru/dev/rtb/doc/en/api/web/response.md
- https://yandex.ru/dev/rtb/doc/ru/api/web/response.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/rtb/doc/ru/llms.txt
# Веб-реклама. Ответ DSP
Заявка на участие в аукционе передается методом POST в формате json (Content-Type: application/json).
## Тело ответа
В теле ответа содержится объект `Bid Response`.
{% note alert %}
Пиксели статистики должны поддерживать HTTPS.
{% endnote %}
```json
{
"id": "(string)",
"cur": "(string)",
"seatbid": [
{
"seat": "(string)",
"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)",
"w": "(int)",
"h": "(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)"
}
}
}
}
]
}
]
}
```
## Параметры ответа
### Bid Response object
#|
|| **Параметр** | **Описание** | **Обязательность** ||
|| id | Идентификатор аукциона, полученный из RTB-хоста. | да ||
|| cur | Валюта, в которой указана ставка – параметр `Seatbid.Bid.price`. Возможные варианты:
- RUB — российский рубль;
- USD — американский доллар;
- EUR — евро;
- CHF — швейцарский франк;
- TRY — турецкая лира;
- KZT — казахстанский тенге. | да ||
|| seatbid | Массив объектов `Seatbid`. Содержит ставки за показ. | да ||
|#
### Seatbid object
#|
|| **Параметр** | **Описание** | **Обязательность** ||
|| seat | Идентификатор участника аукциона, от имени которого делается ставка. | да ||
|| bid | Массив объектов `Seatbid.Bid`. Каждый объект содержит параметры баннера и ставку за показ. | да ||
|#
### Seatbid.Bid object
#|
|| **Параметр** | **Описание** | **Обязательность** ||
|| impid | Идентификатор объекта `Imp.id` запроса из ORTB-хоста. | да ||
|| id | Идентификатор рекламного блока на HTML-странице, полученный из ORTB-хоста. | да ||
|| price | Ставка — цена показа, устраивающая DSP. Указывается за 1000 показов. | да ||
|| adid | Идентификатор баннера в DSP. | да ||
|| adomain | Домен рекламодателя, чью рекламу содержит ответ DSP. Допустимо только одно значение в массиве. | да ||
|| payload | JSON, полученный от DSP. Максимум 1024 символа. Может быть передан в [Bid Loss Notification](https://yandex.ru/dev/rtb/doc/ru/api/bid-loss-notification.md). | нет ||
|| cid | Идентификатор рекламной кампании на стороне DSP. | да ||
|| crid | Идентификатор рекламного блока на HTML-странице, полученный из ORTB-хоста. | нет ||
|| lurl | URL, вызываемый в случае проигрыша в аукционе. | нет ||
|| nurl | URL, вызываемый при победе в аукционе. | нет ||
|| burl | URL, вызываемый в момент списания средств за платное событие. | нет ||
|| adm | HTML-код креатива, предназначенный непосредственно для встраивания на страницу. Может содержать [макросы](https://yandex.ru/dev/rtb/doc/ru/api/macros.md), которые будут заменены при отрисовке креатива (для баннерной рекламы).
XML-код, предназначенный для встраивания в плеер. Может содержать [макросы](https://yandex.ru/dev/rtb/doc/ru/api/macros.md), которые будут заменены при отрисовке креатива (для видеорекламы). | нет ||
|| w | Ширина блока в пикселях. | да ||
|| h | Высота блока в пикселях. | да ||
|| cat | Категории контента IAB для креатива. | нет ||
|| iurl | Ссылка на изображение из контента кампании для проверки качества и безопасности рекламы. | нет ||
|| protocol | Поддерживаемый видео протокол. | нет ||
|| ext | Объект с дополнительными параметрами. | нет ||
|#
### Bid.ext object
#|
|| **Параметр** | **Описание** | **Обязательность** ||
|| nroa | Родительский объект для расширения | нет ||
|#
### nroa object
#|
|| **Параметр** | **Описание** | **Обязательность** ||
|| erid | ЕРИД | нет ||
|| has_nroa_markup | Включает ли креатив маркировку согласно законодательству. Принимает значения `0` или `1`. | нет ||
|| client | Информация о заказчике по изначальному договору. | нет ||
|| contractor | Информация об исполнителе по изначальному договору. | нет ||
|| initial_contract | Информация об изначальном договоре. | нет ||
|| parent_contracts | Список «родительских» договоров. Если изначальный договор клиента имеет тип «дополнительное соглашение», необходимо передать информацию о соответствующем исходном договоре | Обязателен для дополнительных соглашений ||
|#
### Client object
#|
|| **Параметр** | **Описание** | **Обязательность** ||
|| inn | ИНН физического или юридического лица. | нет ||
|| legal_form | Тип организации из списка «Список типов организации». | нет ||
|| name | ОПФ и юридическое наименование. | нет ||
|| mobile_phone | Номер телефона. Заполняется для иностранных физических и юридических лиц в соответствии с требованиями ЕРИР. | нет ||
|| epay_number | Номер банковского счета, номер электронного кошелька или подобные номера, за исключением номера банковской карты. | нет ||
|| reg_number | Регистрационный номер либо его аналог. Заполняется для иностранных физических и юридических лиц в соответствии с требованиями ЕРИР. | нет ||
|| alternative_inn | Номер налогоплательщика либо его аналог в стране регистрации. Заполняется для иностранных физических и юридических лиц в соответствии с требованиями ЕРИР. | нет ||
|| oksm_number | Код страны регистрации юридического лица в соответствии с ОКСМ. Заполняется для иностранных юридических лиц в соответствии с требованиями ЕРИР. | нет ||
|#
## Пример ответа — баннерная реклама {#banner-example}
```json
{
"id": "2959715181885154373",
"cur": "RUB",
"seatbid": [
{
"seat": "dsp-global",
"bid": [
{
"impid": "103",
"id": "5ed134b186ca98265293b16c82a7d400",
"price": 32.53,
"adid": "",
"adomain": [
"newbalance.ru"
],
"payload": "6xloAnIVotDKYLYiJvFa7KZAOus_XttPiOJvqXeYa8d2A42ZaSHKZ58F5JVooWyuRIknSeLjoOY4DIS0BOAc_OtReqi2xi-19iMlSxkY4Ou0ghOh9tzGSrTD0OjGmGzX57so3RLtgMX1ePRHDTVWEx4ck5kOtA87IPnmhltnCXRiEP0pFlFTmxJTqnqeT-IjAulqTWUfnjs2Wnq3ReXEQiiLHxJ5Pxfekwci3DLLx_7eNWfSRhgmxFvRD2az1CJN50-FKj-I60xyw0BKT5Vnl3dZa5-CQ5HkiHpPsH0kGm8eVt9crezg0upU_FbAgRseoWEEsQ0moYoogl8r-9mZrD5pM19xnNesEkopxwA73xOvflYGRIanDgGkfwetgzjLW-kn0-hXwgJxVQYIZJBMY5rd5Vhb6YYbBpOeemREwIxebK8IPZ9sUg",
"cid": "111074",
"crid": "",
"lurl": "http://dsp.site.ru/yandexortb/auction/notify?profile=270&imp=S-W20CMRLJqbBxuJp5nDf4scTFpFmUejZDcxNc_lEAhP4FBLi1-DOr4b2WIPPnVLEEU8ecbxIyGuMqyAAZMCnEmGz970qCCZb87fFc6CpFdG5wXVjGcymKgImpgfNYUS-f0A9uSSvk1GYWt_Ya_2_DoVlnp26CI5_hTBEvKqRHb6jNhkK_N9N0GaoC9u-nSW998Yq7HbnsrrhcdHXcyuBGqAUlIE52NQT-UR_I12QFvJ7_CPrjyZiiYgmjeosnSy0dlBV7cL5cysMHlNKiNZB77GcfZaQamE7c4DdbdDf_9FQXZeujvbua5EXdkK0Nsh2lamig04JOnrBpILg-NJepHavjIHAhw3YhCKnWyTDygmXKWv3MVse3VyvuUarLOeDqhUSyAN3aX5Xqo2SzE9V1088glfO3e7RtH5Dugv-pQc0Wvkqq1dkg",
"nurl": "http://dsp.site.ru/yandexortb/auction/notify?profile=270&imp=YbkelGS3jzCPzyueufqCFSZxX4pkpC3LpctDQG4vTZ6PpL8UOtO3tvvBKL27jczCFglYB6hnBmsowc-AqT6lWqGnFYF0AzsQtg4OuodQD9BX5elxuup9R2uiibh9ljlq_XmN4wJOt5qXsTVcE8ICcec7cASnJbFTmw3-PKoXdE6blSkjhyhsLEhy957Wu9ycMOiVeWhs8rq5FnnVosJRjLeBq3ydPrnuvQY8PdAKKs3boI7aMTqjlwN7ZrDcEpIuXxsmY4GOaFdNr_ISe_HfRl1zHbZ6fyVQc0tb9Bdzdt-WSXh98ku_YSmGmUrkgyyHdbWR2YD7XSDyItOt6M4xxv2Xc09XfWcFpMgSJInteqMWsJ6qEIKg8hU6asFZDdgiMQ6d_9vjX7nz4E9_o8frct9Ol8cn79FpyUnKzXvvNQGEsoZFlT-WSQ",
"burl": "http://dsp.site.ru/yandexortb/auction/notify?profile=270&imp=tuqMXsc_qeWxpdjZvM_thf7GFx3_h_OeU77q9FwQzvRJYBE1VXWZ4RRmJK-tOQORLcpmsfxiJKqp93WnibUpT-s5Tux7aEhGA_DDSuzB74q6tVCj1VzrOtJnw31mNNoLy0teiiPZHVtKM9vwUbVk6F3WvVVb5Pa5V2xJwzaQIWlT6XeZjMlaPrmumkjcdqLvTXPA45l7s9g1fLSLai7BTvfDYif2dsdS7--_HXVWTAae5QBH7-UPf-ed7Wn_UR5NWqiRPgE3w3DAf6o9EJWAVZI4UPKNwj-xv0KN3ET4mBOs_Yt5XbXomZIYLrl7Y6Uhyzw1sFLPnrsJxqP7susS_goVErL4oFjt1GvLs0eblfrdNpqc1IQIfy-cC4q4XMubeip7JHS_0MH0g5b1ZhnzpgIwZD0JBSuSPSo6S_i7TUg1DmgC-90hxQ",
"adm": "",
"w": 300,
"h": 600,
"ext": {
"nroa": {
"erid":"efr23i",
"has_nroa_markup":0,
"client":{
"inn":"71445203",
"name":"ООО Неваляшка",
"legal_form":"ul"
}
}
}
}
]
}
]
}
```
## Пример ответа — видеореклама {#video-example}
```json
{
"bidid": "9218750a64d68fb3ae3b8d5d849c9d63",
"cur": "RUB",
"id": "2071435468055052649",
"seatbid": [
{
"bid": [
{
"adid": "6256ab117bc72f01b40e8af5",
"adm": "dspname00:00:13",
"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"
}
}
}
}
]
}
]
}
```
## Пример атрибута для маркировки рекламы — видеореклама {#video-attr-example}
Добавляется в XML-код из поля `seatbid.bid.adm`:
```json
...
https://example.com/...
```