Reporting Valid Users via SDK
As an advertiser, optimizing your ad conversion rate, which is the percentage of users who complete a conversion, is crucial.
If you are using oCPM or oCPC billing models for your advertising campaign, we recommend reporting valid users to effectively optimize the conversion rate.
When to Report Valid Users?
You can report valid users when they perform the following actions:
- User registration
- Opening a MiniAPP
- Completing a subscription or payment
- Completing identity verification (KYC)
- Other custom functions, etc.
Benefits of Reporting Valid Users
By using valid user data, the system builds AI models that target ads towards a more suitable audience, thereby enhancing overall conversion rates.
For instance, before conversion optimization, your ad might cost 10 USD, attracting 1000 Clicks, with only 50 becoming valid users.
The cost per converted user is 10/50 = 0.2 USD
After you report valid user data, our system can optimize by targeting more appropriate users. With the same 1000 Clicks, now 80 users become valid.
The cost per converted user is 10/80 = 0.125 USD
The customer acquisition cost decreases, enabling you to gain more valid users with the same budget. This illustrates the Optimization aspect of oCPC.
Reporting Valid Users via SDK
To easily report valid users, use the SDK provided by Ton.AI. Refer to the SDK Installation Guide to initialize the SDK.
Reporting method:
import { SendTonAdConversion } from 'ton-ai-sdk'
// Report a Conversion event when the user completes a specified action
if (userHasConverted) {
SendTonAdConversion()
}
Tips
In the Telegram Mini APP, the SDK automatically retrieves the current logged-in user's TelegramUserId. Alternatively, you can also provide your own ID.
import { SendTonAdConversion } from 'ton-ai-sdk'
const telegramUserId = '1234567890'
SendTonAdConversion(telegramUserId)
The reporting process is straightforward—simply call the SendTonAdConversion
method when the user completes the specified action.
Reporting Custom Events
Tips
Coming Soon: This feature is in development
If you're unsure about which event type to use for user conversion, you can report custom events:
import { SendTonAdConversion } from 'ton-ai-sdk'
// Report custom events
SendTonAdEvnt('onboard')
SendTonAdEvnt('register')
SendTonAdEvnt('play')
SendTonAdEvnt('payment')
SendTonAdEvnt('withdraw')
Later, when creating a Campaign, you can choose which event to base your Optimization on.
Offline Reporting
For offline Conversion event reporting, you can upload a CSV file.
For detailed procedures, please contact us.
FAQ
Why hasn't the conversion rate improved after reporting Conversion events?
- After reporting Conversion events, wait some time as the system processes the data for optimization. Typically, results can be observed within 3-4 days.
What happens if I opt for CPA billing but fail to report Conversion events due to system issues?
- If the system detects clicks for a sustained period without corresponding reported Conversion events, it will pause the ad delivery. Once Conversion events are reported, the system will automatically resume the campaign.
What are the consequences of choosing oCPM or oCPC without reporting Conversion events?
- The ads will still deliver as usual, but without reported Conversion events, the system can't optimize effectively, impacting ad performance.
How do I report Conversion events if my ad goal is to join a Telegram group Channel?
- When setting up your ad Campaign, add @PeaAI_Bot as an admin in the group Channel. This way, when a user joins the Channel through the ad, @PeaAI_Bot will automatically report a Conversion event.