Kinz-ID SDK Docs

Kinz-ID Mini App SDK

AdsKinz is a native advertising platform for Telegram. Advertisers run campaigns shown as native channel posts or in-Mini-App ad formats; publishers monetize Telegram channels and Mini Apps through them. The Kinz-ID SDK lets a Mini App developer request and display an ad in a single function call.

Key facts

  • Two ad formats are served through the SDK: interstitial and popInterstitial.
  • Integration requires a kinzId, generated by the publisher in the AdsKinz Mini Apps workspace when they register a Mini App — not something a developer can invent or guess.
  • The SDK is a single script tag plus a global window.AdsKinz object, deliberately modeled after the window.Adsgram pattern already common in the Telegram Mini App ecosystem, so developers already familiar with that pattern need almost no relearning.
  • Ad creatives are pre-translated server-side at campaign approval time, using the user's Telegram language code.
  • There is no reward-video-only format at this stage — only interstitial and pop interstitial.

Get started in 3 steps

1

Get a kinzId

Register your Mini App at partner.adskinz.io → Mini Apps.

2

Load the SDK

Add the script tag before your app code.

3

Init + show()

Create a controller and call .show() at a natural break point.

Next step

Head to the Quickstart for the full walkthrough with code.