---
title: "Telegram Ads 追踪：宏与转化回传"
description: "如何在 AdsGram 中追踪 Telegram Ads 广告活动：网页链接的宏、通过转化确认 API 设置转化回传，以及 Mini App、机器人和频道自动计入 Goal 1 的事件。"
outline: [2,4]
---
# Telegram Ads 追踪
为了更详细地追踪 Telegram Ads 广告活动的效果并正确归因目标行为的来源，建议使用**分析系统**。
## Telegram Ads 网页链接支持的宏
为了实现详细追踪，请使用宏。AdsGram 会在您的追踪链接中自动替换为真实数据。
- `{campaign_id}`
- `{banner_id}`
- `{publisher_id}`
- `{useragent}`
- `{click_id}`
- `{ip}`
- `{campaign}` — 广告活动名称
> [!IMPORTANT] 重要信息
> 此支持仅适用于 Telegram Ads 中的网页链接。在 Telegram Ads 广告活动中，指向 Telegram Mini Apps（TMA）、机器人或 Telegram 频道的链接仍不支持 AdsGram 宏。
::: warning 注意
要使转化确认 API 正常处理 Telegram Ads 广告活动中的网页链接，广告活动链接中必须包含 `{campaign_id}` 宏。如果缺少该必需宏，将无法进行转化追踪。
在 Telegram Ads 广告活动中，指向 Telegram Mini Apps（TMA）、机器人或频道的链接不支持 AdsGram 宏。因此，转化确认 API 无法用于追踪 Telegram Ads 广告活动中这类链接的转化。更多信息，请参阅下方的[Telegram Ads 广告活动中 Telegram 内部链接的转化追踪](#telegram-ads-广告活动中-telegram-内部链接的转化追踪)。
:::
> [!IMPORTANT] 重要信息
> 宏 `{publisher_id}` 仅作为唯一的流量主标识符展示 —— 不会包含其名称或其他身份信息。
广告活动链接示例：
```
https://your-tracker.com/?campaign={campaign_id}&banner={banner_id}&pub={publisher_id}&clickid={click_id}
```
后台会高亮显示已添加到链接的宏 
，以及缺失的宏 
。
## 为 Telegram Ads 中的网页链接设置转化回传
### 参数：
- `token` — 与您的 AdsGram 账户绑定的唯一令牌。可在 AdsGram 后台获取，必要时可重新生成。
**如何获取 token：**
1. 打开 AdsGram 广告后台。
1. 点击右上角的个人资料。
1. 找到 `token` 参数，点击复制按钮 
进行复制。
- `campaignid` — 转化所属的 AdsGram 广告活动 ID。对应广告链接中传递的 `{campaign_id}` 宏的值。用户点击链接时，AdsGram 会自动替换该宏的值。
- `goaltype` — 用于指定转化类型（即漏斗阶段）的参数，帮助区分不同的用户行为。该参数接受 1 到 3 的整数值。
##### goaltype 的使用方式：
1. 在您的产品或服务中定义转化漏斗的各个阶段。
1. 将漏斗阶段映射到对应的 goaltype 值：
- 1. 注册
- 2. 首次充值 / 首次购买
- 3. 二次（或多次）充值 / 复购
1. 为用户路径中相关的阶段配置转化追踪。
1. 在发送转化数据时，在 API 请求中加入 goaltype 参数。
1. 在数据分析中使用该参数，按不同转化类型进行更精细的效果分析。
### 如何设置转化回传：
1. **选择 Telegram Ads 广告活动。** 使用现有的进行中广告活动，或新建一个。
1. **配置广告链接。** 确保链接中包含 `{campaign_id}` 宏。
1. **获取 token。** 从 AdsGram 广告后台复制您的唯一令牌。
1. **设置回传发送。** 当用户完成目标行为时，由您的服务器向 AdsGram 发送 API 请求。
1. **传递正确的转化类型。** 如需区分漏斗阶段，请设置相应的 `goaltype` 值。
1. **检查集成。** 按照下方 **集成测试** 部分的步骤操作，并确认转化已出现在 AdsGram 统计中。
#### API 请求示例：
```
GET
https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&campaignid=72156&goaltype=2
```
本示例上报的是类型为 `2` 的转化（例如首次充值或购买）。
将 `YOUR_UNIQUE_TOKEN` 替换为您账户的令牌，将 `72156` 替换为您的广告活动 ID。
**返回结果：** `200 OK` — 表示转化记录成功。
### 集成测试
要测试转化追踪，请按以下步骤操作：
1. 创建或选择一个 Telegram Ads 广告活动，并按照文档配置广告链接。确保链接中包含 `{campaign_id}` 宏。
1. 等待广告链接获得几次点击。
1. 手动发送一个带 `goaltype=1` 参数的测试回传。使用有效的 `token`，并在 `campaignid` 参数中填写测试广告活动的 ID。
1. 确认请求处理成功，且该转化已出现在所选广告活动的 AdsGram 统计中。
### 问题排查
- **转化已出现在统计中** — 集成已正确配置并正常工作。
- **服务器返回错误** — 请检查请求 URL 以及 `token`、`campaignid` 和 `goaltype` 参数的值。
- **请求成功，但转化未出现** — 统计数据每小时更新一次。如果一小时后数据仍未出现，请联系 AdsGram 支持或您的客户经理，并务必附上请求和响应日志。
## Telegram Ads 广告活动中 Telegram 内部链接的转化追踪
在 Telegram Ads 广告活动中，指向 Telegram 内部目标的链接不支持 AdsGram 宏，宏也不会传递到这类广告链接中。因此，转化确认 API 无法用于追踪指向 Telegram Mini Apps（TMA）、机器人或频道的链接所带来的转化。
对于 Telegram Ads 广告活动中的 Telegram 内部链接，以下目标事件默认会自动计入 **Goal 1**：
- TMA — 启动 TMA；
- 机器人 — 启动机器人；
- 频道 — 订阅频道。
转化数据会自动传输，无需额外设置。