Ad Formats
Kinz-ID serves two Mini App ad formats. Both go through the same .show() call — the format is fixed at init() time, per controller.
interstitial
A full-screen ad shown between two natural steps in your flow — between finishing a task and seeing its result, or between levels in a game.
- Takes over the full viewport.
- Not dismissible before a short minimum view time; after that a close control appears.
- Best trigger points: level transitions, loading screens, post-action confirmations.
- Resolves
"completed"once the minimum view time and any video finished, or"closed"if dismissed after the close control appears.
popInterstitial
A smaller overlay window shown on top of your existing UI without fully replacing it — the user can see, but not interact with, the app behind it.
- Doesn't take over navigation, but captures input until dismissed.
- Dismissible immediately — no minimum forced view time.
- Best trigger points: a moment you choose deliberately, such as app open or a specific in-app action.
- Resolves
"closed"in the large majority of real usage; that is the expected outcome, not a failure state.
Choosing between them
| interstitial | popInterstitial | |
|---|---|---|
| Screen coverage | Full | Partial overlay |
| Minimum view time | Yes | No |
| Best for | Natural break points (level end, task complete) | Publisher-chosen moments (app open, specific action) |
| Typical resolve state | "completed" | "closed" |
If you're integrating only one format to start, interstitial at a natural transition point is the simpler and more predictable choice.
What you cannot do
There is no way to skip the close control on
interstitial beyond the fixed minimum view time, and no way to make popInterstitial non-dismissible. These constraints are intentional and identical for every publisher — they keep the ad experience predictable for end users across every Mini App running AdsKinz.