FAQ
Common integration questions from Mini App developers.
Do I need a different kinzId for each format?
No — one kinzId identifies your Mini App as a whole. You create a separate init() call (a separate controller) per format, but they share the same kinzId.
Can I test the SDK before my Mini App is approved?
.show() rejects with NO_FILL until your Mini App is approved. That lets you verify your integration code runs without errors before real ads are available.
Does the SDK work outside of Telegram (a regular browser tab)?
The SDK expects the Telegram Mini App environment, since it reads window.Telegram.WebApp.initDataUnsafe for language targeting. Outside that context language detection falls back to English, but the rest of the SDK still functions for testing.
How is revenue calculated and paid out?
That's a publisher dashboard question, not an SDK one — see earnings and withdrawals in your partner workspace.
Is there a way to preload an ad before calling show()?
Not in v1.0.0 — .show() requests and displays in one step. A separate preload method may be added later if publisher demand justifies the added complexity.
What happens if I call init() twice with the same format?
Each call creates an independent controller. Not harmful, but unnecessary — reuse the same controller reference instead.