上报有效用户
作为广告主,您最关心的是广告的转化率,也就是用户完成转化的比例。
我们建议您上报 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"
}
注意事项
- 请确保在用户实际完成转化行为时才调用此 API。
- 如果遇到网络问题导致上报失败,可以在短时间内重试,但不要过度重试。
- telegramUserId 应该是用户的唯一 Telegram ID,不要使用其他标识符。