Direct API

Placement bo'yicha to'g'ridan-to'g'ri reklama so'rovlari uchun endpoint. WEB va APP uchun Banner, Outstream va Instream qo'llab-quvvatlanadi.

Asosiy URL

https://ia.box/ads/direct

WEB

Sayt uchun reklama so'rovi.

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

Parametrlar

Parametr	Majburiy	Tavsif
`plc`	✅	Placement nomi
`referer`	❌	Domen almashtirish (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 nomi
`bundle`	❌	App Bundle ID almashtirish
`ifa`	❌	Qurilma ID almashtirish (IDFA / GAID)

Misol

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

Banner (iframe) — WEB

Banner reklamalarni iframe orqali joylashtirish. Faqat 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 nomi
`referer`	❌	Domen almashtirish (site referer)

iframe Atributlari

Atribut	Tavsif	Misol
`width`	Banner kengligi	`100%`
`height`	Banner balandligi (px)	`600`
`frameborder`	Ramka chegarasi	`0`
`allowfullscreen`	To'liq ekran rejimiga ruxsat	—

Outstream (Video) — WEB

Video reklamalar uchun joylashtiriladigan skript. Faqat saytlar uchun.

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

Atributlar

Atribut	Majburiy	Tavsif	Standart
`adunit-id`	✅	Placement nomi (adunit ID)	—
`referer`	❌	Domen almashtirish (referer)	—
`width`	❌	Pleyer kengligi (px)	`640`
`height`	❌	Pleyer balandligi (px)	`360`

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

Yaratilgan URL

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

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

Instream (Video) — APP

Video reklamalarni mobil ilovaga joylashtirish. Faqat APP uchun.

Google IMA SDK orqali ishlaydi
Instream reklamalari Google Interactive Media Ads (IMA) SDK orqali yetkaziladi. Direct API VAST javobini qaytaradi, uni IMA SDKga pleyback uchun uzatish kerak.

Google IMA SDK hujjatlari →

So'rov URLi:

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

Parametrlar

Parametr	Majburiy	Tavsif
`plc`	✅	Placement nomi
`bundle`	❌	App Bundle ID almashtirish
`ifa`	❌	Qurilma ID almashtirish (IDFA / GAID)

Misol

# Almashtirishlar bilan:
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

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

Platformalar bo'yicha parametrlar

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