Ответ DSP

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

{
  "id": "(string)",
  "cur": "(string)",
  "seatbid": [
    {
      "seat": "(string)",
      "bid": [
        {
          "impid": "(string)",
          "id": "(string)",
          "price": "(float)",
          "adid": "(string)",
          "adomain": [
            "(array of strings)"
          ],
          "bundle": "(string)",
          "payload": "(string)",
          "cid": "(string)",
          "crid": "(string)",
          "lurl": "(string)",
          "nurl": "(string)",
          "burl": "(string)",
          "attr": [
            "(array of strings)"
          ],
          "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. Допустимо только одно значение в массиве.	да
`bundle`	Идентфикатор приложения в AppStore или GooglePlay.	нет
`payload`	JSON, полученный от DSP. Максимум 1024 символа. Может быть передан в Bid Loss Notification.	нет
`cid`	Идентификатор рекламной кампании на стороне DSP.	да
`crid`	Идентификатор рекламного блока на HTML-странице, полученный из ORTB-хоста.	нет
`lurl`	URL, вызываемый в случае проигрыша в аукционе.	нет
`nurl`	URL, вызываемый при победе в аукционе.	нет
`burl`	URL, вызываемый в момент списания средств за платное событие.	нет
`attr`	Набор параметров креатива.	нет
`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. Допустимо только одно значение в массиве.	да
`bundle`	Идентфикатор приложения в AppStore или GooglePlay.	нет
`payload`	JSON, полученный от DSP. Максимум 1024 символа. Может быть передан в Bid Loss Notification.	нет
`cid`	Идентификатор рекламной кампании на стороне DSP.	да
`crid`	Идентификатор рекламного блока на HTML-странице, полученный из ORTB-хоста.	нет
`lurl`	URL, вызываемый в случае проигрыша в аукционе.	нет
`nurl`	URL, вызываемый при победе в аукционе.	нет
`burl`	URL, вызываемый в момент списания средств за платное событие.	нет
`attr`	Набор параметров креатива.	нет
`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": "5834842956793170835",
  "cur": "RUB",
  "units": 1,
  "seatbid": [
    {
      "seat": "dsp-partner-global",
      "bid": [
        {
          "impid": "10",
          "id": "615b146ecf3275146cde449d4b3eb400",
          "traceid": "615b146ecf3275146cde449d4b3eb400",
          "price": 4.82,
          "adid": "36124_",
          "adomain": [
            "farfetch.com"
          ],
          "bundle": "906698760",
          "payload": "S-W20CMRLJqbBxuJp5nDf4scTFpFmUejZDcxNc_lEAhP4FBLi1-DOr4b2WIPPnVLEEU8ecbxIyGuMqyAAZMCnEmGz970qCCZb87fFc6CpFdG5wXVjGcymKgImpgfNYUS-f0A9uSSvk1GYWt_Ya_2_DoVlnp26CI5_hTBEvKqRHb6jNhkK_N9N0GaoC9u-nSW998Yq7HbnsrrhcdHXcyuBGqAUlIE52NQT-UR_I12QFvJ7_CPrjyZiiYgmjeosnSy0dlBV7cL5cysMHlNKiNZB77GcfZaQamE7c4DdbdDf_9FQXZeujvbua5EXdkK0Nsh2lamig04JOnrBpILg-NJepHavjIHAhw3YhCKnWyTDygmXKWv3MVse3VyvuUarLOeDqhUSyAN3aX5Xqo2SzE9V1088glfO3e7RtH5Dugv-pQc0Wvkqq1dkg",
          "cid": "185338",
          "crid": "36124_",
          "lurl": "http://rtb.nl.eu.dsp-partner.com/yandexortb/auction/notify?profile=270&imp=S-W20CMRLJqbBxuJp5nDf4scTFpFmUejZDcxNc_lEAhP4FBLi1-DOr4b2WIPPnVLEEU8ecbxIyGuMqyAAZMCnEmGz970qCCZb87fFc6CpFdG5wXVjGcymKgImpgfNYUS-f0A9uSSvk1GYWt_Ya_2_DoVlnp26CI5_hTBEvKqRHb6jNhkK_N9N0GaoC9u-nSW998Yq7HbnsrrhcdHXcyuBGqAUlIE52NQT-UR_I12QFvJ7_CPrjyZiiYgmjeosnSy0dlBV7cL5cysMHlNKiNZB77GcfZaQamE7c4DdbdDf_9FQXZeujvbua5EXdkK0Nsh2lamig04JOnrBpILg-NJepHavjIHAhw3YhCKnWyTDygmXKWv3MVse3VyvuUarLOeDqhUSyAN3aX5Xqo2SzE9V1088glfO3e7RtH5Dugv-pQc0Wvkqq1dkg&st=${AUCTION_LOSS}",
          "nurl": "http://rtb.nl.eu.dsp-partner.com/yandexortb/auction/notify?profile=270&imp=W1g6Zz8k8fjYsF8C2ymvB1GoWyc3csS1z9KYruC7_YZH5gP5mTxeH2ufjxoAIqCgBs7ZQS4ALh2rXGarcrrm6OAALRdhsCRx5QBiN99rLMqXkTBrG3KwOOHalRN0NSoJkJwXOANLLnpwWNkoWzD41vy_HmJvOBdWbo0VExtzMSteNYmOf8D4YIUhUbgQhpS3xArd593WM5a8ls3Qwxa60hHzETu4zx12dzzujI1QQOpyyQph4KrXb_PUBCcgUlE4Kept1fPqQ0f9zibVv5GudzFdw70UUMW3B3O5HQSIhlQuB5uIUYdnjoXIORzKBP1YQSIxGGA-uFY_1igRWXEkgRpgG_IBOFmBHxA9SkMR9P-k3Ta0-MWzpONYDBXARmA9a6eW-xWVJchKlWk2eDNWMvMoa43xEtIUM05jKX5sU6OUsZQNtg78Ww",
          "burl": "https://rtb.nl.eu.dsp-partner.com/yandexortb/auction/notify?profile=270&imp=yYeYv3VyrghjGRIW8gfr_a-PhH6wlEbGFj31O6wZJkxwzp7pa32MVoEsUqGI5nBbOm7ClCNF5yDLshDuDt2cF_sSZY3LCxizheTizCFYgf3eL_AJ397DdkrA3qq9QrPRJH4boFyVDJVGGfQ26vfKfDDMMUxkuW2fHKOyo2toeBkO7CjveZB7iB9P4IgMlnSO6psgLG8KUKtk8HIQHeNFdKG5SBMvm1vhZ2Y4nGBqyXbHYDCWfFjF0qImeCEKrL2pvWM3VXojYU5CuS-svs3h3vLnghHCOWhST0Cn3mnmM_5aLjfsJ0C_T0gNX6QCf7N4LPfxIcFQtBiZsJ13w0aocjVw83KAWcPUSlVfwRZm-Lixe0LDtkdU_Ujo4_GaAM3vPME5XSCahRpLjjFQon9ypdwlXUXMXDmZg-Uo8zbnxA6A2GWLdkBbtw",
          "attr": [],
          "adm": "<script type='text/javascript' src='https://ads.eu.dsp-partner.com/delivery/r/ajs.php?z=${ENCRYPTED_AUCTION_PRICE}&u=%7CNhP%2FXoi4ZnaLsZN7OVBxJg52BL54hbgJDBTW%2FMWhcNA%3D%7C&c1=jWCgqsKSUoVnhbPUYduT0I_a4gxRTN4fFxJSFPxaOqcrqhLC6ZrfdcTmceDoB2R-RVV94C5ubnLKAl6vJozak3kdPx-fkSv1NWZyq-NV2ST5u8rCmF9b4MovSZUjDmDfsX7I73brvdDU8QQ95EtuWUcIm-oPBYKmuDbDsFlXwvpmNUpZQ24dbE4EWPPg2Y8d0YgWaJMrOKIpJVAWgFVfGa36EoTvWxEO9cpnlETWOZEhyOQ7-InwHAa1Dyk9wt9_nf5kq2HLKbiTt3xO5WKYiDPm4Yu-f0YYmgnGVE2Jmg7y9zxU4sLLIT6KHK6Jnel0s55ws5QO7mI0-x4b9WSa1r7vTUZTUio_q12HjAdAJEUwmk0ZmekNQc86DOkMD2612hbPWpetlD_mukWzStOOpBaF2BmieuSzm8AOH7pvsSZezWofNUic4B-oo2TrcX3UziCaN0eGWzM5_g3YbInP4uZm7jemvHYPEEFqhclqws8yKQHGPJTQrIay7enGz7Rl'></script>",
          "w": 300,
          "h": 300,
          "ext": {
            "nroa": {
              "erid":"efr23i",
              "has_nroa_markup":0,
              "client":{
                "inn":"71445203",
                "name":"ООО Неваляшка",
                "legal_form":"ul"
              }
            }
          }
        }
      ]
    }
  ]
}
Скопировано