Direct API

Эндпоинт для прямого запроса рекламного объявления по плейсменту. Banner, Outstream и Instream.

Base URL

https://ia.box/ads/direct

WEB

Запрос рекламы для веб-сайта.

GET https://ia.box/ads/direct?plc=test_banner&referer=iabox.uz

Параметры

Параметр	Обязательный	Описание
`plc`	✅	Placement name
`referer`	❌	Domain override (site referer)

Пример

GET https://ia.box/ads/direct?plc=test_banner&referer=iabox.uz

APP

Запрос рекламы для мобильного приложения.

GET https://ia.box/ads/direct?plc=test_banner&bundle=test.com&ifa=user_device_id

Параметры

Параметр	Обязательный	Описание
`plc`	✅	Placement name
`bundle`	❌	App Bundle ID override
`ifa`	❌	Device ID override (IDFA / GAID)

Пример

GET https://ia.box/ads/direct?plc=test_banner&bundle=test.com&ifa=user_device_id

Banner (iframe) — WEB

Встраивание баннерной рекламы через iframe. Только для веб-сайтов.

<iframe
    src="https://ia.box/ads/direct?plc=test_banner&referer=dsp-ui.uz"
    width="100%"
    height="600"
    frameborder="0"
    allowfullscreen
></iframe>

Параметры URL

Параметр	Обязательный	Описание
`plc`	✅	Placement name
`referer`	❌	Domain override (site referer)

Атрибуты iframe

Параметр	Описание	Пример
`width`	Banner width	`100%`
`height`	Banner height (px)	`600`
`frameborder`	Frame border	`0`
`allowfullscreen`	Allow fullscreen mode	—

Outstream (Video) — WEB

Встраиваемый скрипт для видеорекламы. Только для веб-сайтов.

<script src="https://storage.dsp-ui.uz/uploads/outstream.js"
    adunit-id="test"
    referer="iabox.uz"
    width="300"
    height="600">
</script>

Атрибуты

Параметр	Обязательный	Описание	По умолчанию
`adunit-id`	✅	Placement name (adunit ID)	—
`referer`	❌	Domain override (referer)	—
`width`	❌	Player width (px)	`640`
`height`	❌	Player height (px)	`360`

Если referer передан — он будет добавлен в URL запроса к Direct API.

Формируемый URL

# With referer:
https://ia.box/ads/direct?plc=test&referer=iabox.uz

# Without referer:
https://ia.box/ads/direct?plc=test

Instream (Video) — APP

Встраивание видеорекламы в мобильное приложение. Только для APP.

Работает через Google IMA SDK

Instream-реклама доставляется через Google Interactive Media Ads (IMA) SDK. Direct API возвращает VAST-ответ, который необходимо передать в IMA SDK для воспроизведения.

Документация Google IMA SDK

Request URL:

GET https://ia.box/ads/direct?plc=test_banner&bundle=test.com&ifa=user_device_id

Параметры

Параметр	Обязательный	Описание
`plc`	✅	Placement name
`bundle`	❌	App Bundle ID override
`ifa`	❌	Device ID override (IDFA / GAID)

Пример

# With overrides:
https://ia.box/ads/direct?plc=test_banner&bundle=test.com&ifa=user_device_id

# Minimal:
https://ia.box/ads/direct?plc=test_banner

Сводная таблица

Параметр	Платформа	Формат
Banner (iframe)	WEB	Banner
Outstream	WEB	Video
Instream	APP	Video

Параметры по платформам

Параметр	WEB	APP
`plc`	✅	✅
`referer`	❌	❌
`bundle`	❌	❌
`ifa`	❌	❌

← К разделу Publishers Android SDK →