Ответ 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)",
          "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.

нет

cid

Идентификатор рекламной кампании на стороне DSP.

да

crid

Идентификатор рекламного блока на HTML-странице, полученный из ORTB-хоста.

нет

lurl

URL, вызываемый в случае проигрыша в аукционе.

нет

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

ОПФ и юридическое наименование.

нет

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": "",
          "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": "<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"
              }
            }
          }
        }
      ]
    }
  ]
}