> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://helpdesk.ezmob.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 跟踪宏和参数详解

跟踪宏是用花括号括起来的占位符，例如 `{country}`，当用户点击您的广告时，EZmob 会将其替换为实际值。将它们添加到素材的 **目标 URL** 中，您的跟踪工具或落地页就能知道每次点击的来源。

## 添加宏

1. 在广告活动的素材中，点击 **目标 URL** 字段旁的宏按钮（提示文字：**插入跟踪宏**）。
2. 在 **跟踪宏** 中点击某个宏，即可将其插入到光标位置。再次点击已插入的宏即可将其删除。
3. 为每个宏设置参数名，例如 `https://yoursite.com/landing?country={country}&device={device_type}`。

您可以在一个值中串联多个宏：`?source={pubfeed}_{subid}`。

## 可用宏

| 宏 | 替换为 |
|---|---|
| `{conversion}` | 点击 ID，转化跟踪必需 |
| `{campaign}` / `{offer}` / `{banner}` | 广告活动 ID / Offer ID / 广告 ID |
| `{bid}` | 点击成本（CPC，XML）或每次浏览成本（CPV，Display） |
| `{keyword}` | 匹配的关键词 |
| `{subid}` / `{original_subid}` / `{source_subid}` | 站长 Feed SubID / 不受限 SubID / 来源 SubID |
| `{source}` | 流量来源：`{pubfeed}.{original_subid}`（XML）或网站/应用 ID（Display） |
| `{publisher}` / `{pubfeed}` / `{pubpoint}` / `{pubzone}` / `{remfeed}` | 站长、Feed、Point、Zone 和远程 Feed 的 ID |
| `{site_id}` / `{app_id}` / `{app_bundle}` | 站长网站 ID / 应用 ID / 应用包名 |
| `{request_id}` / `{timestamp}` | 请求 ID / Unix 时间戳 |
| `{country}` / `{state}` / `{city}` / `{zip}` | 两位字母国家代码 / 地区 / 城市 / 邮政编码 |
| `{ip}` / `{carrier}` | 用户 IP / 运营商（ISP） |
| `{device_type}` / `{device_brand}` / `{device_model}` / `{ifa}` | 设备类型 / 品牌 / 型号 / 广告 ID |
| `{os}` / `{os_type}` / `{browser}` / `{user_agent}` | 操作系统 / 不含版本号的操作系统 / 浏览器 / User Agent |
| `{query}` / `{referrer}` / `{referrer_domain}` | 站长关键词 / 来源页 URL / 来源域名 |
| `{search_ip}` / `{search_referrer_domain}` | 搜索用户 IP / 搜索来源域名 |
| `{ga}` | 用于 Google Analytics |

`{pixel}` 等同于 `{conversion}`，`{pubid}` 等同于 `{subid}`。

## URL 规则

- 必须以 `http://` 或 `https://` 开头，并使用公共域名。`localhost` 和私有 IP 会被拒绝。
- 不能包含空格；请将空格编码为 `%20`。
- 宏区分大小写：`{country}` 有效，`{Country}` 无效。任何未在上表中列出的宏（例如 `{click_id}`）都会被拒绝。
- 每个花括号都必须闭合，不要留下空的 `{}` 或没有名称的参数。

如果 URL 校验失败，错误信息会显示在字段下方。对于空格、缺少 `https://`、空的 `{}` 或不支持的宏，系统会提供一键修复。

## Google Analytics

在目标 URL 中添加您自己的 UTM 参数，例如 `?utm_source=ezmob&utm_campaign={campaign}&utm_content={banner}`。

## 截图

![“转化跟踪”页面，显示“您的回传URL”](https://zjcgneywpnkgamzggapu.supabase.co/storage/v1/object/public/helpdesk-media/adv/ee6d5611-1.png)

![广告活动素材，“目标 URL”字段传递 clickid={conversion}](https://zjcgneywpnkgamzggapu.supabase.co/storage/v1/object/public/helpdesk-media/adv/e7b5d1e9-1.png)

*截图为英文界面。您可以将控制面板语言切换为中文。*

## 相关文章

- [如何使用 EZmob 回传（postback）跟踪转化](https://helpdesk.ezmob.com/zh/article/how-to-track-conversions-with-ezmobs-postback-ly0hss/)
- [使用 EZmob 像素跟踪转化](https://helpdesk.ezmob.com/zh/article/track-conversions-with-ezmob-pixel-1k562lf/)
- [广告活动创建完整指南](https://helpdesk.ezmob.com/zh/article/campaign-creation-the-complete-guide-fi9fb9/)
- [转化跟踪问题排查](https://helpdesk.ezmob.com/zh/article/troubleshooting-conversion-tracking-issues-1rm15ng/)