Ответ DSP

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

Тело ответа

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

Внимание

Пиксели статистики и ссылки на контент (изображения) должны поддерживать HTTPS.

{
  "bidid": "(string)",
  "cur": "(string)",
  "id": "(string)",
  "seatbid": [
    {
      "bid": [
        {
          "adid": "(string)",
          "adm": "{\"native\":{\"ver\":\"(string)\",\"link\":{\"url\":\"(string)\"},\"assets\":[{\"id\":(int),\"title\":{\"text\":\"(string)\"}},{\"id\":int,\"img\":{\"url\":\"(string)\",\"w\":int,\"h\":int}},{\"id\":int,\"data\":{\"value\":\"(string)\"}},{\"id\":int,\"data\":{\"value\":\"(string)\"}},{\"id\":int,\"data\":{\"value\":\"(string)\"}},{\"id\":int,\"img\":{\"url\":\"(string)\",\"w\":int,\"h\":int}}],\"eventtrackers\":[{\"event\":int,\"method\":int,\"url\":\"(string)\"},{\"event\":int,\"method\":int,\"url\":\"(string)\"}]}}",
          "adomain": [
              "(array of string)"
          ],
          "bundle": "(string)",
          "cat": [
              "(string)"
          ],
          "cid": "(string)",
          "crid": "(string)",
          "id": "(string)",
          "impid": "(string)",
          "iurl": "(string)",
          "price": "(float)",
          "ext": {
            "nroa": {
              "erid":"(string)",
              "has_nroa_markup":"(int)",
              "client":{
                  "inn":"(string)",
                  "name":"(string)",
                  "legal_form":"(string)"
              }
            },
            "skadn": {
              "campaign": "(string)",
              "fidelities": [
                {
                  "fidelity": "(int)",
                  "nonce": "(string)",
                  "signature": "(string)",
                  "timestamp": "(string)"
                }
              ],
              "itunesitem": "(string)",
              "network": "(string)",
              "sourceapp": "(string)",
              "version": "(string)"
            },
            "storeurl": "(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. Допустимо только одно значение в массиве.

да

bundle

Идентфикатор приложения в AppStore или Google Play.

нет

payload

JSON, полученный от DSP. Максимум 1024 символа. Может быть передан в Bid Loss Notification.

нет

cid

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

да

crid

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

нет

nurl

URL, вызываемый при победе в аукционе.

нет

attr

Набор параметров ассета.

нет

burl

URL, вызываемый в момент списания средств за платное событие.

нет

adm

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

нет

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

Родительский объект для расширения

нет

skadn

Родительский объект для SKAdNetwork.

нет

storeurl

Начальный url-адрес App Store для приложения, к которому будет осуществлен переход.

нет

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

Код страны регистрации юридического лица в соответствии с ОКСМ. Заполняется для иностранных юридических лиц в соответствии с требованиями ЕРИР.

нет

skadn object

campaign

Идентификатор кампании, соответствующий спецификации Apple. Начиная с версии 2.0, представляет собой целое число от 1 до 100, в формате строки.

нет

fidelities

Список поддерживаемых типов fidelity, представленных в SKAdNetwork v2.2.

нет

itunesitem

Идентификатор приложения рекламодателя в Apple App Store. Должен совпадать с Bid.bundle в ответе Bid Response.

нет

network

Идентификатор рекламной сети, используемый в подписи. Должен совпадать с одним из элементов массива skadnetids в запросе.

нет

sourceapp

Идентификатор приложения-издателя в Apple App Store. Должен совпадать с Imp.Ext.Skadn.Sourceapp в запросе на участие в торгах.

нет

version

Версия SKAdNetwork.

нет

fidelities object

fidelity

Точность воспроизведения.

нет

nonce

Идентификатор, уникальный для каждого Bid Response. Требования к формату UUID приведены в документации Apple.

нет

signature

Подпись SKAdNetwork, соответствующая спецификации Apple.

нет

timestamp

Unix-время в миллисекундах на момент создания подписи.

нет

Параметры ассетов

ID ассета

Название ассета

Описание

Тип данных

Тип ассета

Ограничение

1

Title

Заголовок с описанием, связанным с рекламируемым продуктом или услугой

String

Обязательный

до 140 символов

2

Main image

Основной баннер для отображения

Img

Обязательный

минимум 150х150

5

Description

Дополнительный текст, связанный с рекламируемым продуктом или услугой

String

Рекомендованный

до 140 символов

9

display_url

Отображаемый домен или бандл на который будет осуществлен переход.

String

Рекомендованный

до 50 символов

10

CTA

Призыв к действию, который размещается на кликабельной кнопке

String

Рекомендованный

до 15 символов

11

Icon

Дополнительная иконка (фавикон) для рекламы мобильных приложений. Часто соответствует иконке из магазина приложений.

Img

Рекомендованный

минимум 50х50

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

{
  "bidid": "353776",
  "cur": "USD",
  "id": "4413312110307915961",
  "seatbid": [
    {
      "bid": [
        {
          "adid": "native_123",
          "adm": "{\"native\":{\"ver\":\"1.2\",\"link\":{\"url\":\"https://app.name.com/somepath\"},\"assets\":[{\"id\":1,\"title\":{\"text\":\"Покупай только у нас!\"}},{\"id\":2,\"img\":{\"url\":\"https://content.com/somepath.png\",\"w\":150,\"h\":150}},{\"id\":5,\"data\":{\"value\":\"Скидка 450 ₽ на первый заказ от 1 500 ₽ по промо «PROMO»\"}},{\"id\":9,\"data\":{\"value\":\"play.google.com\"}},{\"id\":10,\"data\":{\"value\":\"Установить\"}},{\"id\":11,\"img\":{\"url\":\"https://content.com/somepath/icon.png\",\"w\":50,\"h\":50}}],\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://dspname.com/imp/somepath\"},{\"event\":1,\"method\":1,\"url\":\"https://impression.appsflyer.com/somepath\"}]}}",
          "adomain": [
              "sbermarket.ru"
          ],
          "bundle": "ru.instamart",
          "cat": [
              "IAB8"
          ],
          "cid": "native_1",
          "crid": "native_123",
          "id": "353776",
          "impid": "178",
          "iurl": "https://content.com/somepath.png",
          "price": 0.27445,
          "ext": {
            "nroa": {
              "erid":"efr23i",
              "has_nroa_markup":0,
              "client":{
                  "inn":"71445203",
                  "name":"ООО Неваляшка",
                  "legal_form":"ul"
              }
            },
            "skadn": {
              "campaign": "11",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "f9f8be1b-a396-4ff6-95e5-b50508caa18",
                  "signature": "MDUCGQD4bhRqyMk2lcz3/mi0943580485038Owgcz9tcS8acHhxMxqJ0K6P968spxQ==",
                  "timestamp": "1730704281000"
                },
                {
                  "fidelity": 1,
                  "nonce": "a5914e5b-4f06-4278-bc39-d0550678ff72",
                  "signature": "MDUCGH9mfWRIErBnitWx2/Vsx809485034858340VSXgsVCh2BHUXXvq54XcT/2qyaBYkw==",
                  "timestamp": "1730704280000"
                }
              ],
              "itunesitem": "911804296",
              "network": "w9q455wk68.skadnetwork",
              "sourceapp": "6471572249",
              "version": "3.0"
            },
            "storeurl": "https://apps.apple.com/app/id1579364157"
          }
        }
      ]
    }
  ]
}
Предыдущая
Запрос из OpenRTB-хоста
Следующая
Запрос из OpenRTB-хоста