Telegram Ads 广告活动的转化追踪

Telegram Ads 广告活动中 Telegram 内部链接的转化追踪

在 Telegram Ads 广告活动中，指向 Telegram 内部目标的链接不支持 AdsGram 宏，宏也不会传递到这类广告链接中。因此，转化确认 API 无法用于追踪指向 Telegram Mini Apps（TMA）、机器人或频道的链接所带来的转化。

对于 Telegram Ads 广告活动中的 Telegram 内部链接，以下目标事件默认会自动计入 Goal 1：

• TMA — 启动 TMA；
• 机器人 — 启动机器人；
• 频道 — 订阅频道。

转化数据会自动传输，无需额外设置。

为 Telegram Ads 中的网页链接设置转化回传

参数：

• token — 与您的 AdsGram 账户绑定的唯一令牌。可在 AdsGram 后台获取，必要时可重新生成。

  如何获取 token：

  1. 打开 AdsGram 广告后台。
  2. 点击右上角的个人资料。
  3. 找到 token 参数，点击复制按钮 进行复制。

  

• campaignid — 转化所属的 AdsGram 广告活动 ID。对应广告链接中传递的 {campaign_id} 宏的值。用户点击链接时，AdsGram 会自动替换该宏的值。

• goaltype — 用于指定转化类型（即漏斗阶段）的参数，帮助区分不同的用户行为。该参数接受 1 到 3 的整数值。

  goaltype 的使用方式：

  1. 在您的产品或服务中定义转化漏斗的各个阶段。
  2. 将漏斗阶段映射到对应的 goaltype 值：
     • 1. 注册
     • 2. 首次充值 / 首次购买
     • 3. 二次（或多次）充值 / 复购
  3. 为用户路径中相关的阶段配置转化追踪。
  4. 在发送转化数据时，在 API 请求中加入 goaltype 参数。
  5. 在数据分析中使用该参数，按不同转化类型进行更精细的效果分析。

如何设置转化回传：

1. 选择 Telegram Ads 广告活动。 使用现有的进行中广告活动，或新建一个。
2. 配置广告链接。 确保链接中包含 {campaign_id} 宏。
3. 获取 token。 从 AdsGram 广告后台复制您的唯一令牌。
4. 设置回传发送。 当用户完成目标行为时，由您的服务器向 AdsGram 发送 API 请求。
5. 传递正确的转化类型。 如需区分漏斗阶段，请设置相应的 goaltype 值。
6. 检查集成。 按照下方 集成测试 部分的步骤操作，并确认转化已出现在 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} 宏。
2. 等待广告链接获得几次点击。
3. 手动发送一个带 goaltype=1 参数的测试回传。使用有效的 token，并在 campaignid 参数中填写测试广告活动的 ID。
4. 确认请求处理成功，且该转化已出现在所选广告活动的 AdsGram 统计中。

问题排查

• 转化已出现在统计中 — 集成已正确配置并正常工作。
• 服务器返回错误 — 请检查请求 URL 以及 token、campaignid 和 goaltype 参数的值。
• 请求成功，但转化未出现 — 统计数据每小时更新一次。如果一小时后数据仍未出现，请联系 AdsGram 支持或您的客户经理，并务必附上请求和响应日志。