Direct API

Joylashtirish bo'yicha to'g'ridan-to'g'ri reklama so'rovlari endpointi. Banner, Outstream va Instream.

Base URL

https://ia.box/ads/direct

WEB

Veb-sayt uchun reklama so'rovi.

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

Parametrlar

Parametr	Majburiy	Tavsif
`plc`	✅	Placement name
`referer`	❌	Domain override (site referer)

Misol

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

APP

Mobil ilova uchun reklama so'rovi.

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

Parametrlar

Parametr	Majburiy	Tavsif
`plc`	✅	Placement name
`bundle`	❌	App Bundle ID override
`ifa`	❌	Device ID override (IDFA / GAID)

Misol

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

Banner (iframe) — WEB

Iframe orqali banner reklamasini joylashtirish. Faqat veb-saytlar uchun.

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

URL parametrlari

Parametr	Majburiy	Tavsif
`plc`	✅	Placement name
`referer`	❌	Domain override (site referer)

iframe atributlari

Parametr	Tavsif	Misol
`width`	Banner width	`100%`
`height`	Banner height (px)	`600`
`frameborder`	Frame border	`0`
`allowfullscreen`	Allow fullscreen mode	—

Outstream (Video) — WEB

Video reklamalari uchun o'rnatiladigan skript. Faqat veb-saytlar uchun.

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

Atributlar

Parametr	Majburiy	Tavsif	Standart
`adunit-id`	✅	Placement name (adunit ID)	—
`referer`	❌	Domain override (referer)	—
`width`	❌	Player width (px)	`640`
`height`	❌	Player height (px)	`360`

Agar referer uzatilsa, u Direct API so'rov URLiga qo'shiladi.

Yaratilgan 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

Mobil ilovaga video reklamalarini joylashtirish. Faqat APP uchun.

Google IMA SDK orqali ishlaydi

Instream reklamasi Google Interactive Media Ads (IMA) SDK orqali yetkazib beriladi. Direct API VAST javobini qaytaradi, uni IMA SDK ga uzatish kerak.

Google IMA SDK hujjatlari

Request URL:

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

Parametrlar

Parametr	Majburiy	Tavsif
`plc`	✅	Placement name
`bundle`	❌	App Bundle ID override
`ifa`	❌	Device ID override (IDFA / GAID)

Misol

# 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

Xulosa jadvali

Parametr	Platforma	Format
Banner (iframe)	WEB	Banner
Outstream	WEB	Video
Instream	APP	Video

Platforma bo'yicha parametrlar

Parametr	WEB	APP
`plc`	✅	✅
`referer`	❌	❌
`bundle`	❌	❌
`ifa`	❌	❌

← Nashriyotchilar bo'limi Android SDK →