> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/rtb/ru/izdateli/open-rtb/pub-open-rtb-2.4-request.md). # Запрос ставки Open RTB 2.4 На этой странице объясняется, как отправлять запросы на ставки ## Заголовки запроса ставки * **HTTP-заголовок версии OpenRTB**: `x-openrtb-version: 2.4` * **HTTP-заголовок Keep-Alive**: `Connection: Keep-Alive` * **JSON-содержимое**: `Content-Type: application/json` Следующие объекты следует отправлять, закодировав их как JSON в теле запроса: ## Запрос ставки | Атрибут | Обязательно? | Описание | | ---------- | ------------ | ------------------------------------------------------------------------------------------------ | | в | Да | Тип аукциона, первая цена = 1 (целое число) | | id | Да | Уникальный ID запроса ставки (строка) | | imp | Да | Массив объектов Imp, представляющих предлагаемые показы (объект). | | site | Да | Сведения об веб-сайте издателя через объект Site (объект). | | приложение | Да | Сведения об приложении издателя\* через объект App (объект). | | device | Да | Сведения об устройстве пользователя, которому будет показан показ, через объект Device (объект). | | user | Нет | Сведения о человеке-пользователе устройства; рекламная аудитория (объект). | | ext | Нет | Заглушка для расширений OpenRTB. | {% hint style="info" %} Только один из объектов `{site, app}` должен присутствовать в каждом запросе. {% endhint %} ## imp | Атрибут | Обязательно? | Описание | | ----------- | ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Да | Уникальный ID показа в этом запросе ставки (строка) | | bidfloor | Нет | Минимальная ставка за этот показ (CPM) / клик (CPC) и валюта аккаунта (float) | | bidfloorcur | Нет | Валюта для значения минимальной ставки, указанная с использованием буквенных кодов ISO-4217 (string) | | native | Только для native- и push-показов | Возможность объекта Native (объект). | | banner | Только для баннерных и полноэкранных межстраничных показов | Возможность объекта Banner (объект). | | instl | Только для pop-, direct link-, email- и полноэкранных межстраничных кликовых показов | Возможность объекта Fullscreen (объект). | | video | Только для видео | Возможность объекта Video (объект) | | secure | Рекомендуется | Флаг, указывающий, требуется ли для показа защищённый HTTPS URL для креативных материалов и разметки: 0 = небезопасно, 1 = безопасно (рекомендуется). Если не указан, состояние защищённости неизвестно, но можно предположить поддержку небезопасного HTTP (integer) | | el | Нет | Электронная почта, закодированная в Base64 (строка) | | ext | Нет | Заглушка для расширений, специфичных для биржи | ### imp.banner | Атрибут | Обязательно? | Описание | | ------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | | w | Да | Ширина баннера (integer) | | h | Да | Высота баннера (integer) | | mimes | Нет | Список поддерживаемых типов MIME (массив строк). Поддерживаются: image/jpeg, image/jpg, image/png, image/png, image/gif, image/webp, video/mp4 | | ext | Нет | Заглушка для расширений, специфичных для биржи (объект) | ### imp.banner.ext | Атрибут | Обязательно? | Описание | | ------------- | ------------ | ----------------------------------------------------------- | | image\_output | Нет | Указывает формат вывода для изображений баннеров\* (string) | | video\_output | Нет | Указывает формат вывода для видео-баннеров\* (string) | \*Определяет формат поля adm для баннерного формата. Варианты: xml или html. Значение по умолчанию — xml, если поле не указано. ### imp.instl | Атрибут | Обязательно? | Описание | | ------- | ------------ | -------------------------------------------------------------------------------------- | | instl | Да | 0 = клики по прямой ссылке/электронной почте, 1 = popunder/полноэкранный межстраничный | ### imp.native (для Native и Push Notification Ads) | Атрибут | Обязательно? | Описание | | ------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | request | Да | Тело запроса, соответствующее спецификации Native Ad, — это **строка, закодированная в JSON** запроса Native Ads, включая его **native** верхнеуровневый объект (JSON-объект) | | ver | Нет | Версия Dynamic Native Ads API, которой **request** соответствует (строка) | ### imp.native.request | Атрибут | Обязательно? | Описание | | --------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | ver | Да | Версия Native Markup, используемая в данный момент (строка) | | context | Нет | Контекст, в котором отображается реклама. В данном случае это **1** (*Контентно-ориентированный контекст, например лента новостей, статья, галерея изображений, галерея видео или аналогичный*), необязательно (целое число) | | plcmttype | Да | Дизайн/формат/макет рекламного блока, который предлагается. В настоящее время мы поддерживаем **4** (*Виджет рекомендаций*) и **500** (*Push-уведомление*) (целое число) | | plcmtcnt | Нет | Количество одинаковых размещений в этом макете. Макс.: 10 (integer) (integer) | | assets | Да | Массив **объектов Asset**. Любой ответ на ставку должен соответствовать массиву элементов, указанному в запросе ставки (массив JSON-объектов) | | seq | Нет | 0 для первого объявления, 1 для второго объявления и так далее. Обратите внимание, что это обычно НЕ используется совместно с plcmtcnt — либо вы проводите аукцион для нескольких одинаковых размещений (в этом случае plcmtcnt>1, seq=0), либо вы проводите отдельные аукционы для разных элементов в ленте (в этом случае plcmtcnt=1, seq=>=1) | ### imp.native.request.assets | Атрибут | Обязательно? | Описание | | -------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Да | Уникальный ID ресурса, назначаемый биржей. Обычно счётчик для массива (integer) 1: ID ресурса изображения, 2: ID ресурса заголовка, 3: ID ресурса описания | | required | Нет | Установите значение **1** если ресурс обязателен или **0** если ресурс необязателен (integer) | | plcmtcnt | Нет | Количество одинаковых размещений в этом макете (целое число) | | img | Да | Объект Image для ресурсов изображений\*\* (JSON object) | | title | Нет | Объект Title для ресурсов заголовка\*\* (JSON object) | | data | Нет | Объект данных для названия бренда, описания, оценок, цен и т. д.\* (JSON-объект) | \*Количество полученных ставок для вашего Native-запроса будет основано на значении, которое вы установите в "plcmtcnt". Например, запрос ставки с "plcmtcnt":3 получит 3 разных объекта ставки. Вы можете найти пример этого на странице [странице с примером ответа](/rtb/ru/izdateli/open-rtb/open-rtb-publisher-code-examples.md). \*\* Только один из объектов {img, title, data} должен присутствовать в каждом объекте ресурса ### imp.native.request.assets.img | Атрибут | Обязательно? | Описание | | ------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | type | Нет | ID типа элемента изображения, поддерживаемого издателем. Мы поддерживаем: **1** (*Изображение-иконка*) (целое число), **3** (*Большой предварительный просмотр изображения для объявления*) (целое число) | | w | Нет | Ширина изображения в пикселях, необязательно (целое число) | | h | Нет | Высота изображения в пикселях, необязательно (целое число) | | wmin | Да | Минимальная требуемая ширина изображения в пикселях (целое число) | | hmin | Да | Минимальная требуемая высота изображения в пикселях (целое число) | \*Размеры значка Push Notification: 192px x 192px ### imp.native.request.assets.title | Атрибут | Обязательно? | Описание | | ------- | ------------ | ------------------------------------------------------------- | | len | Да | Максимальная длина текста в элементе заголовка. (целое число) | ### imp.native.request.assets.data | Атрибут | Обязательно? | Описание | | ------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | type | Да | ID типа элемента, поддерживаемого издателем (целое число). Мы поддерживаем: **1** (*sponsored - сообщение «Sponsored By», где ответ должен содержать название бренда спонсора*), **2** (*desc - описательный текст, связанный с рекламируемым продуктом или услугой*) | | len | Нет | Максимальная длина текста в ответе элемента (целое число) | ### imp.video | Атрибут | Обязательно? | Описание | | --------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------- | | mimes | Нет | Список поддерживаемых MIME-типов (массив строк) | | protocols | Нет | Список поддерживаемых протоколов ответа на видеозапрос ставки (массив целых чисел) | | skip | Нет | Указывает, будет ли проигрыватель разрешать пропуск видео, где 0 = нет, 1 = да | | skipafter | Нет | Количество секунд, которое видео должно проигрываться до включения пропуска; применимо только если рекламу можно пропустить | | skipmin | Нет | Видео общей длительностью больше этого числа секунд могут быть пропускаемыми; применимо только если рекламу можно пропустить | {% hint style="info" %} Если вы укажете только "skip" в запросе, но не "skipafter", видео можно будет пропустить через 5 секунд. В ответе "skipoffset" будет установлен в 5.\ Если вы укажете "skip", но не "skipmin", видео можно будет пропустить независимо от его длительности. {% endhint %} ### imp.ext | Атрибут | Обязательно? | Описание | | ---------- | ------------ | ------------------------------------------------------------------------- | | video\_cta | Нет | Указывает, следует ли предоставлять CTA: 0 = нет, 1 = да (по умолчанию 1) | Чтобы увидеть пример CTA, ознакомьтесь с нашим [странице с примером ответа](/rtb/ru/izdateli/open-rtb/open-rtb-publisher-code-examples.md). ## site | Атрибут | Обязательно? | Описание | | -------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Обязательно | Уникальный ID сайта (строка) | | domain | Обязательно | Доменное имя сайта (строка) | | имя | Обязательно | Название сайта (string) | | cat | Нет | ID категории IAB (массив строк) | | page | Рекомендуется | Полный URL страницы, где будет показано объявление (строка) | | keywords | Нет | Ключевые слова можно использовать, чтобы гарантировать, что рекламные зоны получают нужный тип рекламы. Ключевые слова должны представлять собой строку слов, разделённых запятыми. | | ext | Нет | Заполнитель для расширений OpenRTB, специфичных для биржи. | ### site.ext | Атрибут | Обязательно? | Описание | | ----------- | ------------ | --------------------------------------------------------- | | exchangecat | Нет | Пользовательский ID категории ExoClick (целое число) | | idzone | Нет | Пользовательский ID рекламной зоны ExoClick (целое число) | ## приложение | Атрибут | Обязательно? | Описание | | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Обязательно | Уникальный ID приложения (string) | | cat | Нет | ID категории IAB (массив строк) | | keywords | Нет | Ключевые слова можно использовать, чтобы гарантировать, что рекламные зоны получают нужный тип рекламы. Ключевые слова должны представлять собой строку слов, разделённых запятыми (string) | | издатель | Нет | Сведения об издателе (объект) | ### app.publisher | Атрибут | Обязательно? | Описание | | ------- | ------------- | ------------------------------------------------------------------- | | domain | Рекомендуется | Домен верхнего уровня издателя (например, "publisher.com") (string) | ## device | Атрибут | Обязательно? | Описание | | -------- | ------------- | ------------------------------------------------------------------------------------------------------------- | | ua | Да | User-Agent браузера (строка) | | geo | Нет | Местоположение устройства, которое считается текущим местоположением пользователя, определяемое объектом Geo. | | ip | Да | IP-адрес пользователя (строка)\* | | ipv6 | Рекомендуется | IPv6-адрес пользователя (строка)\* | | language | Рекомендуется | Язык браузера в формате ISO-639-1-alpha-2 (строка) | | os | Нет | Операционная система (строка) | | js | Нет | Поддержка JavaScript, где 0 = нет, 1 = да (целое число) | | ext | Нет | Заполнитель для расширений OpenRTB, специфичных для биржи | {% hint style="info" %} В запросе нужно указывать либо ip, либо ipv6, но не оба сразу. Если используете ipv6, удалите атрибут ip, и наоборот. Указание обоих может вызвать ошибки. {% endhint %} ### device.geo | Атрибут | Обязательно? | Описание | | ------- | ------------ | ----------- | | country | Нет | Страна ISO3 | ### device.ext | Атрибут | Обязательно? | Описание | | ----------------- | ------------ | -------------------------------------------------------------------------- | | remote\_addr | Нет | Основной IP-адрес пользователя (строка) | | x\_forwarded\_for | Нет | IP-адрес пользователя из X-FORWARDED-FOR или пусто, если не задан (строка) | ## user | Атрибут | Обязательно? | Описание | | ------- | ------------ | ----------------------------------- | | id | Да | Уникальный ID пользователя (строка) | {% hint style="info" %} Если вы не можете сгенерировать строку ID пользователя, можете оставить её пустой (""). Запрос получит ответ, если в нём будет включён объект "user". {% endhint %} ## ext | Атрибут | Обязательно? | Описание | | ------- | ------------ | -------------------------------------------------------------------------------------------------- | | sub | Нет | Sub ID. Это должно быть число длиной от одной до десяти цифр: не используйте нули в начале Sub ID. | | экспорт | Нет | Тип ответа может быть "json" или "xml" (string). По умолчанию — "json". | ## Примеры Вы можете найти подробный список примеров запросов в нашем [странице с примерами](/rtb/ru/izdateli/open-rtb/open-rtb-publisher-code-examples.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.exoclick.com/rtb/ru/izdateli/open-rtb/pub-open-rtb-2.4-request.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.