> For the complete documentation index, see [llms.txt](https://tads.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tads.gitbook.io/docs/getting-started/publishers/faq-publishers/faq-en.md).

# FAQ (EN)

<details>

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

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>

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

<div align="left"><figure><img src="/files/zmBkglu5EIfyeKuL1T7n" alt=""><figcaption></figcaption></figure></div>

</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>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://tads.gitbook.io/docs/getting-started/publishers/faq-publishers/faq-en.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.