Ответ 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)"
          ],
          "bundle": "(string)",
          "payload": "(string)",
          "cid": "(string)",
          "crid": "(string)",
          "lurl": "(string)",
          "nurl": "(string)",
          "burl": "(string)",
          "adm": "{\"native\": { \"ver\": (string), \"assets\": [{\"id\": (int),\"required\": (int),\"title\": { \"text\": (string)}},{\"id\": (int),\"required\": (int),\"img\": { \"url\": (string), \"w\": (int), \"h\": (int)}},{\"id\": (int),\"required\": (int),\"data\": { \"value\": (float)}} ], \"eventtrackers\": [{\"event\": (int),\"method\": (int),\"url\": (string)} ], \"link\": {\"url\": (string) }, \"privacy\": (string), \"ext\": {\"privacy\": {\"imageurl\": (string),\"clickurl\": (string)}}}}}]}]}",
          "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-хоста. нет
lurl URL, вызываемый в случае проигрыша в аукционе. нет
nurl URL, вызываемый при победе в аукционе. нет
burl URL, вызываемый в момент списания средств за платное событие. нет
attr Набор параметров ассета. нет
adm

Содержит закодированную строку с объектом Seatbid.Bid.Adm.Native. См. пример ответа.

 нет
native Объект Seatbid.Bid.Adm.Native с параметрами нативного баннера. нет
w Ширина блока в пикселях. да
h Высота блока в пикселях. да
ext Объект с дополнительными параметрами. нет
Seatbid.Bid.Adm.Native object
ver Версия Native Markup. нет
assets Объект Seatbid.Bid.Adm.Native.Assets с параметрами ассетов. нет
eventtrackers Объект Seatbid.Bid.Adm.Native.Eventtrackers с параметрами отслеживания событий. нет
link Объект Seatbid.Bid.Adm.Native.Link с ссылкой в объявлении. да
privacy

Условия конфиденциальности.

  • 1 — нативная реклама содержит уведомление о конфиденциальности для пользователя;
  • 0 — нет уведомлений о конфиденциальности.
 нет
ext Объект Seatbid.Bid.Adm.Native.Ext с дополнительными параметрами. нет
Seatbid.Bid.Adm.Native.Assets object
id Идентификатор ассета. да
required

Флаг, указывающий на обязательность ассета.

  • 1 — обязательный ассет;
  • 0 - необязательный ассет.
 нет
title Объект Seatbid.Bid.Adm.Native.Assets.Title с параметрами заголовка ассета. да
img Объект Seatbid.Bid.Adm.Native.Assets.Img с параметрами изображения в ассете. нет
data Объект Seatbid.Bid.Adm.Native.Assets.Data с параметрами содержимого ассете. нет
Seatbid.Bid.Adm.Native.Assets.Title object
text Текст заголовка объявления. да
Seatbid.Bid.Adm.Native.Assets.Img object
w Ширина изображения. нет
url Ссылка на изображение. да
h Высота изображения. нет
Seatbid.Bid.Adm.Native.Assets.Data object
value Текст в объявлении. да
Seatbid.Bid.Adm.Native.Link object
url Ссылка в объявлении. да
Seatbid.Bid.Adm.Native.Eventtrackers object
event Отслеживаемое событие. да
method Способ отслеживания событий. да
url Ссылка на событие. нет
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-хоста. нет
lurl URL, вызываемый в случае проигрыша в аукционе. нет
nurl URL, вызываемый при победе в аукционе. нет
burl URL, вызываемый в момент списания средств за платное событие. нет
attr Набор параметров ассета. нет
adm

Содержит закодированную строку с объектом Seatbid.Bid.Adm.Native. См. пример ответа.

 нет
