转化追踪

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

AdsGram 可识别的宏类型：

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

• {campaign_id}
• {banner_id}
• {publisher_id}
• {useragent}
• {device_model}
• {click_id}
• {ip}
• {campaign} — 广告活动名称
• {os_version}
• {lang}
• {gaid}
• {idfa}
• {record_data}

Telegram Ads 网页链接的宏支持

Telegram Ads 广告活动中的网页链接现在也支持以下宏：

• {campaign_id}
• {banner_id}
• {publisher_id}
• {useragent}
• {click_id}
• {ip}
• {campaign} — 广告活动名称

重要信息

此支持仅适用于 Telegram Ads 中的网页链接。在 Telegram Ads 广告活动中，指向 Telegram Mini Apps（TMA）、机器人或 Telegram 频道的链接仍不支持 AdsGram 宏。

注意

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

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

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

在 Telegram Ads 广告活动中，指向 Telegram Mini Apps（TMA）、机器人或频道的链接不支持 AdsGram 宏。因此，转换确认 API 无法用于追踪 Telegram Ads 广告活动中这类链接的转化。有关 Telegram Ads 广告活动中 Telegram 内部链接的转化追踪，请参阅此部分。

重要信息

宏 {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 Ads 广告活动链接
• Telegram 生态落地链接
• Telegram 频道订阅者追踪
• Web 落地页链接
• 合作方集成 — Adjust、AppMetrica、Keitaro 和 Kochava 的集成指南