# TADS

> TADS is an advertising network for Telegram Mini Apps (TMA). Publishers add one widget to a Mini App and earn from CPC/CPM ads; advertisers buy performance traffic inside Mini Apps. Self-serve, payouts in USDT. Russian version: https://tads.me/ru/llms.txt. Full documentation in one file: https://tads.me/llms-full.txt

## Integrate the ad widget (for developers and AI coding agents)

Four steps, about 10 minutes.

1. Create a publisher account: https://tads.me/register?source=llms&intent=publisher
2. In the dashboard open Publisher → Sites and add your Mini App, then Publisher → Widgets → "Create Widget". Pick a format (see "Ad formats" below) and copy the numeric widget ID.
3. Add the SDK to the app: React package or plain `<script>` (both below).
4. Open the Mini App inside Telegram. Real ads are requested only when the app runs in Telegram; outside Telegram the SDK switches to debug mode with a test user and nothing is counted. Impressions and clicks appear in Publisher → Widgets → Analysis.

### React: react-tads-widget

```bash
npm install react-tads-widget
```

```jsx
// main.tsx / index.tsx — wrap the app once
import { TadsWidgetProvider } from 'react-tads-widget'

root.render(
  <TadsWidgetProvider>
    <App />
  </TadsWidgetProvider>
)
```

```jsx
// Text-Graphic Block: native image+text unit inside content, paid per click
import { TadsWidget } from 'react-tads-widget'

<TadsWidget
  id="YOUR_WIDGET_ID"
  type="static"
  debug={false}
  onClickReward={(adId) => { /* rewarded variant: give the user a bonus for the click */ }}
  onAdsNotFound={() => { /* hide the placeholder */ }}
/>
```

```jsx
// Fullscreen banner: opened by a user action, paid per impression
import { TadsWidget, renderTadsWidget } from 'react-tads-widget'

<TadsWidget
  id="YOUR_WIDGET_ID"
  type="fullscreen"
  debug={false}
  onShowReward={(adId) => { /* rewarded variant: bonus after the full view */ }}
  onAdsNotFound={() => {}}
/>
<button onClick={() => renderTadsWidget({ id: 'YOUR_WIDGET_ID', type: 'fullscreen' })}>
  Watch ad
</button>
```

Props: `id` (string, required), `type` (`'static'` | `'fullscreen'`, default `'static'`), `debug` (boolean, default false; `true` shows test ads and counts nothing), `onShowReward`, `onClickReward`, `onAdsNotFound`.

### Plain JavaScript, Vue, Svelte, any framework

```html
<script src="https://w.tads.me/widget.js"></script>

<!-- static format only: the ad renders into this container -->
<div id="tads-container-YOUR_WIDGET_ID"></div>

<script>
  const ad = window.tads.init({
    widgetId: YOUR_WIDGET_ID,      // number from the dashboard
    type: 'static',                // or 'fullscreen'
    debug: false,                  // true = test ads, nothing is counted
    onClickReward: (adId) => {},   // static, rewarded variant
    onShowReward: (adId) => {},    // fullscreen, rewarded variant
    onAdsNotFound: () => {}
  })

  // static: load once, then render into the container
  ad.loadAd()
    .then(() => ad.showAd())
    .catch(() => { /* no ad for this user right now */ })

  // fullscreen: showAd() alone, from a user action; it fetches the ad itself
  // document.getElementById('watch-ad').onclick = () => ad.showAd().catch(() => {})
</script>
```

Rules the SDK expects:
- Load `widget.js` before calling `window.tads.init`.
- For `fullscreen`, call `showAd()` alone from a user action (button, end of a level), not on page load. It fetches the ad itself, and the SDK rate-limits how often fullscreen ads can be shown.
- A widget is rewarded when you pass `onClickReward` or `onShowReward`; give the reward inside that callback only.
- One widget ID per placement. Two formats in one app need two widgets.
- Always handle `onAdsNotFound`: fill rate is never 100%, hide the placeholder or skip the reward flow.

## Ad formats

- Text-Graphic Block (TGB, `type: 'static'`): native image + text unit placed inside the app content, several ads can rotate in one widget. Paid per click (CPC). Rewarded variant: bonus for the click.
- Fullscreen banner (`type: 'fullscreen'`): Telegram-style fullscreen ad, one at a time, opened by a user action or at natural breaks (between levels, after "watch ad"). Paid per impression (CPM). Rewarded variant: bonus after the full view.

Details and examples: https://tads.gitbook.io/docs/resourses/ad-formats.md

## Account, payouts, requirements

- Publishers: free account, revenue in USDT (TRC-20), payout within 15 days after month end (Net15), requested via https://t.me/tads_manager.
- Advertisers: self-serve, minimum top-up $50 in USDT (TRC-20). Targeting: country, language, platform, Telegram Premium, Telegram Wallet, Telegram Gifts, traffic type, custom audiences.
- Webhooks: TADS calls your URL (GET or POST) on each view or click for server-side rewards: https://tads.gitbook.io/docs/getting-started/publishers/webhooks.md
- Moderation and creative requirements: https://tads.gitbook.io/docs/resourses/moderation.md, https://tads.gitbook.io/docs/resourses/ad-requirements.md

