API Reference

注册

在使用广告功能之前,请先完成注册。

创建 Campaign 任务

在 Campaign 页面,点击右上角的 Create Campaign。

  • 填写 Campaign Name、Destination 等信息。
  • 填写广告受众,支持以下筛选方式
    • 区域,语言
    • Telegram Premium
    • Wallet Balance & Token Balance
    • 其他 Ton Quest 平台支持的筛选方式
  • 填写 Budget 和出价
    • Daily Budget:每日限额,建议前期先用小金额测试
    • 出价:填写您的报价
  • 填写创意
    • 广告文案
    • Banner 可选项
    • Icon 可选项
  • 点击保存,即可成功创建 Campaign 任务。

创建 Campaign 任务后,需要等待管理员审核广告,广告审核通过后,点击 Action 里的开始按钮,Campaign 正式启动

数据统计

Campaign 开启后,其他流量主将展示您的广告,流量会陆续导入到您的 APP 中。

在 Ton AI 管理后台,您可以看到对应的 Campaign 任务的数据统计,显示了为您带来了多少用户。

计价模式

Ton AI 支持 oCPC 模式计费,按 Clicks 数据计费,但是提供 Conversion 优化 功能,这需要您上报 Conversion 事件

上报 Conversion 事件

您需要在新用户完成了指定动作后,例如

  • 注册
  • 入群
  • 打开 MiniAPP
  • KYC
  • 其他功能

上报 Conversion 事件,表明该用户是有效用户。

好处:

  • 系统会根据 Conversions 数据,计算转化率 CR。CR较高的客户,将得到更多的曝光,得到更好的投放效果。
  • 系统会根据 Conversions 数据构建 AI 模型,将广告曝光给更匹配的用户,最终提高转化率。

使用 SDK 上报 Conversion 转换事件:

import { SendTonAdConversion } from 'ton-ai-sdk';

SendTonAdConversion(campaignId: string);

SDK 会自动获取当前用户的 TelegramUserId

上报 Conversion 事件的好处

  1. 系统使用 Conversion 转换数据计算转换率 CR。CR 较高的客户将获得更多曝光和更好的广告位置。
  2. 系统基于 Conversion 转换数据建立 AI 模型,将广告曝光给更匹配的用户,最终提高转换率。