前言
除了默认 SDK 自动上报模式,Ton AI 还支持多种上报方式,您可以根据自己的需求选择合适的方式。
SDK 上报有效用户
前提
请参考 SDK 安装文档 完成 SDK 的初始化。
上报方法
如果您希望在用户完成指定动作时,手动上报有效用户,可以参考以下方法:
- 在初始化 SDK 时,设置
disableDefaultConversion
为true
,禁用默认的上报机制。
import { TonAdInit } from 'ton-ai-sdk'
const result = TonAdInit({ appId: 'your-app-id', disableDefaultConversion: true})
console.log('TonAdInit', result)
- 当用户完成指定动作时,上报 Conversion 事件
import { SendTonAdConversion } from 'ton-ai-sdk'
if (userHasConverted) {
SendTonAdConversion()
}
提示
在 Telegram Mini APP 中,SDK 会自动获取当前登陆用户的 TelegramUserId,您也可以选择自己传入
import { SendTonAdConversion } from 'ton-ai-sdk'
const telegramUserId = '1234567890'
SendTonAdConversion(telegramUserId)
上报流程非常简单,只需要在用户完成指定动作时,调用 SendTonAdConversion
方法即可。
SDK 上报自定义事件
提示
Coming Soon 该功能即将开放
如果您还不确定要根据哪类事件类定义用户的转化,你可以选择上报自定义事件:
import { SendCommonEvent } from 'ton-ai-sdk'
// 上报自定义事件
SendCommonEvent('onboard')
SendCommonEvent('register')
SendCommonEvent('play')
SendCommonEvent('payment')
SendCommonEvent('withdraw')
然后在创建 Campaign 时选择使用哪个事件作为 Optimization 的依据。