Ответ 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)",
          "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)"
              }
            }
          }
        }
      ]
    }
  ]
}
Скопировано
Параметры ответа
Параметр Описание Обязат.
Bid Response object
id Идентификатор аукциона, полученный из RTB-хоста. да
cur
Валюта, в которой указана ставка – параметр Seatbid.Bid.price. Возможные варианты:
  • RUB — российский рубль;
  • USD — американский доллар;
  • EUR — евро;
  • CHF — швейцарский франк;
  • TRY — турецкая лира;
  • UAH — украинская гривна;
  • KZT — казахстанский тенге.
 да
seatbid Массив объектов Seatbid. Содержит ставки за показ. да
Seatbid object
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

XML-код, предназначенный для встраивания в плеер. Может содержать макросы, которые будут заменены при отрисовке креатива. Содержит объект в формате VAST.

 нет
cat Категории контента IAB для креатива. нет
iurl Ссылка на изображение из контента кампании для проверки качества и безопасности рекламы. нет
protocol Поддерживаемый видео протокол. нет
ext Объект с дополнительными параметрами. нет
Bid.ext object
nroa Родительский объект для расширения нет
nroa object
erid ЕРИД нет
has_nroa_markup Включает ли креатив маркировку согласно законодательству. Возможные значения: 0 или 1. нет
contractor Информация об исполнителе по изначальному договору. нет
client Информация о заказчике по изначальному договору. нет
initial_contract Информация об изначальном договоре. нет
parent_contracts Список «родительских» договоров. Если изначальный договор клиента имеет тип «дополнительное соглашение», необходимо передать информацию о соответствующем исходном договоре. Обязателен для дополнительных соглашений
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
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

XML-код, предназначенный для встраивания в плеер. Может содержать макросы, которые будут заменены при отрисовке креатива. Содержит объект в формате VAST.

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

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

{
  "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"
              }
            }
          }
        }
      ]
    }
  ]
}
Скопировано

Пример атрибута для маркировки рекламы.

Добавляется в XML-код из поля seatbid.bid.adm:


<Ad>
    ...
    <InLine>
        <Extensions>
            <Extension type="nroa_inform">
                <Url>https://example.com/...</Url>
            </Extension>
        </Extensions>
    </InLine>
</Ad>