Taboola 宏与原生广告网络URL参数:速查手册
连接你的广告支出与转化数据的关键是宏。这里是完整的 Taboola 宏集、Outbrain、MGID 和 Revcontent 的等效参数,以及那些会悄无声息破坏追踪的模板错误。

Taboola 宏是动态令牌——{click_id}、{site}、{campaign_id} 以及大约十几个其他宏——当有人点击你的广告时,Taboola 会用真实值替换它们。附加到你的着陆页URL后,它们能告诉你的追踪器,每一次访问和每一次转化具体是由哪个点击、哪个发布商广告位、哪个广告系列和哪个创意产生的。没有宏,你就是在盲目购买原生流量;有了它们,你可以在广告位级别计算每次转化成本,并砍掉亏损的部分。这份速查手册涵盖了 Taboola 上可用的宏集、Outbrain、MGID 和 Revcontent 上对应的动态参数,以及那些会悄无声息破坏所有平台追踪的几个模板错误。
为什么宏决定了你是否能进行优化#
原生广告网络按点击向你收费,但它们不会为你归因任何数据。你将做出的每一个优化决策——暂停这个广告位、提高这个出价、停用这个创意、扩大这个广告系列——都依赖于将网络的支出数据与你的转化数据关联起来。关联的关键就是宏。
标准设置是服务器到服务器追踪:
- 当你的广告被点击时,Taboola 用唯一值替换
{click_id}。 - 你的追踪器(或你自己的后端)将该点击ID与会话关联存储。
- 当访问者转化时,你用存储的点击ID触发网络的回传URL。
- 网络将转化归因于确切的点击——包括广告位、创意、地理位置、设备等所有信息——其竞价算法开始从真实转化而非原始点击中学习。
跳过宏,整个链条就不复存在。你会在分析工具中看到会话,在仪表盘中看到支出,但无法可靠地将它们联系起来。Taboola 也提供页面内像素,同时运行两者是值得的——但基于 {click_id} 的S2S回传能够抵御广告拦截器、iOS隐私功能和跨设备旅程,这就是为什么经验丰富的广告主将其视为真相来源。
Taboola 宏速查表#
Taboola 宏使用单花括号,全部小写。大多数媒体买家实际使用的有效宏集如下:
| 宏 | 返回内容 | 用途 |
|---|---|---|
{click_id} |
此点击的唯一ID | S2S关联键——必不可少 |
{site} |
发布商站点代码 | 广告位级优化和屏蔽 |
{site_id} |
数字站点ID | 相同功能,作为稳定的数字键 |
{site_domain} |
发布商域名 | 人类可读的广告位报告 |
{campaign_id} |
广告系列ID | 多广告系列报告 |
{campaign_name} |
广告系列名称 | 可读性报告(注意URL编码) |
{campaign_item_id} |
特定广告(创意)ID | 创意级优胜分析 |
{title} |
广告标题 | 标题级分析 |
{thumbnail} |
创意图片URL | 跨广告关联图片变体 |
{platform} |
设备平台 | 桌面/移动/平板电脑细分 |
{timestamp} |
点击时间戳 | 调试和分时段分析 |
一个完整的追踪URL示例如下:
https://track.yourdomain.com/click?clickid={click_id}&source={site_id}&camp={campaign_id}&ad={campaign_item_id}&device={platform}
两个实用注意事项。首先,宏区分大小写——{Click_ID} 会作为纯文本传递,你的追踪器会收到一个无用的字符串。其次,Taboola 会添加并偶尔重命名宏;上面的列表是稳定的核心集,但在大型投放前,请对照 Taboola 帮助中心 进行验证。如果你是首次端到端设置广告系列,Taboola 分步设置指南 展示了界面中追踪字段的位置。
Outbrain、MGID 和 Revcontent 上的相同概念#
每个原生广告网络都以不同的名称和语法实现了相同的四个概念——点击、广告位、广告系列、创意。对应关系如下:
| 概念 | Taboola | Outbrain | MGID | Revcontent |
|---|---|---|---|---|
| 语法 | {macro} |
{{macro}} |
{macro} |
{macro} |
| 点击ID | {click_id} |
{{ob_click_id}} |
{click_id} |
见仪表盘 |
| 广告位 | {site} / {site_id} |
{{publisher_id}} / {{section_id}} |
{widget_id} |
{widget_id} |
| 广告位名称 | {site_domain} |
{{publisher_name}} / {{section_name}} |
— | — |
| 广告系列 | {campaign_id} |
{{campaign_id}} |
{campaign_id} |
{boost_id} |
| 创意 | {campaign_item_id} |
{{ad_id}} / {{ad_title}} |
{teaser_id} |
{content_id} |
值得了解的细节:
- Outbrain 使用双花括号,其广告位模型是两级结构:发布商和版块——即该发布商上的特定小部件位置。在版块级别进行优化,而不仅仅是发布商级别;同一站点上文章下方的小部件和侧边栏的小部件表现可能完全不同。
- MGID 将创意称为“teasers”,因此是
{teaser_id}。其小部件ID是你每天需要屏蔽的单位。 - Revcontent 将广告系列组织为“boosts”,因此
{boost_id}是广告系列键。其宏列表多年来有所变化——请从你的仪表盘而非旧的论坛帖子中获取当前集合。 - 表格中的破折号表示该网络在广告系列结构级别处理该维度,或者宏变化过于频繁不便列出。如有疑问,请查阅网络当前文档而非猜测。
一个适用于所有四个网络的追踪模板#
在你自己的系统里进行标准化,而不是依赖它们的格式。定义规范的参数名称——例如 clickid、source、camp、ad——并将每个网络的宏映射到这些名称上:
Taboola: ?clickid={click_id}&source={site_id}&camp={campaign_id}&ad={campaign_item_id}
Outbrain: ?clickid={{ob_click_id}}&source={{section_id}}&camp={{campaign_id}}&ad={{ad_id}}
这样,你的追踪器、报告和屏蔽规则在所有地方都能一致工作,添加第五个网络也变成了一个五分钟的映射练习。通过专用的点击追踪域名路由点击,以便日后更换追踪软件时无需重建每个广告系列。
在模板中优先使用ID而非名称。{campaign_name} 和 {title} 包含空格、&符号和表情符号,这些会以URL编码形式到达——而标题中一个未编码的 & 会悄无声息地截断其后的所有参数。ID是稳定的;名称可能在投放中被编辑,从而将一行数据拆分成两行。
宏与UTM参数:两者并用,各司其职#
UTM标签用于你的分析工具;宏用于你的投放决策。一个合理的双重模板设置 utm_source=taboola、utm_medium=native,并动态填充其余部分——utm_campaign={campaign_id}、utm_content={campaign_item_id}、utm_term={site_id}——这样你的分析流量报告就能与追踪器的广告位报告对齐。只是不要仅凭分析数据进行优化:会话数和点击数会出现偏差(重定向、标签触发前跳出、脚本被拦截),而这种偏差恰恰在流量质量最差的地方——你最需要发现的那些广告位——最为严重。
五个悄无声息烧掉预算的宏错误#
- URL中出现字面宏。 一个拼写错误——错误的花括号、错误的大小写、多余的空格——意味着令牌从未被替换,你的着陆页收到的是纯文本
{click_id}。转化停止关联,广告系列“显示”零转化率,你可能会误杀一个潜在的赢家。每次投放后,检查前十个会话的查询字符串。 - 没有广告位宏。 模板中没有
{site}或{widget_id},你就无法构建广告位白名单和黑名单——而广告位筛选是大多数原生广告优化利润的来源。发布商和站点ID 是原生媒体购买的原子单位。 - 回传未去重。 如果同一个点击ID可以触发两次回传——页面刷新、重试逻辑、用户重新访问感谢页面——你就会重复计算转化并扩大亏损。在追踪器端根据点击ID进行去重。
- 使用名称而非ID。 投放中的广告系列重命名会拆分你的数据;见上文。
- 用真实预算测试。 使用网络的预览工具和在一个廉价地区的最低预算“金丝雀”广告系列来验证替换,而不是用你的投放预算。
解读竞争对手的宏#
追踪模板会泄露信息。当广告库追踪原生广告的点击路径时,捕获的着陆URL会保留广告主的参数字符串——宏已经被填充。在 Taboola 广告间谍工具 中拉取竞争对手的广告并检查追踪到的着陆URL:追踪器域名告诉你他们运行什么软件,子ID结构告诉你他们优化的粒度,而出现在子ID中的广告位ID则告诉你他们正在筛选广告位——这是一个值得研究的操作者的标志。从实时广告到其漏斗的完整工作流程,请参阅如何查找竞争对手着陆页。
核心要点#
宏是30分钟的设置工作,它决定了此后媒体购买的每一个小时是否可衡量。在第一天就将 {click_id} 和一个广告位宏放入你的模板,通过服务器到服务器回传转化,优先使用ID而非名称,并在扩大任何投放规模前验证替换。网络偶尔会重命名宏;但它们编码的四个概念——点击、广告位、广告系列、创意——十年来从未改变。




