Advantages of Ton AI's Traffic Exchange Feature
- Comprehensive Data Insights: Gain a thorough understanding of traffic exchange through detailed statistics to optimize your advertising strategies.
- Fair Strategy: Utilize quotas to balance the number of imported and exported users.
- Efficient User Management: Leverage big data capabilities to automatically filter out duplicate users, ensuring that previously redirected users are not redirected again.
Registration
Before using the traffic exchange feature, please complete the registration process. Once registered, you will have access to all traffic exchange functionalities.
- Production Environment Registration
- Testing Environment Registration Please complete all function tests in the testing environment first.
Creating an Exchange Task
On the "Exchanges" page, click "Create Exchange" in the upper right corner.
- Enter the "Exchange Name".
- Enter the "Destination", which is the landing page for users. You can provide a link to a mini-program or select a Telegram group/channel.
- Fill in the ad creative:
- Ad Copy: It is recommended to use engaging copy within 50 characters.
- Banner: The image ratio should be 5:1, used for displaying ads by other partners.
- Icon: Used for displaying ads by other partners.
Click save to successfully create an Exchange task.
Exporting Traffic
You need to embed ads in your product to export traffic and earn quotas. With quotas, traffic (users) from other partners will flow into your product in the form of ads.
You can view the "User out" data statistics of the Exchange task, showing the cumulative number of exported users.
Ton AI uses a CPC (Cost Per Click) model to count traffic exchanges. Each time a user from your app clicks on an ad, the Clicks data and Earn (Quota) in the "User out" section will increase by 1.
Ton AI provides two ways to embed ads. Choose the one that best fits your product type.
Option 1: Seamless Product Integration
This method has a higher integration cost but offers a superior user experience.
Ton AI provides two APIs:
- Get Exchange Ads: Retrieve one or more exchange ads to embed in your product.
- Report Click Event: Report an event when a user clicks on an ad.
Please read the API documentation carefully for detailed request parameters and return values.
Using this method, you can embed ads anywhere in your product, such as packaging them as tasks in a task list to drive users to click on ads with rewards.
Ad effect example:
Important Notes
If you need to configure multiple ad positions, it is recommended to use the same ExchangeId for each position rather than creating multiple Exchanges.
Do Not Report Fake Click Events
Both parties' data will be reported to the Ton AI platform. If you report fake click events, it will lead to data discrepancies, and the system will impose penalties for such behavior.
Option 2: Banner Ads
This method has a lower integration cost but offers a poorer user experience and lower conversion rates.
First, follow the SDK Installation Guide to complete the SDK installation, then import the necessary SDK components:
import { TonExchangeBanner } from 'ton-ai-sdk';
import 'ton-ai-sdk/dist/index.css';
Choose a location in your mini-program to display the banner, ensuring the ad slot has a 5:1 aspect ratio, such as 400x80, and embed the TonExchangeBanner component in the corresponding HTML:
Note: EXCHANGE_ID is the ID of the Exchange task you created in the management console, which you can copy from there.
<div>
<!-- The div where you want to embed the SDK -->
<TonExchangeBanner exchangeId={exchangeId}></TonExchangeBanner>
</div>
The SDK will automatically fetch ads suitable for the current user and report click events to Ton AI.
Ad effect example:
Importing Traffic
When your quota is sufficient, other partners will display your ads, and traffic will gradually flow into your product.
In the Ton AI management console, you can view the "User In" data statistics of the Exchange task, showing the number of users brought to your product.
When the quota is exhausted, the system will automatically stop importing traffic, and you will need to export more users to gain more quotas.
Ton AI uses a CPC model to count traffic exchanges. Each click on your ad by a user from another partner will consume 1 quota.
Conversion (New User) Statistics
Project owners aim to acquire new users through traffic exchange. To achieve better results, you need to report new users to Ton AI, known as Conversion events.
In the frontend, call the SDK:
import { SendTonExchangeConversion } from 'ton-ai-sdk';
SendTonExchangeConversion(exchangeId: string);
The SDK will automatically retrieve the current user's TelegramUserId and report the Conversion event.
Conversion is Important
The system will use Conversion user characteristics to recommend more suitable users.
With Conversion data, the conversion rate (CR = Conversions / Clicks) of each partner's imported traffic can be calculated. Partners with higher CR will receive higher exposure priority.
Quota Control
When the quota drops to 0, the Exchange will be paused, and user import will stop, but user export will continue.
When the quota is restored to 100, the Exchange will resume to Ongoing status, and user import will also resume.
Each account in the testing environment will receive 1000 quotas for testing purposes.