## Documentation (Markdown, agent-readable)

Index: https://tads.gitbook.io/docs/llms.txt

Publishers:
- [Getting started](https://tads.gitbook.io/docs/getting-started/publishers.md)
- [Register account](https://tads.gitbook.io/docs/getting-started/publishers/register-account.md)
- [Create widget](https://tads.gitbook.io/docs/getting-started/publishers/create-widget.md)
- [Embed widget: React](https://tads.gitbook.io/docs/getting-started/publishers/embed-widget/react.md)
- [Embed widget: Vanilla JS](https://tads.gitbook.io/docs/getting-started/publishers/embed-widget/vanilla-js.md)
- [Webhooks](https://tads.gitbook.io/docs/getting-started/publishers/webhooks.md)
- [Widget analysis](https://tads.gitbook.io/docs/getting-started/publishers/widget-analysis.md)
- [FAQ for publishers](https://tads.gitbook.io/docs/getting-started/publishers/faq-publishers/faq-en.md)

Advertisers:
- [Getting started](https://tads.gitbook.io/docs/getting-started/advertisers.md)
- [Launch ad](https://tads.gitbook.io/docs/getting-started/advertisers/launch-ad.md)
- [Ad targeting](https://tads.gitbook.io/docs/getting-started/advertisers/ad-targeting.md)
- [Ad analysis](https://tads.gitbook.io/docs/getting-started/advertisers/ad-analysis.md)
- [FAQ for advertisers](https://tads.gitbook.io/docs/getting-started/advertisers/faq-advertisers/faq-en.md)

Resources:
- [Ad formats](https://tads.gitbook.io/docs/resourses/ad-formats.md)
- [Payment](https://tads.gitbook.io/docs/resourses/payment.md)
- [Glossary](https://tads.gitbook.io/docs/resourses/glossary.md)

## Site

- [Home](https://tads.me/)
- [For advertisers](https://tads.me/advertiser?source=llms&intent=advertiser)
- [For publishers](https://tads.me/publisher?source=llms&intent=publisher)
- [Sign up](https://tads.me/register?source=llms)
- [Blog](https://tads.me/blog)
- [Russian blog](https://tads.me/ru/blog)

## Blog guides

- [Telegram Advertising Channels in 2026: Ads, Channels, Bots, and Mini Apps](https://tads.me/blog/telegram-advertising-channels-2026)
- [Telegram Ads vs Mini App Ads: What Should Advertisers Choose in 2026?](https://tads.me/blog/telegram-ads-vs-mini-app-ads)
- [How Much Does Telegram Advertising Cost in 2026?](https://tads.me/blog/telegram-advertising-cost-2026)
- [Telegram Mini App Audience in 2026: Who Uses TMAs and Why It Matters](https://tads.me/blog/telegram-mini-app-audience-2026)
- [Why Telegram Mini App Ads Can Have Higher CTR Than Web and Mobile](https://tads.me/blog/why-telegram-mini-app-ads-have-high-ctr)
- [How to Create and Monetize a Telegram Mini App: Checklist for 2026](https://tads.me/blog/create-and-monetize-telegram-mini-app)
- [Telegram Mini App Ads: A Practical Guide for Growth Teams](https://tads.me/blog/telegram-mini-app-ads)
- [How to Monetize a Telegram Mini App Without Hurting Retention](https://tads.me/blog/monetize-telegram-mini-app)
- [Каналы рекламы в Telegram в 2026: Ads, каналы, боты и Mini Apps](https://tads.me/ru/blog/telegram-advertising-channels-2026)
- [Telegram Ads vs реклама в Mini Apps: что выбрать рекламодателю в 2026](https://tads.me/ru/blog/telegram-ads-vs-mini-app-ads)
- [Сколько стоит реклама в Telegram в 2026 году](https://tads.me/ru/blog/telegram-advertising-cost-2026)
- [Аудитория Telegram Mini Apps в 2026: кто это и почему важно рекламодателям](https://tads.me/ru/blog/telegram-mini-app-audience-2026)
- [Почему CTR рекламы в Telegram Mini Apps может быть выше, чем в web и mobile](https://tads.me/ru/blog/why-telegram-mini-app-ads-have-high-ctr)
- [Как создать и монетизировать Telegram Mini App: чеклист на 2026](https://tads.me/ru/blog/create-and-monetize-telegram-mini-app)
- [Реклама в Telegram Mini Apps: практическое руководство для growth-команд](https://tads.me/ru/blog/telegram-mini-app-ads)
- [Как монетизировать Telegram Mini App и не ухудшить retention](https://tads.me/ru/blog/monetize-telegram-mini-app)

## Contact

- Telegram: https://t.me/tads_manager
- Company channel: https://t.me/tadsagency
- LinkedIn: https://www.linkedin.com/company/tadsme/