native Объект Seatbid.Bid.Adm.Native с параметрами нативного баннера. нет
w Ширина блока в пикселях. да
h Высота блока в пикселях. да
ext Объект с дополнительными параметрами. нет
Seatbid.Bid.Adm.Native object
ver Версия Native Markup. нет
assets Объект Seatbid.Bid.Adm.Native.Assets с параметрами ассетов. нет
eventtrackers Объект Seatbid.Bid.Adm.Native.Eventtrackers с параметрами отслеживания событий. нет
link Объект Seatbid.Bid.Adm.Native.Link с ссылкой в объявлении. да
privacy

Условия конфиденциальности.

  • 1 — нативная реклама содержит уведомление о конфиденциальности для пользователя;
  • 0 — нет уведомлений о конфиденциальности.
 нет
ext Объект Seatbid.Bid.Adm.Native.Ext с дополнительными параметрами. нет
Seatbid.Bid.Adm.Native.Assets object
id Идентификатор ассета. да
required

Флаг, указывающий на обязательность ассета.

  • 1 — обязательный ассет;
  • 0 - необязательный ассет.
 нет
title Объект Seatbid.Bid.Adm.Native.Assets.Title с параметрами заголовка ассета. да
img Объект Seatbid.Bid.Adm.Native.Assets.Img с параметрами изображения в ассете. нет
data Объект Seatbid.Bid.Adm.Native.Assets.Data с параметрами содержимого ассете. нет
Seatbid.Bid.Adm.Native.Assets.Title object
text Текст заголовка объявления. да
Seatbid.Bid.Adm.Native.Assets.Img object
w Ширина изображения. нет
url Ссылка на изображение. да
h Высота изображения. нет
Seatbid.Bid.Adm.Native.Assets.Data object
value Текст в объявлении. да
Seatbid.Bid.Adm.Native.Link object
url Ссылка в объявлении. да
Seatbid.Bid.Adm.Native.Eventtrackers object
event Отслеживаемое событие. да
method Способ отслеживания событий. да
url Ссылка на событие. нет
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": "1545692916559180241",
  "bidid": "6beac02b-af24-11ec-a3ac-4f447779ff3d",
  "cur": "USD",
  "seatbid": [
    {
      "seat": "acc-25504",
      "bid": [
        {
          "id": "6beac02b-af24-11ec-a3ac-f45f1fae223d",
          "impid": "4",
          "price": 0.011136,
          "nurl": "https://gwbudgetali.iymedia.me/budget.php?1=1&appName=outbrain&adx=yandex&requestId=1545692916559180241&impId=4&bidId=6beac02b-af24-11ec-a3ac-f45f1fae223d&bidType=bid&publisherId=16617488&region=eu-central-1&host=ali-fra109-gatewaydocker-135-248&bidUtcTime=1648533150588&bidPrice=0.01225&gwBidPrice=0.011136&resellerPrice=0.01127&commissionRate=0.1&tagid=295403-4&ifa=&reqip=46.223.41.0&bundle=ru.swc.yaplakal&cheatingScore=0&finalAppId=380&adomain=nation.com&country=DEU&exchange=&impType=native&os=android&osv=11&chargeType=burl&auctionPrice=${AUCTION_PRICE}&encoding=urlencoding",
          "burl": "https://gwbudgetali.iymedia.me/burl.php?1=1&appName=outbrain&adx=yandex&requestId=1545692916559180241&impId=4&bidId=6beac02b-af24-11ec-a3ac-f45f1fae223d&bidType=bid&publisherId=16617488&region=eu-central-1&host=ali-fra109-gatewaydocker-135-248&bidUtcTime=1648533150588&bidPrice=0.01225&gwBidPrice=0.011136&resellerPrice=0.01127&commissionRate=0.1&tagid=295403-4&ifa=&reqip=46.223.41.0&bundle=ru.swc.yaplakal&cheatingScore=0&finalAppId=380&adomain=nation.com&country=DEU&exchange=&impType=native&os=android&osv=11&chargeType=burl&finalAppId=380&auctionPrice=${AUCTION_PRICE}&encoding=urlencoding&burl=aHR0cDovL2IxLWV1ZGMxLnplbWFudGEuY29tL2JpZGRlci93aW4veWVhaG1vYmkvNmJlYWMwMmItYWYyNC0xMWVjLWEzYWMtZjQ1ZjFmYWUyMjNkLzAuMDExMjcvSVFSV09STEo0SFQ2TEFZM0RJWURFRU1VTU1QUVhKR00yVUJJVFNVM0lTQzJWVUtWUUhBWlRaNkg2V001NkxLTEZNNVkyWFZUSENXQUJSSUhLNkNCVzNaQjVQUE00TVpBTEVYTENMQTM0Q1pOQkhYTDJXSjc0WUVVUlJJQk1VNkxSVzZMQ0dLS1RKREpSQ0JSWFBBVlEzRUZQMldCN0lCVFlFMzZYWlpYNzNVNzRMTUZJVDdaT0ZVMkc1RkVZT0RQSVlaTzNGWExLUUtFRE5FTllFSDU3SUJCRlhBSkhWT1pKWFdVNlNBNVpBWUZZVE1ZSkI2REhXMk5TTkNYRlBQR00ySDdVMjNRTlc2M1FUNUhSS0JPQ0NNN1VTWVJIR09DRDJSQVhUWkhQNzRONkc2RkZQQ1oySE1IRzJNNkhKNEFUWkZGU1JNSUJCVkw3SjIzUEFLUlJYR05WVllXQ1NWT0hVMkRENkFMM0RCTzVUQUVXV0VLVzRXQldPN1kyTUhIU05JRVFQV0ZCRkJORVhKMjJXUlgySEU2UFhJRlNFWUtDWU1URlRENU9TV1MzWk9XVkxQMzJHNDRMREQ0T0NCTlA2U09XNUE2NkJXU08vPw==",
          "lurl": "https://gwbudgetali.iymedia.me/lostwin.php?1=1&appName=outbrain&adx=yandex&requestId=1545692916559180241&impId=4&bidId=6beac02b-af24-11ec-a3ac-f45f1fae223d&bidType=bid&region=eu-central-1&host=ali-fra109-gatewaydocker-135-248&bidUtcTime=1648533150588&bidfloor=0.0001067094&bidPrice=0.01225&gwBidPrice=0.011136&resellerPrice=0.01127&commissionRate=0.1&tagid=295403-4&ifa=&reqip=46.223.41.0&bundle=ru.swc.yaplakal&cheatingScore=0&finalAppId=380&adomain=nation.com&lossReason=${AUCTION_LOSS}",
          "adomain": [
            "nation.com"
          ],
          "cid": "15875358",
          "crid": "65839095",
          "cat": [
            "IAB5-2"
          ],
          "adm": "{\"native\":{\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"text\":\"Interested in studying Psychology?\"}},{\"id\":2,\"required\":1,\"img\":{\"url\":\"https://zem.outbrainimg.com/p/srv/sha/06/b9/16/6988145239d55e2001fa397a72b83e375c.jpg?w=150\\u0026h=150\\u0026fit=crop\\u0026crop=CENTER\\u0026fm=jpg\",\"w\":150,\"h\":150}},{\"id\":4,\"required\":1,\"data\":{\"value\":\"Nation\"}},{\"id\":5,\"data\":{\"value\":\"Search for the psychology courses suited for your educational goals.\"}},{\"id\":9,\"data\":{\"value\":\"nation.com\"}},{\"id\":10,\"data\":{\"value\":\"Learn More\"}},{\"id\":11,\"img\":{\"url\":\"https://zem.outbrainimg.com/p/srv/sha/2a/81/1c/17cd665a58694172709099b508945f5068.jpg?w=50\\u0026h=50\\u0026fit=crop\\u0026crop=center\\u0026fm=jpg\",\"w\":50,\"h\":50}}],\"link\":{\"url\":\"https://r1-euc1.zemanta.com/rp2/b1_yeahmobi/15875358/65839095/UTBHQ7NL473YAIMQZUY2HAM2NS55RCKI3SHMTAJWU2NQXBDZ2GKB7TBEDUMDVOGD3JGWBCN4AHLUTFSKXUY3CT7YI4257BBJSQZXBSSK5DA7S26TQD7V36U7EK4IEC2OMI4JTFMZ5BCIXGQRA3RVLH5OKHF2JTS3GFQEQK77WJV5RJ3OK7GJSVWUUOVFHOVW5ULLJOUAB6IULIY2I5RWDBTTSHSVXDIZKXDKJC5E3VVNR5QDM5JX67EWF7HQ5NPGEVHUXO5HAIRYIYSNKFGTTHG7MW4ZSGJAEE2OSX37G7XBNJR5O5CHEDCTVE3T3TEKMKAEHAVG6RFHNVZDPJPRFLNLKXP6X2V74XSZ664JOWKI3PKKWNX3R2VAPUEBGKHGQY7EXN5IQ64OQ55WMDPC3NLGBHP3JQ7DT6ZYJ2AYFGINNRKF7X7NDKUNEGEKF4LQPWAGYIC6MC3Q6FFETQNUVZ74L7DG3NHATZLEHA6KENTROBOEZFSPOVRRFEM5MILACQCTNJYWUW45AHCZIRWM2BR2V5WVJ7EGFEMP3ZXDPSPRPDFGVPJQALAKKAKTXVSIR3AXKTOJSEYKHLP3WJQMREZREGEVCG56GI5QKQMAW6CACX7HABGS525W4DJICNZDA2T6EEP4RVTBAVNTJ7NSFHL3HMDYEVSFG37Q7GD5ACL2L6YFX7WQMOTKU2NUZRHUK6XAWLTL3GT3BK2AAP2TCCR4SG3BSRN3G62F5RYUCKY7BUXGV76D2WI5D74OM2YNVVAWMOHUG5KH4/\",\"clicktrackers\":[\"https://gwbudgetali.iymedia.me/click.php?1=1\\u0026appName=outbrain\\u0026adx=yandex\\u0026requestId=1545692916559180241\\u0026impId=4\\u0026bidId=6beac02b-af24-11ec-a3ac-f45f1fae223d\\u0026publisherId=16617488\\u0026region=eu-central-1\\u0026host=ali-fra109-gatewaydocker-135-248\\u0026bidUtcTime=1648533150588\\u0026country=DEU\\u0026impType=native\\u0026os=android\\u0026osv=11\\u0026tagid=295403-4\"]},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://b1t-eudc1.zemanta.com/t/imp/impression/Z4HKKGW326LPMAHHY4NG3JIYOKUJGVXQZQOODUEEK334TLJP3BTMA7P36Y6IOCFP6AYSYE32L2FGLKYJHI2A5R2ASBSR7KJ4GAMUEOZIZIZ22YBXI3JXHJUVUPLXJIS4W326L7LS33BXG3QCIIIUX3IZM2DKXAHERPO2VAVAIT2PYBK53RGFZTT3D7KQ5M5CK2O2I5FYYEQ7UAUNTIAGGNWPUPL6VBJPHRXHTQ6H65ISO2JDC6AWVTP35PHELMGMUZR7GDWBNBZZVRBMSXQOLCVO4XXOM3CNENGU4JWPF2OZOKRF7B7FI2VVPYR5BAMUTQW2MED4B2J4VYIOKQTISO6IJQDS7TR6RYLCBRY/?\"}]}}",
          "adid": "0000",
          "ext": {
            "nroa": {
              "erid":"efr23i",
              "has_nroa_markup":0,
              "client":{
                "inn":"71445203",
                "name":"ООО Неваляшка",
                "legal_form":"ul"
              }
            }
          }
        }
      ]
    }
  ]
}
Скопировано