# TADS — full documentation for AI agents

Generated 2026-09-22 from https://tads.gitbook.io/docs (Markdown pages). Short version with integration snippets: https://tads.me/llms.txt

Sign up: https://tads.me/register?source=llms

---

<!-- source: https://tads.gitbook.io/docs/about.md -->

# About Us

Our network is built to be a reliable partner in the world of Telegram Mini Apps (TMAs), providing brands and developers with effective tools to connect with their audiences.

By combining advanced technology with a clear understanding of user behavior, we create ads that feel natural and valuable to users (example below)

We’re proud to be trusted by partners and major brands who see us as a platform for growth. 

For now we have 100+ integrations, some of them:\
\
[@dotcoin\_bot](https://t.me/dotcoin_bot)\
[@hamster\_fightclub\_bot](https://t.me/hamster_fightclub_bot)\
[@MatchMoney\_gamebot](https://t.me/MatchMoney_gamebot)\
[@space\_adventure\_game](https://t.me/space_adventure_game)\
[@checkrewards\_bot](https://t.me/checkrewards_bot)\
[@dreamcoin\_bot](https://t.me/dreamcoin_bot)\
[@BillyBobRobot](https://t.me/BillyBobRobot)\ <br>

---

<!-- source: https://tads.gitbook.io/docs/getting-started/publishers.md -->

# For Publisher

These steps and instructions on following pages show how to install the TADS widget in TMA and earn money

### 1.  Initialize your Telegram Mini App

Before integrating the tads.me ad widget, make sure that you have initialized your application as described in the Telegram documentation: [**Initializing Mini Apps**](https://core.telegram.org/bots/webapps#initializing-mini-apps)

### 2. Register an account

Create your personal account and register your site (TMA) | [**Register Account**](https://docs.tads.me/getting-started/publishers/register-account)

### 3.  Create a widget

Choose your preferred placement method and add the widget to your account | [**Create Widget**](https://docs.tads.me/getting-started/publishers/create-widget)

### 4. Add the widget code in TMA

You can integrate the tads.me ad widget using either the [**React** ](/docs/getting-started/publishers/embed-widget/react.md)or [**native JavaScript**](https://docs.tads.me/getting-started/publishers/embed-widget/vanilla-js)

### 5. Earn money

Track your performance and earnings | [**Widget Analysis**](https://docs.tads.me/getting-started/publishers/widget-analysis)

---

<!-- source: https://tads.gitbook.io/docs/getting-started/publishers/register-account.md -->

# Register Account

To register an application, you need to sign up in the personal dashboard on our platform and add details about the site where the widgets will be displayed:

## 1. Register personal account

Fill in your registration details [on the website](https://tads.me/register?source=docs\&intent=publisher):

## 2. Register your site

Go to the Publisher section, then the Sites subsection. Click “Add site” and fill in the the name and address of your site where widgets will be displayed:

---

<!-- source: https://tads.gitbook.io/docs/getting-started/publishers/create-widget.md -->

# Create Widget

Our ad widget inserts ad content into the code area specified by the publisher. Follow the instructions below and create the widget in your app:

## 1. Decide how to display the ad

### General conditions

You can integrate the ad wherever it fits best in your application’s flow. This could be a screen component, a popup, or any other design element. We provide the ad content (images, text, etc.), while you control placement and styling.

### 1.1 Choose Ad formats

Сhoose one of these ad formats, or install both to increase your income (each format requires its own widget):

* Text-Graphic Block (TGB)

  Native text-and-image unit that integrates into app’s content for a seamless user experience. Multiple ads can be shown within one widget.
* Fullscreen Banner\
  Telegram-style fullscreen ad that aligns with interface and maximizes user engagement. Only one ad can be shown at a time.

Detailed descriptions of ad formats with examples can be found in our [documentation](https://docs.tads.me/resourses/ad-formats). 

### 1.2 Choose Integration options

Each ad format can be integrated into your app in different ways. It should be natively integrated into the user experience to feel natural and non-intrusive.\
Choose one option for each widget described below that best meet your app’s needs and objectives:

* Rewarded Ad\
  The user should receives a reward for interact with the ad:

  * for TGB ads — a reward is given for clicking the ad (CPC)
  * for Fullscreen ads — a reward is given for watching the entire ad (CPM)

  *Examples of rewards: additional attempts, in-app currency, boosters, or any other bonus suitable for your app.*
* Non-Rewarded Ad\
  The user does not receive any reward for interacting with the ad:
  * for TGB ads — the ad should be organically placed within the interface.\
    *For example, as a standalone ad block embedded into a content page.*
  * or Fullscreen ads — The ad should appear as a result of user action or at natural breakpoints in the flow.\
    *For example, after clicking a “watch ad” button or between game levels.*

## 2. Add widget in the account

In your personal dashboard go to the Publisher section, then to the Widgets subsection. Click the “Create Widget” button and specify the required parameters:

**Webhook URL** is the path for your webhook to receive a GET or POST request from TADS when user occurs a click or view event. [Learn more](/docs/getting-started/publishers/webhooks.md)

## 3. Get widget ID

Once the widget is created, a dashboard with a list of widgets will open, displaying the widget ID**.** You will need this widget ID in the next step — [embedding it into your code](https://docs.tads.me/getting-started/publishers/embed-widget)

---

<!-- source: https://tads.gitbook.io/docs/getting-started/publishers/embed-widget.md -->

# Embed Widget

After selecting the placement method and creating the widget in your account, embed the widget code into your app. You can integrate multiple widgets into a single app.

Integrate the tads.me ad widget using either the [**React package**](https://docs.tads.me/getting-started/publishers/embed-widget/react) or [**native JavaScript**](https://docs.tads.me/getting-started/publishers/embed-widget/vanilla-js) with following instructions.

***

## Styling

We give default CSS classes for images, titles, and description.

If any styles need to be changed to fit the appearance of the ad into the application's design, these styles are set in the application's code by the publisher. The classes and markup of the ad block are always fixed, so it will be sufficient to simply add styles to the corresponding classes in the page's code. The class names can be viewed in the code itself.

The number of ads shown in a widget is set when creating the widget in the ad network. You don’t have to specify this every time; it’s configured once in the widget’s settings. In the future, you’ll be able to manage this directly in your publisher dashboard.

<br>

---

<!-- source: https://tads.gitbook.io/docs/getting-started/publishers/embed-widget/react.md -->

# React

## 1. Insert widget code in the app

Install the [react-tads-widget](https://www.npmjs.com/package/react-tads-widget) package and initialize the widget:

#### Installation

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

#### Add widget init code in your index.js

```jsx
import { TadsWidgetProvider } from 'react-tads-widget';

root.render(
  <React.StrictMode>
    <TadsWidgetProvider>
        <App />
    </TadsWidgetProvider>
  </React.StrictMode>
);
```

#### Add widget ad show code in your React component using the following code example for the selected format:

### Text-Graphic Block (TGB)

```jsx
import React from "react";
import { TadsWidget } from 'react-tads-widget';

const PageWithAds: React.FC = () => {
    const rewardUserByClick = () => {
        console.log("User rewarded for click");
    };

    const onAdsNotFound = () => {
        console.log("Not found ads for this user");
    }

    return (
        <div className="container">
            <TadsWidget id="unique-widget-id" type="static" debug={false} onClickReward={rewardUserByClick} onAdsNotFound={onAdsNotFound} />
        </div>
    );
}

export default PageWithAds;
```

### Fullscreen banner

```jsx
import React from "react";
import { TadsWidget, renderTadsWidget } from 'react-tads-widget';

const PageWithAds: React.FC = () => {
    const rewardUserByShow = () => {
        console.log("User rewarded for impression");
    };

    const onAdsNotFound = () => {
        console.log("Not found ads for this user");
    }

    const showFullScreen = () => {
        renderTadsWidget({ id: 'unique-widget-id', type: 'fullscreen' })
    }

    return (
        <div className="container">
            <button onClick={showFullScreen}>SHOW FULLSCREEN</button>

            <TadsWidget id="unique-widget-id" type="fullscreen" debug={false} onAdsNotFound={onAdsNotFound} onShowReward={rewardUserByShow} />
        </div>
    );
}

export default PageWithAds;
```

## 2. Add your widget ID 

Replace YOUR\_WIDGET\_ID with the corresponding widget ID you received from your personal account.

## 3. Set a reward (if needed)

If you want to incentivize users to view or click on the ads, add code to the `onShowRewardCallback` and `onClickRewardCallback` and `onAdsNotFound` functions to reward the user for viewing and/or clicking, respectively.\
You can config your widget using the following parameters

<table><thead><tr><th width="160">Parameter</th><th width="97"></th><th width="104">Type</th><th width="102">Default</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>required</td><td>string</td><td></td><td>Your widget ID that you received from your personal account</td></tr><tr><td>type</td><td>required</td><td>string</td><td>static</td><td>Type of your widget. It can be 'static' or 'fullscreen'</td></tr><tr><td>debug</td><td>optional</td><td>boolean</td><td>false</td><td>Flag which you can use for development mode (it doesn't collect data in your ads account and doesn't requests real ads)</td></tr><tr><td>onShowReward</td><td>optional</td><td>function</td><td>null</td><td>Callback which will be called after user watches ad</td></tr><tr><td>onClickReward</td><td>optional</td><td>function</td><td>null</td><td>Callback which will be called after user clicks ad</td></tr><tr><td>onAdsNotFound</td><td>optional</td><td>function</td><td>null</td><td>Callback which will be called if we don't find ads for user</td></tr></tbody></table>

---

<!-- source: https://tads.gitbook.io/docs/getting-started/publishers/embed-widget/vanilla-js.md -->

# Vanilla JS

## 1. Insert widget code in the app

You can integrate the widget using native JavaScript. Add the following code to your project, ensuring that the tads script is loaded beforehand:

#### Insert the following script into \<head> or in the end of \<body>  in your HTML document:

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

#### Insert the following `<div>` where you want to render the ad (for the Text-Graphic Block only):

```html
<div id="tads-container-YOUR_WIDGET_ID"></div>
```

#### Add the following code for the selected format to your HTML document to initialize the widget:

### Text-Graphic Block (TGB)

```html
<script>
    const adsNotFoundCallback = () => {
        console.log('No ads found to show');
        // Write your code here in case we couldn't display ad
    };

    // Callback for REWARDED format
    const onClickRewardCallback = (adId) => {
        console.log('Clicked ad:', adId);
    };

    const adController = window.tads.init({
        widgetId: YOUR_WIDGET_ID,
        type: 'static',
        debug: false, // Use 'true' for development and 'false' for production
        onClickReward: onClickRewardCallback,
        onAdsNotFound: adsNotFoundCallback
    });

    adController.loadAd()
        .then(() => adController.showAd())
        .catch((err) => {
            console.log(err);
            adsNotFoundCallback();
        });
</script>
```

### Fullscreen banner

```html
<script>
    document.addEventListener("DOMContentLoaded", function() {
        const WIDGET_ID = YOUR_WIDGET_ID; // number from your dashboard

        // Use 'true' for development and 'false' for production
        const IS_DEBUG = false;

        // The id of the HTML element (button or link) that opens the ad on click.
        const BUTTON_ID = "your_button_id";

        // Callback for REWARDED format: called after the user watches the whole ad.
        const onShowRewardCallback = (adId) => {
            console.log('Ad watched, reward the user:', adId);
        };

        // Called when there is no ad to show right now.
        const onAdsNotFound = () => {
            console.log('No ads found to show');
        };

        const adController = window.tads.init({
            widgetId: WIDGET_ID,
            type: 'fullscreen',
            debug: IS_DEBUG,
            onShowReward: onShowRewardCallback,
            onAdsNotFound: onAdsNotFound
        });

        // showAd() fetches the ad itself and opens the fullscreen overlay.
        // Do not call loadAd() before it: that would request the ad twice.
        document.getElementById(BUTTON_ID).addEventListener('click', () => {
            adController.showAd().catch((err) => {
                console.log(err); // e.g. "No ads to show" or "Too many fullscreen ads in short time"
            });
        });
    });
</script>
```

<details>

<summary>Alternative widget code (async)</summary>

If you need to speed up page loading, you can use the alternative widget code that includes the `async` attribute. This setup method requires advanced setup and is recommended for experienced webmasters:

1. **Insert the following script into any place of your HTML document:**

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

2. **Insert the following `<div>` where you want to render the ad:**

```html
<div id="tads-container-YOUR_WIDGET_ID"></div>
```

3. **Add the following code  for the selected format after `<div>` to initialize the widget**

#### Text-Graphic Block (TGB)

```html
<script>
    const initTadsWidget = function() {
        const adsNotFoundCallback = () => {
            console.log('No ads found to show');
            // Write your code here in case we couldn't display ad
        };

        function initAdController() {
            const adController = window.tads.init({
                widgetId: YOUR_WIDGET_ID,
                debug: false, // Use 'true' for development and 'false' for production
                onShowReward: (adId) => {
                    console.log('Show ad:', adId);
                    // Write code here for reward user after ad showed or delete this func onShowReward
                },
                onClickReward: (adId) => {
                    console.log('Click on ad:', adId);
                    // Write code for reward user after ad cliked or delete this func onClickReward
                },
                onAdsNotFound: adsNotFoundCallback
            });

            adController.loadAd()
                .then(() => adController.showAd())
                .catch((err) => {
                    console.log(err);
                    adsNotFoundCallback();
                });
        }

        if (window.tads && window.tads.init) {
            initAdController();
        } else {
            let tadsInterval = setInterval(() => {
                if (window.tads && window.tads.init) {
                    clearInterval(tadsInterval);
                    initAdController();
                }
            }, 100);
        }
    };

    if (document.readyState === 'loading') {
    document.addEventListener('DOMContentLoaded', initTadsWidget);
    } else {
        initTadsWidget();
    }
</script>

```

#### Fullscreen banner

```html
<script>
  document.addEventListener("DOMContentLoaded", function () {
    const WIDGET_ID = "YOUR_WIDGET_ID"; // Replace on your WIDGET ID
    const IS_DEBUG = true; // Replace on false in production
    const BTN_ID = "your_clickable_selector"; // Replace on your button ID
    const TYPE = "fullscreen";

    let adController = null;
    let tadsReady = false;

    const onShowRewardCallback = (result) => {
      console.log("Show ads, reward user:", result);
    };

    const onAdsNotFound = () => {
      console.log("No ads found to show");
    };

    function waitForTadsReady(timeout = 5000) {
      return new Promise((resolve, reject) => {
        if (window.tads && typeof window.tads.init === "function") {
          return resolve();
        }

        const start = performance.now();
        const iv = setInterval(() => {
          if (window.tads && typeof window.tads.init === "function") {
            clearInterval(iv);
            resolve();
          } else if (performance.now() - start > timeout) {
            clearInterval(iv);
            reject(new Error("TADS widget script not loaded"));
          }
        }, 50);
      });
    }

    async function showAd() {
      try {
        if (!tadsReady) {
          await waitForTadsReady();
          tadsReady = true;
        }

        if (!adController) {
          adController =
            window.tads.controllers?.[WIDGET_ID] ||
            window.tads.init({
              widgetId: WIDGET_ID,
              type: TYPE,
              debug: IS_DEBUG,
              onShowReward: onShowRewardCallback,
              onAdsNotFound: onAdsNotFound,
            });
        }

        if (adController && typeof adController.showAd === "function") {
          adController.showAd().catch((err) => {
            console.error(`Error showing ad:`, err);
          });
        } else {
          console.warn("Ad controller not ready");
        }
      } catch (err) {
        console.error("Failed to load TADS:", err);
      }
    }

    const btn = document.getElementById(BTN_ID);
    if (!btn) {
      console.error("Button not found:", BTN_ID);
      return;
    }

    btn.addEventListener("click", showAd);
  });
</script>
```

</details>

## 2. Add your widget ID 

Replace YOUR\_WIDGET\_ID with the corresponding widget ID you received from your personal account.

## 3. Set a reward (if needed)

If you want to incentivize users to view or click on the ads, add code to the `onShowRewardCallback` and `onClickRewardCallback` and `onAdsNotFound` functions to reward the user for viewing and/or clicking, respectively.\
You can config your widget using the following parameters

<table><thead><tr><th width="160">Parameter</th><th width="97"></th><th width="104">Type</th><th width="102">Default</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>required</td><td>string</td><td></td><td>Your widget ID that you received from your personal account</td></tr><tr><td>type</td><td>required</td><td>string</td><td>static</td><td>Type of your widget. It can be 'static' or 'fullscreen'</td></tr><tr><td>debug</td><td>optional</td><td>boolean</td><td>false</td><td>Flag which you can use for development mode (it doesn't collect data in your ads account and doesn't requests real ads)</td></tr><tr><td>onShowReward</td><td>optional</td><td>function</td><td>null</td><td>Callback which will be called after user watches ad</td></tr><tr><td>onClickReward</td><td>optional</td><td>function</td><td>null</td><td>Callback which will be called after user clicks ad</td></tr><tr><td>onAdsNotFound</td><td>optional</td><td>function</td><td>null</td><td>Callback which will be called if we don't find ads for user</td></tr></tbody></table>

##

---

<!-- source: https://tads.gitbook.io/docs/getting-started/publishers/webhooks.md -->

# Webhooks

**Webhook URL** is the endpoint on your side that receives a GET or POST request from TADS when a user triggers an event. Optionally, you can add it when [creating a widget.](/docs/getting-started/publishers/create-widget.md)

The type of event that triggers the webhook is automatically defined by the widget format:

* For **TGB format**, the webhook is triggered **on ad click**.
* For **Fullscreen format**, the webhook is triggered **on ad view**.

Each POST request includes json object with the following data:

* **`telegram_id`** (string) – user Telegram  ID
* **`widget_id`** (string) – ID of the widget where the ad was shown/clicked

Please make sure your webhook handler expects **exactly the same parameter names and types** as listed above.

---

<!-- source: https://tads.gitbook.io/docs/getting-started/publishers/widget-analysis.md -->

# Widget Analysis

Track your performance and earnings using a Widgets dashboard that lists all your widgets:

It will display key metrics for the selected period: number of widgets, impressions, clicks, and revenue. Below is a table with detailed statistics for each widget. \
Detailed explanations of each metric you can see in the [glossary](https://docs.tads.me/resourses/glossary).

Your revenue will shown as a total for the selected period. Payout is calculated and issued in USDT within the first 15 days after the end of each calendar month (Net15). \
To provide your wallet details for the payout, please contact [@tads\_manager](https://t.me/tads_manager).

---

<!-- source: https://tads.gitbook.io/docs/getting-started/publishers/faq-publishers/faq-en.md -->

# FAQ (EN)

Frequently asked questions about using our advertising platform for publishers.

<details>

<summary>How to set up integration?</summary>

Register in your personal account: [https://tads.me/register](https://tads.me/register?source=docs\&intent=publisher)\
Use the full integration guide to embed the widget into your app: <https://docs.tads.me/getting-started/publishers>

</details>

<details>

<summary>Where can I see integration examples?</summary>

TADS is integrated into 100+ Telegram Mini Apps. Here are a few examples:

[@dotcoin\_bot](https://t.me/dotcoin_bot)\
[@hamster\_fightclub\_bot](https://t.me/hamster_fightclub_bot)\
[@MatchMoney\_gamebot](https://t.me/MatchMoney_gamebot)\
[@space\_adventure\_game](https://t.me/space_adventure_game)\
[@checkrewards\_bot](https://t.me/checkrewards_bot)\
[@dreamcoin\_bot](https://t.me/dreamcoin_bot)\
[@BillyBobRobot](https://t.me/BillyBobRobot)

</details>

<details>

<summary>Where can I find my widget ID?</summary>

You can find the widget ID in your publisher dashboard → **Widgets** section → **#ID** column in the table.

</details>

<details>

<summary>Where can I find the Domain URL?</summary>

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**](https://t.me/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.

</details>

<details>

<summary>Why is no ad showing in my widget?</summary>

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](https://t.me/tads_manager).

</details>

<details>

<summary>How can I block some ad categories?</summary>

You can exclude specific categories in the **Categories** field when creating or editing a widget.

</details>

<details>

<summary>What affects my earnings?</summary>

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.

</details>

<details>

<summary>How do webhooks work?</summary>

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>

</details>

<details>

<summary>How often are payouts made?</summary>

Payouts are processed monthly, within 15 days after the end of each calendar month (net 15).

</details>

<details>

<summary>How do I withdraw my earnings?</summary>

To withdraw funds, send your wallet address to [our manager](https://t.me/tads_manager). The minimum payout amount is $50.\
Also you can request to transfer the funds to your advertiser balance.

</details>

<details>

<summary>Where can I get a referral code, and what are the terms?</summary>

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](https://t.me/tads_manager).

</details>

---

<!-- source: https://tads.gitbook.io/docs/getting-started/advertisers.md -->

# For Advertiser

Follow a few simple steps to reach your audience with TADS

### 1.  Create an Account and Launch your Ad

Set up your account and start your ad campaign to drive quality traffic | [Launch Ad](https://docs.tads.me/getting-started/advertisers/launch-ad)

### 2. Analyze and Optimize

Manage your ad placements and refine your targeting to achieve the best possible results | [Ad Analysis](#id-2.-analyze-and-optimize)

---

<!-- source: https://tads.gitbook.io/docs/getting-started/advertisers/launch-ad.md -->

# Launch Ad

## 1. Register personal account

Fill in your registration details [on the website](https://tads.me/register?source=docs\&intent=advertiser):

## 2. Create Ad

Click the "Create Ad" in your advertiser’s dashboard:

Choose the type of your Ad:

* Text-Graphic Block - native ad block with text and image that integrates into app’s content 
* Fullscreen banner - fullscreen ad styled as a Telegram message, seamlessly integrated to boost user attention

You can find all about available formats and examples [here](https://docs.tads.me/resourses/ad-formats). 

Upload an image and fill in the ad details:

Fill in the required fields below:

* URL - a destination URL
* Ad Category - the subject of the ad, not the placement of the ad
* User-Defined CPM/CPC - your base CPC or CPM (depends on the ad format). This cost serves as the starting point for calculations of impression/click costs, taking into your targeting criteria. The calculated value is displayed in the “Final CPC/CPM” field.

## 3. Define Limits

You can define any necessary campaign limits for your ad:

* Daily views limit per user - how many times the same user can see the ad per day
* Budget limit for Ad - total budget for the entire campaign.
* End Date — the final day the ad will run.

The ad will stop automatically when the budget limit is reached or the end date is passed.

## 4. Choose Targeting options

Choose your targeting options:

Some of targeting options has its own coefficient that affects the final price used in the auction. You can read more about all targeting parameters [here](/docs/getting-started/advertisers/ad-targeting.md).

## 5. Exclude or target Audience

[How to enable Audience targeting](/docs/getting-started/advertisers/ad-targeting/audience.md)

Choose one of the following targeting options:

* Exclude audience – your ad will not be shown to these users (target new users)
* Target audience – your ad will be shown only to these users

Combining this targeting with others (country, locales, etc.) may significantly reduce the available reach. If your ad shows very low delivery after launch, consider turning off additional targeting to expand your audience.

## 6. Save and launch Ad

Finally click "Create Ad" and [top up your balance](https://docs.tads.me/resourses/payment). We recommend starting with a minimum budget of $300.

After creating, the ad will then be submitted for [moderation](https://docs.tads.me/resourses/moderation). \
It initially appears on the dashboard with a "Review" [status](https://docs.tads.me/getting-started/advertisers/ad-statuses). Once it passes moderation, its status changes to "Hold".\
At that point, you must manually launch the ad from the dashboard:

***

## Editing Ad Settings

You can update your ad settings at any time. Changing the creative or category sends it back to moderation. Adjusting CPC/CPM or targeting does not require re-approval — just save your changes, and the campaign continues with the updated parameters.

---

<!-- source: https://tads.gitbook.io/docs/getting-started/advertisers/ad-targeting.md -->

# Ad Targeting

In order to effectively tailor your advertising campaign to the right audience, our platform provides a variety of targeting options. These options allow you to narrow down who sees your ads based on user location, language, device type, and more. 

The pages below provide an overview of the different targeting types available in your advertiser account:

* [Location: сountry and city](https://docs.tads.me/getting-started/advertisers/ad-targeting/country)
* [Locales ](https://docs.tads.me/getting-started/advertisers/ad-targeting/locales)
* [Platforms](https://docs.tads.me/getting-started/advertisers/ad-targeting/platforms)
* [Gender](https://docs.tads.me/~/revisions/9dHJqE0GPQshvde09x6j/getting-started/advertisers/ad-targeting/gender)
* [Telegram Gifts](https://docs.tads.me/~/revisions/WIpY8vCOv1vfFqJd2985/getting-started/advertisers/ad-targeting/telegram-gifts)
* [Telegram Wallet](https://docs.tads.me/getting-started/advertisers/ad-targeting/user-spending-power)
* [Telegram Premium](https://docs.tads.me/getting-started/advertisers/ad-targeting/telegram-premium)
* [Traffic Type](https://docs.tads.me/getting-started/advertisers/ad-targeting/motivated-rewarded) 
* [Audience](https://docs.tads.me/getting-started/advertisers/ad-targeting/audience)

---

<!-- source: https://tads.gitbook.io/docs/getting-started/advertisers/ad-analysis.md -->

# Ad Analysis

After your ad passes moderation and is launched, data will begin appearing in the dashboard. Metrics may take up to an hour to update, so initial results might not be visible right away.

Currently, there are two available dashboards:

* Overall statistics for the selected period
* A daily breakdown, either for all ads or a specific one

Detailed explanations of each metric you can see in the [glossary](https://docs.tads.me/resourses/glossary).

<br>

---

<!-- source: https://tads.gitbook.io/docs/getting-started/advertisers/ad-statuses.md -->

# Ad Statuses

* **Review** - the ad has been created and is currently under moderation.
* **Rejected** - the ad did not pass moderation. If you disagree with the decision or need more information, contact [@tads\_manager](https://t.me/tads_manager).
* **On hold** - the ad has passed moderation but is paused until you choose to launch it, or it has been stopped manually.
* **Active** - the ad is running and being shown to users.

---

<!-- source: https://tads.gitbook.io/docs/getting-started/advertisers/faq-advertisers/faq-en.md -->

# FAQ (EN)

Frequently asked questions about using our advertising platform for advertisers.

<details>

<summary>How to launch an ad campaign?</summary>

Register in your personal account: [https://tads.me/register](https://tads.me/register?source=docs\&intent=advertiser)\
Use the full integration guide to embed the widget into your app: <https://docs.tads.me/getting-started/advertisers/launch-ad>

</details>

<details>

<summary>Where will my ads be shown?</summary>

We work with 100+ Telegram Mini Apps. Here are a few examples:

[@dotcoin\_bot](https://t.me/dotcoin_bot)\
[@hamster\_fightclub\_bot](https://t.me/hamster_fightclub_bot)\
[@MatchMoney\_gamebot](https://t.me/MatchMoney_gamebot)\
[@space\_adventure\_game](https://t.me/space_adventure_game)\
[@checkrewards\_bot](https://t.me/checkrewards_bot)\
[@dreamcoin\_bot](https://t.me/dreamcoin_bot)\
[@BillyBobRobot](https://t.me/BillyBobRobot)

</details>

<details>

<summary>What bidding models are available?</summary>

The bidding model depends on the ad format:

*  Text-Graphic Block uses CPC (cost per click)
* Fullscreen Banner uses CPM (cost per 1,000 impressions)

</details>

<details>

<summary>How to choose the optimal bid?</summary>

When setting up a campaign, you start by entering your own bid. After configuring targeting, the platform will display the final bid based on your selected parameters.\
You can launch the campaign at this rate and increase it later to get more traffic if needed.

For narrow targeting, it's recommended to set a bid above the suggested minimum to increase your chances of winning auctions.

</details>

<details>

<summary>How long does ad moderation take?</summary>

Moderation usually takes 1-3 hours on weekdays and 3-5 hours on weekends.\
Our moderation team operates between 06:00 and 18:00 UTC.

</details>

<details>

<summary>Why was my ad rejected?</summary>

Ad may be rejected if it doesn’t comply with our content policies. The full list of rejection reasons is available here: <https://docs.tads.me/resourses/moderation>

The specific number of the reason will be shown next to the ad status in your dashboard.

</details>

<details>

<summary>Why isn’t my ad being shown?</summary>

First, check that the ad status is **Active** and your account has sufficient balance, and the end date hasn’t passed.

If you’ve applied narrow targeting (e.g. uncommon geo or language and Telegram Premium users), your potential audience may be too limited. Try to expand your targeting settings to increase reach.

If everything is correct and the ad still isn’t serving, contact [our support](https://t.me/tads_manager).

</details>

<details>

<summary>How much new audience can I reach?</summary>

The volume of new users you can reach depends on many factors — such as your campaign strategy, product type, and how fast your landing page loads.

To exclude current users from targeting, you can use audience targeting filters.\
Learn more here: <https://docs.tads.me/getting-started/advertisers/ad-targeting/audience>

</details>

<details>

<summary>How does the ad category work?</summary>

The category defines the topic of your ad and ensures it’s only shown in apps that allow this type of content.

</details>

<details>

<summary>How to top up my balance?</summary>

You can top up your advertiser balance in the personal account.\
We accept payments in USD₮ on the TRC20 network only. For other networks, please contact [our support](https://t.me/tads_manager).

</details>

<details>

<summary>What if the funds haven’t been credited?</summary>

Make sure the payment was sent using the TRC20 network. In most cases, funds are credited within 2 hours.

If you used a different network by mistake, or if the transfer is delayed, please contact [our support](https://t.me/tads_manager).

</details>

<details>

<summary>Where can I get a referral code, and what are the terms?</summary>

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](https://t.me/tads_manager).

</details>

---

<!-- source: https://tads.gitbook.io/docs/resourses/ad-formats.md -->

# Ad Formats

## **TGB (Text-Graphic Block)**

An ad in the form of a TGB has the following format requirements:

* **Image**: 128x128, format webp/jpeg/png, size up to 50kb
* **Title**: up to 30 characters
* **Description**: up to 60 characters
* **Link**: any length (we recommend using UTM tags and other methods to track the traffic received through it)

Our ad widget inserts the content of the ads into the part of the code specified by the publisher. This can be a component on the screen, a popup window, or another design solution – in all cases, we insert the content, and the placement method is implemented on the publisher's side.

## Fullscreen Banner

An ad in the form of a Fullscreen banner has the following format requirements:

* **Image**: 300x300, format webp/animated webp/jpeg/png, size up to 200kb
* **Title**: up to 60 characters
* **Description**: up to 160 characters
* **Link**: any length (we recommend using UTM tags and other methods to track the traffic received through it)

---

<!-- source: https://tads.gitbook.io/docs/resourses/ad-requirements.md -->

# Ad Requirements

General TADS Requirements for Ad Content for All Ad Formats

## What Can Be Advertised

* Applications and Games: Advertising mobile applications and games, especially those that comply with Google Play and Apple App Store guidelines.\
  *Examples: mobile games, utilities, social applications.*
* E-commerce and Online Stores: Promoting online stores, offers, and discounts on products.\
  *Examples: Amazon, eBay, clothing stores, electronics stores.*
* Educational Courses and Webinars: Selling courses, seminars, and educational programs.\
  *Examples: online programming courses, language courses.*
* Productivity Services and Applications: Applications and services that help improve productivity and organization.\
  *Examples: task managers, calendars, note-taking applications.*
* Financial Services: Promoting legal financial services and products.\
  *Examples: banking applications, finance management applications.*

## What Cannot Be Advertised

* Illegal Content: Any content that violates laws.\
  *Examples: sale of drugs, weapons, fake documents.*
* Pornography and Adult Content: Any sexually explicit content, including pornography.\
  *Examples: adult websites, escort services.*
* Fraudulent and Deceptive Offers: Any schemes that may mislead or deceive users.\
  *Examples: pyramid schemes, fake lotteries.*
* Violence and Hate Content: Incitement to violence, discrimination, and hate.\
  *Examples: extremist materials, incitement to ethnic hatred.*
* Intellectual Property Infringement: Advertising goods or services that violate copyrights or trademarks.\
  *Examples: sale of counterfeit goods, unlicensed software.*

---

<!-- source: https://tads.gitbook.io/docs/resourses/moderation.md -->

# Moderation

All ads should pass moderation after creating. Moderation generally takes 1–3 hours on weekdays and 3–5 hours on weekends. The moderation team is active from 06:00 to 18:00 UTC.

## Ads may be rejected for the following reasons

1. The ad does not comply with the service’s terms and conditions
2. Incorrect category specified for the ad
3. The ad contains broken links
4. Channel/bot/TMA is empty or inactive: regular activity is required
5. Issues with display on certain devices
6. Ad contains incorrect information: title, description or image
7. Asset is not loading or unavailable in target countries
8. Functionality of the advertised site/bot/TMA is broken or not working properly
9. Advertised content does not match the promoted product
10. The ad contains offensive or illegal content

<br>

---

<!-- source: https://tads.gitbook.io/docs/resourses/payment.md -->

# Payment

The system only supports USD₮. 

## Top up

To top up your advertiser balance, click the Top up button in your dashboard’s top panel. In the pop-up dialog, enter the amount and create an invoice for transfer. You will be redirected to a third-party site to complete payment.

Minimum top-up amount is $50. However, if you’re starting a new ad campaign from scratch, we recommend at least $300 to get better results.

We accept only USDT (TRC-20), so please ensure you select the TRC-20 network to avoid failed or lost transfers. 

If you have any problems with payment, please contact your manager at [@tads\_manager](https://t.me/tads_manager).

## Receive

To receive payments as a publisher, please contact [@tads\_manager](https://t.me/tads_manager) and specify the wallet to make the transfer. Payout is issued within the first 15 days after the end of each calendar month (Net15).

---

<!-- source: https://tads.gitbook.io/docs/resourses/glossary.md -->

# Glossary

### Roles

* Advertiser — a person or company who creates and pays for ads to promote products, services, or content.
* Publisher — a person or company who integrates ads into their app, earning revenue from user interactions with ads.

### General Settings

* URL — the web address of Telegram Mini App.
* Category - the subject of the ad. Advertisers select a category for their ads, while publishers set restrictions on which categories are allowed in their widgets.
* Country/City — a geographic location used for ad targeting, specified by the user’s region.
* Locales — users language, used to target ads during ad creation.
* Platform — environments where advertisements are displayed, such as iOS, Android, and web.
* Budget — the amount of money allocated for running ad campaigns over a full period.
* USD₮ — Tether (USD₮) is a stablecoin pegged to the US dollar exchange rate in a 1:1 ratio, used to simplify cryptocurrency trading and minimize volatility.

### Dashboards

* Clicks — the number of times users interact with an ad by selecting it.
* Impressions — the number of times an ad is displayed to users.
* CTR (Click-Through Rate) — the percentage of impressions that result in clicks (Clicks/Impressions \* 100).
* CPC (Cost Per Click) — a pricing model where the advertiser pays each time a user clicks an ad.
* CPM (Cost Per Mille) — a pricing model where the advertiser pays per thousand impressions.
* Site - Telegram Mini App where ads are placed.
* Widget — an ad unit integrated into an app, used to display one or more ads to users.