FAQ (EN)

Frequently asked questions about using our advertising platform for publishers.

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://docs.tads.me/getting-started/publishers

Where can I 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

Where can I 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?

The Domain URL is the website address where your Mini App is hosted. If you have access to BotFather, follow these steps:

1. Open a chat with @BotFather

2. Select your bot → Edit Menu Button → Set Web App

3. Copy the URL listed in the Web App settings — this is your Domain URL

If you don’t have access, ask the developer who configured the bot.

Why is no ad showing in my widget?

Here are the most common reasons:

1. 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.

2. Debug mode is enabled. In this case, only test ads will appear. To receive real ads, set the debug parameter to false

3. Event adsNotFound is 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: https://docs.tads.me/getting-started/publishers/embed-widget/react#id-3.-set-a-reward-if-needed

If everything looks correct and none of the above applies, please contact our support.

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?

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?

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://docs.tads.me/getting-started/publishers/webhooks

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?

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.

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

To get a referral code, contact our support.