---
title: "网页落地页追踪链接"
description: "了解如何为网页落地页设置 AdsGram 追踪链接，包括令牌、宏参数、goaltype 参数与转化测试。"
outline: [2,4]
---
# Web 落地页链接的追踪
为了更详细地追踪广告活动的效果并正确归因目标行为的来源，建议使用**分析系统**。

## AdsGram 可识别的宏类型：
为了实现详细追踪，请使用宏。AdsGram 会在您的追踪链接中自动替换为真实数据。
- `{campaign_id}`
- `{banner_id}`
- `{publisher_id}`
- `{useragent}`
- `{device_model}`
- `{click_id}`
- `{ip}`
- `{campaign}` — 广告活动名称
- `{os_version}`
- `{lang}`
- `{gaid}`
- `{idfa}`
- `{record_data}`

::: warning  注意
要使转化确认 API 正常工作，广告活动的 Web 落地页链接中必须包含必需的 `{record_data}` 宏。如果缺少该必需宏，将无法进行转化追踪。
:::

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

广告活动链接示例：
```
https://your-tracker.com/?campaign={campaign_id}&banner={banner_id}&pub={publisher_id}&clickid={click_id}&record={record_data}
```

后台会高亮显示已添加到链接的宏 <img src="../../images/icons/added_macros.png" alt="Added macros" width="18" style="display: inline" />，以及缺失的宏 <img src="../../images/icons/missed_macros.png" alt="Missed macros" width="18" style="display: inline" />。

![Selected macroses](./images/selected_macroses.webp =500x)

## 为 Web 落地页链接设置转化回传
> [!WARNING] 注意
> 本节说明不适用于 **Telegram Ads** 广告活动。有关为 Telegram Ads 中的网页链接设置转化回传的说明，请参阅 [Telegram Ads 追踪](./tg-ads-tracking-links#为-telegram-ads-中的网页链接设置转化回传) 部分。

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

  **如何获取 token：**
  1. 打开 AdsGram 广告后台。
  1. 点击右上角的个人资料。
  1. 找到 `token` 参数，点击复制按钮 <img src="../../images/icons/copy.png" alt="Copy" width="18" style="display: inline" /> 进行复制。

  ![Copy macros](./images/copy_macros.webp =200x)
- `record` — 每次点击或展示的唯一值，对应 `{record_data}` 宏。AdsGram 会自动将该值插入追踪链接。
- `goaltype` — 用于指定转化类型（即漏斗阶段）的参数，帮助区分不同的用户行为。该参数接受 1 到 3 的整数值。

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

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

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