Registration
Please complete your registration before using the advertising features.
Create a Platform
A Platform represents your app or website. After creating a Platform, it needs to be moderated by Ton AI. Only Platforms that pass the moderation process can become traffic sources on Ton AI.
- App name: The name of your app
- Telegram direct link: The direct link to your Telegram app
- Web app URL: The URL to your application
Info
App owners can obtain the Telegram direct link using the command /myapps
via BotFather.
Prohibition of Gambling Ads
To request the removal of gambling ads from your site, contact us at our Telegram account @Ton_AI_Admin.
Create a Block
A Block represents an ad placement. You can create multiple Blocks to compare the performance of ads in different locations.
- Name: The name for your Block
- Reward Webhook URL: When a user clicks an ad (resulting in a click event being logged by the ad system), Ton AI will send a request to this URL, which is where you can implement your reward distribution.
- Billing: Choose your preferred billing method; multiple selections are allowed.
You can set a minimum price for each billing method, and ads below this price will not be displayed on your Platform.
Tips
If you want to show multiple ads on your site, we recommend creating multiple Blocks to evaluate the conversion performance of each.
Moderation
Each Platform must undergo moderation by Ton AI. Only Platforms that pass moderation can serve as traffic sources on Ton AI.
Tips
Before passing moderation, you will only receive test ads. Once approved, you will receive official ads.
Get BlockId
In the Platform details page, information for each Block is displayed, including a column for BlockId. You can copy it by clicking the copy button next to it.
Reward Webhook
Upon a user clicking an ad (which leads to the ad system capturing a click event), Ton AI will send a request to this URL for reward distribution implementation.
Request Method
POST
Request Parameters
Parameter Name | Location | Type | Description |
---|---|---|---|
adBlockId | query | string | Ad Block ID, obtainable from Platform -> Block -> ID |
openId | query | string | The unique ID of the user, such as telegramUserId |
type | query | string | The type corresponding to the openId, currently only 'telegram' is supported |
campaignId | query | string | Campaign ID |
x-api-key | header | string | The App Key of your account, used to validate the Key and prevent spoofing |
Important Notes
- The system may repeatedly request the Reward Webhook, so ensure your logic is idempotent, using campaignId for idempotency checks.
- You should authenticate and validate the App Key to prevent forgery.