Telegram Mini Apps Analytics SDK
  • Overview
  • SDK
    • Preparations
    • Installation via <script> tag
    • Installation via NPM package
  • API
    • Endpoints
  • Supported events
  • Bot
  • FAQ
    • How can I check the integration status of the SDK?
Powered by GitBook
On this page
  • How to install it?
  • Supported Events
  • Navigation:
  1. SDK

Installation via <script> tag

How to install and use via <script> tag

How to install it?

1. Add Telegram Mini Apps Analytics to your project

Include the Telegram Mini Apps Analytics script in the header of your HTML document. This script will allow you to track and analyze user interactions effectively.

<!-- Add Telegram Analytics script to HTML head -->
<script 
    async 
    src="https://tganalytics.xyz/index.js" 
    onload="initAnalytics()" 
    type="text/javascript"
></script>

Alternative solution (not recommended)

<!-- Add Telegram Analytics script to HTML head -->
<script
    async 
    src="https://unpkg.com/@telegram-apps/analytics@latest/dist/index.js"
    onload="initAnalytics()"  
    type="text/javascript"
></script>

2. Initialize the Telegram Mini Apps Analytics SDK

Once you have your unique access token and analytics identifier (if not, see Preparations page), you can initialize the Telegram Analytics SDK in your code. This step is crucial for enabling the tracking of events without repeatedly transferring the token.

<script>
    function initAnalytics() {
      window.telegramAnalytics.init({
        token: 'YOUR_TOKEN',
        appName: 'ANALYTICS_IDENTIFIER',
      });
    }
</script>

Supported Events

After initializing the Telegram Analytics, you are all set to transfer the data, gain insights, and improve user engagement. (99% of them will be tracked automatically without manual control)

Read more about supported events


Navigation:

  • Overview

  • SDK installation:

    • preparations

    • via <script> tag

    • via NPM package

  • API docs

  • Supported events

  • Bot

  • Demo app

Last updated 4 months ago