Macros are here! Add dynamic tokens to your bot and Mini App links to track clicks, costs, devices, and more — right in your Telegram ads. Smarter data, better decisions, no guesswork.
We’re excited to introduce a powerful new feature for Telegram Mini App Ads!
You can now use macros — dynamic UTM-style tokens — in ad links that lead to both Telegram Mini Apps and Telegram bots.
And yes — you can even include them in the start or startapp parameter of bot links.
That means better data, more visibility, and easier optimization. Not sure what that means just yet? No worries — we’ll walk you through everything step by step below.
What Are Macros?
Macros are small tokens you can add to your ad links.
When someone clicks on your ad, each macro is automatically replaced with real information — like the click ID, the user’s country, or the device they’re using.
In short, it helps you understand where your traffic is coming from and how it behaves.
For example, you can see that someone from Germany clicked your ad using an iPhone, and that the click cost you $0.07 — all without setting up anything extra.
Okay, What Can You Track?
Here’s what’s currently available in Telegram Mini App Ads:
- click ID – helps match conversions to clicks
- country – shows where the user is from
- mobile brand – like Samsung, Apple, Xiaomi
- browser – Chrome, Safari, etc.
- OS – Android, iOS, Windows
- cost – how much the click actually cost
- campaign ID – to see which campaign the traffic came from
- traffic spot ID – if you're using multiple placements
- ad creative ID – helps track which exact creative performed best
- domain – where the ad was shown
In short — everything you need to understand your traffic and optimize your results. Exciting, right?
How Do You Use Them?
Using macros is super simple — just add them to the end of your links. When someone clicks, they’re replaced with real values automatically.
You can use macros in:
- Links that lead to Telegram Mini Apps
- Links that lead to Telegram bots
Note: Telegram limits the start parameter to 512 characters. For best performance, we recommend staying under 64 characters.
Here’s an example:
Add macros directly to the startapp parameter of your Telegram Mini App
https://t.me/YourBot/MiniApp?startapp=click_id=[CLICK_ID]&cost=[COST]
When a user clicks the ad, it becomes something like:
https://t.me/YourBot/MiniApp?startapp=click_id=abc123&cost=0.07
This helps you track every click and cost directly in your analytics or CRM.
Why Use Macros?
Because guessing shouldn't be part of your strategy.
With macros now supported in Telegram Mini App Ads, you finally get the clarity you need to optimize with confidence.
You can now:
- Track key details across every click
- Segment users by device, GEO, browser, or campaign
- Run A/B tests and compare performance with precision
- Replace assumptions with real numbers
The bottom line is: every macro is a small piece of truth. And the more truth you have — the better your campaigns perform.
That’s It — You’re All Set
Now that you know what’s new and how it all works, you’re ready to take full advantage of macros in your Telegram Mini App Ads.
If you’ve been waiting for a sign to try a new setup or collect deeper insights — this is it.
Go ahead and test it in your next Telegram Mini App campaign. We can't wait to see what you build with it.
