Preparations
Preparations before connection
1. Connect the TON Connect SDK
Web3 events for the Telegram Mini Apps Analytics SDK are supported by the @tonconnect/ui
and @tonconnect/ui-react
libraries since version 2.0.3, @tonconnect/sdk
since version 3.0.3.
Read more about TON Connect integration
Don't worry if your app doesn't use TON Connect, the analytics SDK will still work and collect non-Web3 events.
2. Get the token with TON Builders
Register your project on TON Builders and go to the Analytics tab.

Enter your Telegram Bot URL and mini app domain to receive an API key for SDK initialization. You can also manage your existing keys from the same section. Enter your Telegram Bot URL and mini app domain to receive a token for SDK initialization.
3. Initialize SDK
Now you can initialize the SDK in your application. There are two ways to do this:
via <script> tag (See Installation via <script> tag page)
via NPM package (See Installation via NPM package page)
Navigation:
SDK installation:
Last updated