为 Web 落地页链接设置转化回传

注意

本节说明不适用于 Telegram Ads 广告活动。有关在 Telegram Ads 中为网页链接设置转化回传的说明，请参阅此部分。

参数：

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

  如何获取 token：

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

  

• record — 每次点击或展示的唯一值，对应 {record_data} 宏。AdsGram 会自动将该值插入追踪链接。

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

  goaltype 的使用方式：

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

如何设置转化回传：

1. 选择广告活动。 使用现有的进行中广告活动，或新建一个。
2. 配置广告链接。 确保链接中包含 {record_data} 宏。
3. 获取 token。 从 AdsGram 广告后台复制您的唯一令牌。
4. 设置回传发送。 当用户完成目标行为时，由您的服务器向 AdsGram 发送 API 请求。
5. 传递正确的转化类型。 如需区分漏斗阶段，请设置相应的 goaltype 值。
6. 检查集成。 按照下方 集成测试 部分的步骤操作，并确认转化已出现在 AdsGram 统计中。

API 请求示例：

GET
https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&record=7f3a1b6c5d2e4f8a&goaltype=2

本示例上报的是类型为 2 的转化（例如首次充值或购买）。

将 YOUR_UNIQUE_TOKEN 替换为您账户的令牌，将 7f3a1b6c5d2e4f8a 替换为广告链接中 {record_data} 宏的实际值。

返回结果： 200 OK — 表示转化记录成功。

集成测试

要测试转化追踪，请按以下步骤操作：

1. 创建或选择一个广告活动，并按照文档配置广告链接。确保链接中包含 {record_data} 宏。
2. 等待广告链接获得几次点击。
3. 手动发送一个带 goaltype=1 参数的测试回传。在 token 参数中填写有效的 token，在 record 参数中填写用户所点击广告链接中 {record_data} 宏的实际值。
4. 确认请求处理成功，且该转化已出现在所选广告活动的 AdsGram 统计中。

问题排查

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