--- metadata: - name: generator content: Diplodoc Platform v5.50.3 alternate: - https://yandex.ru/dev/rtb/doc/en/api/mobile/response.md - https://yandex.ru/dev/rtb/doc/ru/api/mobile/response.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/rtb/doc/ru/llms.txt # Мобильная реклама. Ответ DSP Заявка на участие в аукционе передается методом POST в формате json (Content-Type: application/json). ## Тело ответа В теле ответа содержится объект `Bid Response`, показанный ниже. {% note alert %} Пиксели статистики должны поддерживать HTTPS. {% endnote %} ```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)" } }, "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 или GooglePlay. | нет || || payload | JSON, полученный от DSP. Максимум 1024 символа. Может быть передан в [Bid Loss Notification](https://yandex.ru/dev/rtb/doc/ru/api/bid-loss-notification.md). | нет || || cid | Идентификатор рекламной кампании на стороне DSP. | да || || crid | Идентификатор рекламного блока на HTML-странице, полученный из ORTB-хоста. | нет || || nurl | URL, вызываемый при победе в аукционе. | нет || || burl | URL, вызываемый в момент списания средств за платное событие. | нет || || attr | В баннерной рекламе: набор параметров креатива. В нативной рекламе: набор параметров ассета. | нет || || adm | В баннерной рекламе: HTML-код креатива, предназначенный непосредственно для встраивания на страницу. Может содержать [макросы](https://yandex.ru/dev/rtb/doc/ru/api/macros.md), которые будут заменены при отрисовке креатива. В нативной рекламе: содержит закодированную строку с объектом `Seatbid.Bid.Adm.Native`. См. [описание объекта](#adm-native-desc) и [пример ответа](#native-example). В видеорекламе: XML-код, предназначенный для встраивания в плеер. Может содержать [макросы](https://yandex.ru/dev/rtb/doc/ru/api/macros.md), которые будут заменены при отрисовке креатива. Содержит объект в формате VAST. | нет || || w | Ширина блока в пикселях. | да || || h | Высота блока в пикселях. | да || || ext | Объект с дополнительными параметрами. | нет || || lurl | URL, вызываемый в случае проигрыша в аукционе. | нет || || cat | Категории контента IAB для креатива. | нет || || iurl | Ссылка на изображение из контента кампании для проверки качества и безопасности рекламы. | нет || || protocol | Поддерживаемый видео протокол. | нет || |# ### Seatbid.Bid.Adm.Native object {#adm-native-desc} #| || **Параметр** | **Описание** | **Обязательность** || || 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 | Информация о заказчике по изначальному договору. | нет || || initial_contract | Информация об изначальном договоре. | нет || || contractor | Информация об исполнителе по изначальному договору. | нет || || parent_contracts | Список «родительских» договоров. Если изначальный договор клиента имеет тип «дополнительное соглашение», необходимо передать информацию о соответствующем исходном договоре | Обязателен для дополнительных соглашений || |# ### 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. | нет || || ext.ask | ID сценария для AutoStoreKit. | нет || |# ### fidelities object #| || **Параметр** | **Описание** | **Обязательность** || || fidelity | Точность воспроизведения. | нет || || nonce | Идентификатор, уникальный для каждого Bid Response. Требования к формату [UUID](https://developer.apple.com/documentation/storekit/skstoreproductparameteradnetworknonce) приведены в документации Apple. | нет || || signature | Подпись SKAdNetwork, соответствующая спецификации Apple. | нет || || timestamp | Unix-время в миллисекундах на момент создания подписи. | нет || |# ## Параметры ассетов для нативной рекламы {#asset-attributes} #| || **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  || |# ## Пример ответа — баннерная реклама {#banner-example} ```json { "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": "", "w": 300, "h": 300, "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" } } ] } ] } ``` ## Пример ответа — нативная реклама {#native-example} ```json { "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" } } ] } ] } ``` ## Пример ответа — видеореклама {#video-example} ```json { "bidid": "9218750a64d68fb3ae3b8d5d849c9d63", "cur": "RUB", "id": "2071435468055052649", "seatbid": [ { "bid": [ { "adid": "6256ab117bc72f01b40e8af5", "adm": "dspname00:00:13", "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" } }, "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" } } ] } ] } ``` ## Пример атрибута для маркировки рекламы — видеореклама {#video-attr-example} Добавляется в XML-код из поля `seatbid.bid.adm`: ```json ... https://example.com/... ```