> 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/reklamodateli/open-rtb/adv-open-rtb-2.5-request.md). # Запрос ставки Open RTB 2.5 На этой странице описываются различные компоненты RTB-запросов, которые вы будете получать для размещения ставок. ## Заголовки запроса ставки * **HTTP-заголовок версии OpenRTB:** x-openrtb-version: 2.5 * **HTTP-заголовок Keep-Alive:** Connection: Keep-Alive * **JSON содержимого: Content-Type:** application/json * **Заголовок кодирования данных:** Accept-Encoding ## Запрос ставки 2.5 При запросе ставок для конкретного контекста платформа выполнит HTTP-запрос с тайм-аутом **300 мс** и отправит следующий объект, закодированный как JSON, в теле запроса. **HTTP** рекомендуется из-за дополнительной задержки при использовании HTTPS. | Атрибут | Описание | | ------- | ------------------------------------------------------------------------------------------------------------------------- | | id | Уникальный ID запроса ставки (строка) | | site | Сведения о веб-сайте издателя через объект Site (object) | | device | Сведения об устройстве пользователя, на которое будет доставлен показ рекламы (object) | | user | Сведения о человеке-пользователе устройства; рекламная аудитория (object) | | imp | Сведения о рекламном размещении или показе, выставляемом на аукцион (object) | | regs | Сведения о любых отраслевых, правовых или государственных нормативных требованиях, действующих для этого запроса (object) | | ext | Заполнитель для расширений OpenRTB (object) | ## site | Атрибут | Описание | | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Уникальный ID сайта (строка) | | domain | Доменное имя сайта (строка) | | cat | ID категории IAB (массив строк) | | page | Полный URL страницы, где будет показано объявление (строка) | | keywords | Ключевые слова можно использовать, чтобы рекламные зоны получали нужный тип рекламы. Ключевые слова должны быть строкой слов, разделённых запятыми | | ext | Заглушка для расширений, специфичных для биржи (объект) | ### site.ext | Атрибут | Описание | | ----------- | --------------------------------------------------------- | | exchangecat | Пользовательский ID категории ExoClick (целое число) | | idzone | Пользовательский ID рекламной зоны ExoClick (целое число) | | keyword | Соответствующее ключевое слово, если есть (строка) | ## device | Атрибут | Описание | | -------- | --------------------------------------------------------------------------------------------------------------------------------- | | ua | User-Agent браузера (строка) | | sua | Структурированная информация user-agent, которая может использоваться, когда клиент поддерживает User-Agent Client Hints (объект) | | geo | Местоположение устройства, предполагаемое как текущее местоположение пользователя, заданное объектом Geo | | ip | IPv4-адрес пользователя (строка)\* | | ipv6 | IPv6-адрес пользователя (строка)\* | | language | Язык браузера (строка) | | os | Операционная система (строка) | | js | Поддержка JavaScript, где 0 = нет, 1 = да (целое число) | | ext | Заполнитель для расширений OpenRTB, специфичных для биржи (объект) | \*В запросе ставки будет присутствовать ровно один из ip или ipv6. ### device.geo | Атрибут | Описание | | --------- | ---------------------------------------------------------------------------------------------------- | | country | Страна ISO3 | | ipservice | Сервис или провайдер, используемый для определения геолокации по IP-адресу, если применимо (integer) | ### device.ext | Атрибут | Описание | | ----------------- | -------------------------------------------------------------------------- | | remote\_addr | Основной IP-адрес пользователя (строка) | | x\_forwarded\_for | IP-адрес пользователя из X-FORWARDED-FOR или пусто, если не задан (строка) | ### device.sua Структурированная информация User-Agent. `device.sua` считается более точным представлением атрибутов устройства. | Атрибут | Описание | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | browsers | Отправляйте бренды и версии, полученные из заголовка Sec-CH-UA-Full-Version-List. (Массив `BrandVersion` объектов) | | platform | Отправляйте бренд, полученный из заголовка Sec-CH-UA-Platform, и версию, полученную из заголовка Sec-CH-UA-Platform-Version. (`BrandVersion` Объект) | | mobile | Получайте это значение из заголовка Sec-CH-UA-Mobile. (целое число) | | architecture | Получайте это значение из заголовка Sec-CH-UA-Arch. (строка) | | bitness | Получайте это значение из заголовка Sec-CH-UA-Bitness. (строка) | | model | Получайте это значение из заголовка Sec-CH-UA-Model. (строка) | | source | Источник данных, использованных для создания этого объекта, [Список: источник User-Agent](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/master/AdCOM%20v1.0%20FINAL.md#list--user-agent-source-) в AdCOM 1.0 (целое число; по умолчанию 0) | ### device.sua.browsers | device.sua.platform | Атрибут | Описание | | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | brand | Значение может быть получено из заголовков User-Agent Client Hints и представлять либо бренд user agent (из заголовка Sec-CH-UA-Full-Version), либо бренд платформы (из заголовка Sec-CH-UA-Platform). (строка) | | version | Последовательность компонентов версии в порядке убывания по иерархии \[major, minor, micro, …] (массив строк) | ## user | Атрибут | Описание | | ------- | ----------------------------------- | | id | Уникальный ID пользователя (строка) | ### user.ext | Атрибут | Описание | | -------- | ------------------------------------------------------------------------------------------- | | согласие | Это строка согласия, требуемая стандартами IAB. Пока только отрицательное согласие (строка) | ## regs | Атрибут | Описание | | ------- | ---------------------------------------------------------- | | ext | Заполнитель для расширений OpenRTB, специфичных для биржи. | ### regs.ext | Атрибут | Описание | | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | GDPR | Это 0, если вызывающая сторона считает, что пользователь не подпадает под GDPR, и 1, если пользователь подпадает под GDPR. Если ни то ни другое, этот параметр будет неопределён. | ## imp | Атрибут | Описание | | ------- | ------------------------------------------------------------------------------------ | | id | Уникальный идентификатор этого показа в контексте запроса ставки (string) | | instl | 1 = объявление интерстициальное или полноэкранное, 0 = не интерстициальное (integer) | | video | Сведения через объект Video, представляющий видеопоказ in-stream | | secure | Флаг, указывающий, требуется ли для показа защищённый URL HTTPS (integer) | | ext | Заполнитель для расширений OpenRTB, специфичных для биржи (объект) | ### imp.video | Атрибут | Описание | | ------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | mimes | Поддерживаемые MIME-типы контента (например, "video/mp4") (массив строк ) | | minduration | Минимальная длительность видеорекламы в секундах (целое число) | | maxduration | Максимальная длительность видеорекламы в секундах (целое число) | | protocols | Массив поддерживаемых видеопротоколов (целое число) | | linearity | Указывает, должен ли показ быть линейным, нелинейным и т. д. Если ничего не указано, считать, что разрешены все варианты (целое число) | | boxingallowed | Указывает, разрешено ли размещение контента 4:3 в окне 16:9 с чёрными полями, где 0 = нет, 1 = да (целое число) | | pos | Позиция рекламы на экране (целое число) | | h | Ширина видеоплеера в независимых от устройства пикселях (DIPS) (целое число) | | w | Высота видеоплеера в независимых от устройства пикселях (DIPS) (целое число) | | ext | Заполнитель для расширений OpenRTB, специфичных для биржи (объект) | ### imp.video.ext | Атрибут | Описание | | ---------- | ---------------------------------------------------------------- | | zone\_type | Тип зоны в рекламных форматах ExoClick (например: video\_slider) | --- # 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/reklamodateli/open-rtb/adv-open-rtb-2.5-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.