How to export a Unity playable ad for ironSource
ironSource accepts HTML5 playable ads with strict packaging rules. This guide covers the current spec, the export steps with PlayableForge, and the reasons ironSource most often rejects a playable.
ironSource playable ad specification
| Requirement | ironSource |
|---|---|
| Max file size | 5 MB (single file) |
| Format | Single HTML file, assets inlined; ironSource runs its own QA tool on upload |
| Orientation | Portrait and landscape both supported; the ad must handle rotation. |
| Required callbacks | dapi API: dapi.isReady(), dapi.getScreenSize(), dapi.openStoreUrl(), audio via dapi.getAudioVolume() |
| External requests | None. All assets must be inlined; no network calls at runtime. |
Verify against the current ironSource documentation before submitting; networks change limits without notice. Last checked: 2026-09-06.
ironSource (now part of Unity's ad business) validates uploads automatically. Their checker rejects any file that opens a network request, so fonts and analytics pings are the usual failure.
Export a Unity playable for ironSource with PlayableForge
- Open your Unity project with the PlayableForge package installed.
- In Window → PlayableForge, choose the playable scene and set the end-card and CTA text.
- Under Networks, tick ironSource. The size budget in the inspector switches to 5 MB (single file).
- Press Export. The plugin builds the runtime, inlines assets, injects the ironSource callbacks and packages the file as single html file, assets inlined.
- Download from the dashboard and upload to ironSource. The dashboard shows the final size and a pass/fail against the spec before you upload.
Why ironSource rejects playables
- Not waiting for
dapi.isReady()before starting the game. - Any outbound request, including web fonts.
- Ignoring
dapi.getScreenSize()and rendering off-screen on landscape devices. - Store URL opened by something other than
dapi.openStoreUrl().
Testing before submission
Open the exported file directly in a mobile browser over a throttled connection (Chrome DevTools, "Slow 3G") and confirm it loads without a blank frame, plays with sound muted, and that the CTA fires. Then test in the network's own preview tool if it offers one.
Skip the manual work. PlayableForge exports a validated build for this network (and 20 others) from your Unity project in one click. Get early access.