Direct API — Publisher Documentation

Base URL

https://ia.box/ads/direct

WEB

Ad request for a website.

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

Parameters

Parameter	Required	Description
`plc`	✅	Placement name
`referer`	❌	Domain override (site referer)

Example

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

APP

Ad request for a mobile app.

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

Parameters

Parameter	Required	Description
`plc`	✅	Placement name
`bundle`	❌	App Bundle ID override
`ifa`	❌	Device ID override (IDFA / GAID)

Example

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

Banner (iframe) — WEB

Embedding banner ads via iframe. For websites only.

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

URL Parameters

Parameter	Required	Description
`plc`	✅	Placement name
`referer`	❌	Domain override (site referer)

iframe Attributes

Attribute	Description	Example
`width`	Banner width	`100%`
`height`	Banner height (px)	`600`
`frameborder`	Frame border	`0`
`allowfullscreen`	Allow fullscreen mode	—

Outstream (Video) — WEB

Embeddable script for video ads. For websites only.

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

Attributes

Attribute	Required	Description	Default
`adunit-id`	✅	Placement name (adunit ID)	—
`referer`	❌	Domain override (referer)	—
`width`	❌	Player width (px)	`640`
`height`	❌	Player height (px)	`360`

If referer is passed, it will be added to the Direct API request URL.

Generated 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

Embedding video ads into a mobile app. For APP only.

Works via Google IMA SDK

Instream ads are delivered through Google Interactive Media Ads (IMA) SDK. Direct API returns a VAST response that must be passed to the IMA SDK for playback.

Google IMA SDK docs

Request URL:

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

Parameters

Parameter	Required	Description
`plc`	✅	Placement name
`bundle`	❌	App Bundle ID override
`ifa`	❌	Device ID override (IDFA / GAID)

Example

# 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

Summary

Integration	Platform	Format
Banner (iframe)	WEB	Banner
Outstream	WEB	Video
Instream	APP	Video

Parameters by platform

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

← Publishers Android SDK →