Conversion Tracking for Telegram Bots / Telegram Mini Apps (TMA)

This guide will help you configure the transmission of conversions from your Telegram bot or Telegram Mini App to the Adexium advertising network.

Step-by-Step Instruction

1. Create an Advertising Campaign

Create a new advertising campaign in your Adexium dashboard.

2. Configure the Campaign Link

In the campaign settings, specify the link to your Telegram bot:

https://t.me/your_telegram_name_bot/game?startapp=adexium__[CLICK_ID]

Important:

• Replace your_telegram_name_bot with your bot's real username
• Use a double underscore __ between adexium and [CLICK_ID]
• The [CLICK_ID] parameter will be automatically replaced

3. Configure Processing on Your Backend

When a user clicks the ad link, Telegram will send your bot a /start command.

Example incoming message:/start adexium__d95c746d-31c7-4183-8fa7-42ce39b65e47

You need to:

1. Get the parameter value after /start
2. Extract the click identifier after adexium__
3. Save this [CLICK_ID] to your database

4. Sending the Conversion

At the moment of the target action, send a GET request:

GET https://go.tgads.live/conversion?click_id=[CLICK_ID]

Replace [CLICK_ID] with the saved value.

Workflow Example

1. Campaign Link:https://t.me/my_game_bot/game?startapp=adexium__[CLICK_ID]

2. Actual User Click:https://t.me/my_game_bot/game?startapp=adexium__d95c746d-31c7-4183-8fa7-42ce39b65e47

3. Backend Action: Extracts click_id = d95c746d-31c7-4183-8fa7-42ce39b65e47

4. Sending Postback:GET https://go.tgads.live/conversion?click_id=d95c746d-31c7-4183-8fa7-42ce39b65e47