Ответ DSP

Заявка на участие в аукционе передается методом POST в формате json (Content-Type: application/json).

В теле ответа содержится объект Bid Response, показанный ниже.

Внимание.

Пиксели статистики должны поддерживать HTTPS.

{
  "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)",
          "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 — турецкая лира;
  • UAH — украинская гривна;
  • 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. нет
cid Идентификатор рекламной кампании на стороне DSP. да
crid Идентификатор рекламного блока на HTML-странице, полученный из ORTB-хоста. нет
nurl URL, вызываемый при победе в аукционе. нет
burl URL, вызываемый в момент списания средств за платное событие. нет
adm

HTML-код креатива, предназначенный непосредственно для встраивания на страницу. Может содержать макросы, которые будут заменены при отрисовке креатива.

 нет
w Ширина блока в пикселях. да
h Высота блока в пикселях. да
ext Объект с дополнительными параметрами. нет
Bid.ext object
nroa Родительский объект для расширения нет
nroa object
erid ЕРИД нет
has_nroa_markup Включает ли креатив маркировку согласно законодательству. Возможные значения: 0 или 1. нет
client Информация о заказчике по изначальному договору. нет
Client object
inn ИНН физического или юридического лица. нет
legal_form Тип организации из списка «Список типов организации». нет
name ОПФ и юридическое наименование. нет
name ОПФ и юридическое наименование. нет
mobile_phone Номер телефона. Заполняется для иностранных физических и юридических лиц в соответствии с требованиями ЕРИР. нет
epay_number Номер банковского счета, номер электронного кошелька или подобные номера, за исключением номера банковской карты. нет
reg_number Регистрационный номер либо его аналог. Заполняется для иностранных физических и юридических лиц в соответствии с требованиями ЕРИР. нет
alternative_inn Номер налогоплательщика либо его аналог в стране регистрации. Заполняется для иностранных физических и юридических лиц в соответствии с требованиями ЕРИР. нет
oksm_number Код страны регистрации юридического лица в соответствии с ОКСМ. Заполняется для иностранных юридических лиц в соответствии с требованиями ЕРИР. нет
Параметры ответа
Параметр Описание Обязат.
Bid Response object
id Идентификатор аукциона, полученный из RTB-хоста. да
cur
Валюта, в которой указана ставка – параметр Seatbid.Bid.price. Возможные варианты:
  • RUB — российский рубль;
  • USD — американский доллар;
  • EUR — евро;
  • CHF — швейцарский франк;
  • TRY — турецкая лира;
  • UAH — украинская гривна;
  • 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. нет
cid Идентификатор рекламной кампании на стороне DSP. да
crid Идентификатор рекламного блока на HTML-странице, полученный из ORTB-хоста. нет
nurl URL, вызываемый при победе в аукционе. нет
burl URL, вызываемый в момент списания средств за платное событие. нет
adm

HTML-код креатива, предназначенный непосредственно для встраивания на страницу. Может содержать макросы, которые будут заменены при отрисовке креатива.

 нет
w Ширина блока в пикселях. да
h Высота блока в пикселях. да
ext Объект с дополнительными параметрами. нет
Bid.ext object
nroa Родительский объект для расширения нет
nroa object
erid ЕРИД нет
has_nroa_markup Включает ли креатив маркировку согласно законодательству. Возможные значения: 0 или 1. нет
client Информация о заказчике по изначальному договору. нет
Client object
inn ИНН физического или юридического лица. нет
legal_form Тип организации из списка «Список типов организации». нет
name ОПФ и юридическое наименование. нет
name ОПФ и юридическое наименование. нет
mobile_phone Номер телефона. Заполняется для иностранных физических и юридических лиц в соответствии с требованиями ЕРИР. нет
epay_number Номер банковского счета, номер электронного кошелька или подобные номера, за исключением номера банковской карты. нет
reg_number Регистрационный номер либо его аналог. Заполняется для иностранных физических и юридических лиц в соответствии с требованиями ЕРИР. нет
alternative_inn Номер налогоплательщика либо его аналог в стране регистрации. Заполняется для иностранных физических и юридических лиц в соответствии с требованиями ЕРИР. нет
oksm_number Код страны регистрации юридического лица в соответствии с ОКСМ. Заполняется для иностранных юридических лиц в соответствии с требованиями ЕРИР. нет

Пример ответа

{
  "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": "",
          "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": "<iframe id='659fa948' name='659fa948' src='http://dsp.site.ru/delivery/r/afr.php?did=5ed134b186ca98265293b16c82a7d400&z=${AUCTION_PRICE}&u=%7CkfLBF84WGYk8GZaTnlZApLIxNAXnhxO2e5dFwhlHm2Q%3D%7C&c1=pHOA86cDdpKTosiVYbtIXOR9N0v5mNdEGl8j8F6oCQy-14RbOZ40izPRWJiZCfaajt-CCD-Aess2l_fYRVoTqxcurWGNXEf5K2mNqaz-SJ-21tGUu8jK0Zak4HBs6fdKMxzvO1i7AuvFc4JUhosN3MuGpn6nFTg07hAYBotknCi3wLzo4zb9_u99oTq750u4C2Al809A98-K4vvnvjh1q3n2RJXEtnymIBX_0tUj07SmVQV9igSM3RBxUukocP4I-bwThQUKzrxtOUWDY8drq5z-cY4X2YPpxiKwNrtdNeBnwo2rftdjif4YFm4vHaNCzB_3ryOVrDE-3EblUJRCtuJv9RYlWVMfCoYzsgXY6ozASo0Amvmj0AD2_6IYWaJqQDSX18ZPwdmmyEWmnWZltfZqzK7MggRULjr5_JR_n8i5cqKFvoTsqKKqWgAseP34' framespacing='0' frameborder='no' scrolling='no' width='300' height='600'></iframe>",
          "w": 300,
          "h": 600,
          "ext": {
            "nroa": {
              "erid":"efr23i",
              "has_nroa_markup":0,
              "client":{
                "inn":"71445203",
                "name":"ООО Неваляшка",
                "legal_form":"ul"
              }
            }
          }
        }
      ]
    }
  ]
}
Скопировано