上报有效用户

作为广告主，您最关心的是广告的转化率，也就是用户完成转化的比例。

我们建议您上报 Conversion 事件，这样可以有效地优化广告转化率。

上报转化事件 API

请求方法

POST https://app.ton.ai/api/v2/openapi/ad/event/report/conversion

请求参数

参数名	位置	类型	必填	描述
x-api-key	header	string	是	如何获取 APP Key

请求体应为 JSON 格式，包含以下字段：

字段名	类型	必填	描述
eventType	string	是	事件类型，固定值为 "conversion"
eventData	object	是	事件数据，包含以下字段

eventData 对象包含以下字段：

字段名	类型	必填	描述
telegramUserId	string	是	用户的唯一 Telegram ID

完整请求示例

发起请求：

curl --request POST \
     --url https://staging.ton.ai/api/v2/openapi/ad/event/report/conversion \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: YOUR_API_KEY_HERE' \
     --data '
{
  "eventType": "conversion",
  "eventData": {
    "telegramUserId": "1728125519"
  }
}
'

成功响应会返回上传成功的状态，状态码为 200。响应格式如下：

{
  "status": "success"
}

注意事项

1. 请确保在用户实际完成转化行为时才调用此 API。
2. 如果遇到网络问题导致上报失败，可以在短时间内重试，但不要过度重试。
3. telegramUserId 应该是用户的唯一 Telegram ID，不要使用其他标识符。