转化追踪

为了更详细地追踪广告活动的效果并正确归因目标行为的来源，建议使用分析系统。

AdsGram 可识别的宏类型：

为了实现详细追踪，请使用宏。AdsGram 会在您的追踪链接中自动替换为真实数据。

• {campaign_id}
• {banner_id}
• {publisher_id}
• {click_id}
• {record_data}

注意

要确保转换确认 API 正常工作，以下宏必须包含在广告活动的 URL 中：

• {record_data} - 对于 Web 落地页链接、Keitaro 和 Kochava 是必需的。
• {campaign_id} - 对于 Telegram 生态链接 是必需的。

如果必需的宏缺失，将无法进行转换追踪。

在 Telegram Ads 活动中，AdsGram 宏不受支持且不会传递到广告 URL。因此，转换确认 API 无法用于在 Telegram Ads 中运行的广告活动的转换追踪。

重要信息

宏 {publisher_id} 仅作为唯一的流量主标识符展示 —— 不会包含其名称或其他身份信息。

广告活动链接示例：

https://your-tracker.com/?campaign={campaign_id}&banner={banner_id}&pub={publisher_id}&clickid={click_id}&record={record_data}

重要提示：

如果你的落地链接是通过 start 参数打开 Telegram Mini App（TMA），请使用如下格式的链接，例如：

https://t.me/[机器人名称]?start=[唯一推荐链接]_{campaign_id}_{banner_id}_{publisher_id}_{click_id}_{record_data}

后台会高亮显示已添加到链接的宏 ，以及缺失的宏 。

转化确认 API

对于自定义分析系统或直接的服务器集成，可以使用 API。

API 接口：这是一个专门的 URL，当用户产生转化事件时，您的服务器会立即发起请求，从而使 AdsGram 能够实时接收活动结果数据。

Endpoint:

https://api.adsgram.ai/confirm_conversion

详细设置指南

• Telegram 生态追踪链接 — 适用于 Telegram 生态内的推广活动
• Web 落地页链接 — 适用于 Web 落地页的推广活动
• 合作方集成 — Adjust、AppMetrica、Keitaro 和 Kochava 的集成指南