Direct API

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

Base 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`	Ha	Placement nomi
`referer`	Yo'q	Domenni almashtirish (site referer)

Namuna

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`	Ha	Placement nomi
`bundle`	Yo'q	App Bundle ID ni almashtirish
`ifa`	Yo'q	Device ID ni almashtirish (IDFA / GAID)

Namuna

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

Banner (iframe) — WEB

Banner reklamasini 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`	Ha	Placement nomi
`referer`	Yo'q	Domenni almashtirish (site referer)

iframe atributlari

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

Outstream (Video) — WEB

Video reklamasi uchun 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 qiymat
`adunit-id`	Ha	Placement nomi (adunit ID)	—
`referer`	Yo'q	Domenni almashtirish (referer)	—
`width`	Yo'q	Pleyer kengligi (px)	`640`
`height`	Yo'q	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 reklamasini mobil ilovaga joylashtirish. Faqat APP uchun.

Google IMA SDK orqali ishlaydi

Instream-reklama Google Interactive Media Ads (IMA) SDK orqali yetkazib beriladi. Direct API VAST-javobini qaytaradi, uni IMA SDKga 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`	Ha	Placement nomi
`bundle`	Yo'q	App Bundle ID ni almashtirish
`ifa`	Yo'q	Device ID ni almashtirish (IDFA / GAID)

Namuna

# 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`	Ha	Ha
`referer`	Yo'q	Yo'q
`bundle`	Yo'q	Yo'q
`ifa`	Yo'q	Yo'q