前言

除了默认 SDK 自动上报模式，Ads3 还支持多种上报方式，您可以根据自己的需求选择合适的方式。

SDK 上报有效用户

前提

请参考 SDK 安装文档 完成 SDK 的初始化。

上报方法

如果您希望在用户完成指定动作时，手动上报有效用户，可以参考以下方法：

1. 在初始化 SDK 时，设置 disableDefaultConversion 为 true，禁用默认的上报机制。

import { TonAdInit } from 'ton-ai-sdk'

const result = TonAdInit({ appId: 'your-app-id', disableDefaultConversion: true})
console.log('TonAdInit', result)

2. 当用户完成指定动作时，上报 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 的依据。