- ENG
- RUS
How to set up integration?
How to set up integration?
Register in your personal account: https://tads.me/register
Use the full integration guide to embed the widget into your app: https://tads.mintlify.app/start-pub
Use the full integration guide to embed the widget into your app: https://tads.mintlify.app/start-pub
Where I can see integration examples?
Where I can see integration examples?
TADS is integrated into 100+ Telegram Mini Apps. Here are a few examples:@dotcoin_bot
@hamster_fightclub_bot
@MatchMoney_gamebot
@space_adventure_game
@checkrewards_bot
@dreamcoin_bot
@BillyBobRobot
@hamster_fightclub_bot
@MatchMoney_gamebot
@space_adventure_game
@checkrewards_bot
@dreamcoin_bot
@BillyBobRobot
Where I can find my widget ID?
Where I can find my widget ID?
You can find the widget ID in your publisher dashboard → Widgets section → #ID column in the table.
Where can I find the Domain URL?
Where can I find the Domain URL?
The Domain URL is the website address where your Mini App is hosted. If you have access to BotFather, follow these steps:
- Open a chat with @BotFather
- Select your bot → Edit Menu Button → Set Web App
- Copy the URL listed in the Web App settings — this is your Domain URL
Why is no ad showing in my widget?
Why is no ad showing in my widget?
Here are the most common reasons:
- The widget is running locally or in a test environment.
The domain sending the requests must match the Domain URL linked to the widget in your personal account. You can register a new Site with a test Domain URL and temporarily link your widget to it. - Debug mode is enabled.
In this case, only test ads will appear. To receive real ads, set thedebugparameter tofalse - Event
adsNotFoundis triggered.
This means no ad is currently available. Other users may still see ads at that moment — ad availability is personalized based on targeting settings. You can handle this event in your own way using the documentation.
How can I block some ad categories?
How can I block some ad categories?
You can exclude specific categories in the Categories field when creating or editing a widget.
What affects my earnings?
What affects my earnings?
Your earnings depend on how actively users engage with ads. The more visible your widget is, and the more real users view or click on ads (depending on the widget format), the higher your revenue.Audience quality also matters — the more engaged and paying the users are, the higher the payout. For example, users with Telegram Premium or those located in Tier 1–2 countries typically generate higher revenue.
How do webhooks work?
How do webhooks work?
A Webhook URL is an endpoint on your side that receives GET or POST requests when a user views or clicks an ad (depending on the widget type). To set it up, provide the URL when creating or editing a widget in your dashboard.Full setup guide: https://tads.mintlify.app/webhooks
How often are payouts made?
How often are payouts made?
Payouts are processed monthly, within 15 days after the end of each calendar month (net 15).
How do I withdraw my earnings?
How do I withdraw my earnings?
To withdraw funds, send your wallet address to our manager.
The minimum payout amount is $50.
Also you can request to transfer the funds to your advertiser balance.
The minimum payout amount is $50.
Also you can request to transfer the funds to your advertiser balance.
Where can I get a referral code, and what are the terms?
Where can I get a referral code, and what are the terms?
Referral program terms:
- If you refer an advertiser:
You earn + **5% **of their ad spend for 3 months
The advertiser gets a + 5% bonus on their first top-up - If you refer a publisher (owner of Telegram Mini Apps):
You receive + 5% of their earnings for 3 months after they start using TADS widgets