VAST 宏展开器
在跟踪 URL 中展开 IAB VAST 4.x 宏并预览触发的请求,直接在你的浏览器中完成。粘贴的标签留在你的设备上。
VAST 宏展开器完全在你的浏览器中运行。你粘贴的跟踪 URL、同意字符串和设备标识符都在你的设备上解析,绝不会上传到 ArrayKit 或发送到任何广告服务器。
关于 VAST 宏展开器
VAST 宏展开器把视频广告跟踪 URL 中的占位符标记变成一个真实、已触发的请求,让你能准确看到播放器将发送什么。粘贴一个含 IAB VAST 4.x 宏的 impression、四分位或 error 像素——[CACHEBUSTING]、[TIMESTAMP]、[GDPR]、[GDPRCONSENT]、[US_PRIVACY]、[IFA]、[PAGEURL] 等——工具会替换为示例值或你自己的覆盖值,并即时生成一个随机的 cache-buster 和一个 ISO 时间戳。一份可搜索的参考解释每个宏及其类别。由于 ad-ops 的 URL 常常携带同意字符串和设备标识符,一切都在你的设备上运行:你粘贴的标签在你的浏览器中解析,绝不发送到任何服务器。
功能特性
- 在粘贴的 impression、跟踪或 error URL 中展开每一个 IAB VAST 4.x 宏
- 在触发时自动生成随机的 [CACHEBUSTING] 数字和 ISO 8601 的 [TIMESTAMP]
- 可编辑行让你用自己的值覆盖任意已识别的宏
- 「重新生成」按钮会重新掷出动态 cache-buster 并刷新时间戳
- 标出并非 VAST 宏的方括号标记,并保持其不变
- 针对 [IFA]、[GDPRCONSENT]、[GPP] 和 [ADCOUNT] 等宏的可搜索参考
- 一键复制整个展开后的 URL 或任意单个宏标记
- 完全在你的浏览器中运行——粘贴的标签和同意字符串留在你的设备上
如何使用 VAST 宏展开器
- 保持选中「展开 URL」标签页
- 粘贴一个含 VAST 宏的跟踪或 impression URL
- 编辑任意已识别的宏值,或点击「重新生成」获取新的 cache-buster 和时间戳
- 复制展开后的 URL,或切换到「宏参考」查询某个标记
示例
输入
https://ad.example.com/i?cb=[CACHEBUSTING]&ts=[TIMESTAMP]&gdpr=[GDPR]
输出
https://ad.example.com/i?cb=12345678&ts=2025-03-04T05:06:07.000Z&gdpr=1
[CACHEBUSTING] 变为随机整数,[TIMESTAMP] 变为 ISO 时间,[GDPR] 变为其示例值。
常见错误与故障排除
- 触发的 URL 中仍原样显示 [SOMETHING]。 — 该标记不是已识别的 VAST 4.x 宏,因此保持原样。宏是大写的,例如 [CACHEBUSTING]——请检查拼写和大小写,或自己输入其值。
- 当我打开展开后的链接时,同意字符串或页面 URL 看起来是坏的。 — 播放器在触发前会对 [GDPRCONSENT] 和 [PAGEURL] 之类的值进行 URL 编码。本预览按字面替换它们,因此若你的端点需要,请自行进行百分号编码。
- 每次预览我的 cache-buster 都相同。 — 预览为每个 URL 生成一个值。点击「重新生成」以掷出新的随机 [CACHEBUSTING] 并刷新 [TIMESTAMP]。
- 广告服务器忽略了我的 [IFA] 值。 — [IFA] 应与 [IFATYPE] 配对,且仅在 limit-ad-tracking 允许时发送。请确认设备在填充该宏之前确实传递了标识符。
常见问题
- 什么是 VAST 宏?
- VAST 宏是视频广告跟踪 URL 中位于方括号内的大写标记,例如 [CACHEBUSTING] 或 [GDPRCONSENT]。视频播放器或广告服务器会在像素触发的那一刻用真实值替换它。
- 展开器会自动生成哪些宏?
- [CACHEBUSTING] 和 [TIMESTAMP] 是动态的:工具会构建一个随机的 8 位 cache-buster 和一个 ISO 8601 UTC 时间戳。其余每个宏使用一个内置示例值,你可以覆盖。
- 该工具会抓取广告标签或真的触发跟踪 URL 吗?
- 不会。它绝不发起网络请求。你粘贴 URL,宏替换在你的浏览器中本地进行,因此不会向任何服务器抓取、触发或记录任何内容。
- 为什么输出中某个标记未被展开?
- 只有规范的大写 VAST 4.x 宏才会被替换。其他任何东西——拼写错误、小写标记或自定义占位符——都会被报告为未知并原样传递。
- 它会对替换的值进行 URL 编码吗?
- 它按字面替换值,方便你阅读原始标记。真实播放器会对 [PAGEURL] 和同意字符串等字段进行百分号编码,因此若你的端点需要,请自行编码。
- 这些宏基于哪个 VAST 版本?
- 该参考遵循 IAB VAST 4.x 宏集合,包括近期版本引入的隐私宏,例如 [GDPR]、[GDPRCONSENT]、[US_PRIVACY]、[GPP] 和 [GPPSID]。
相关工具
- VAST 校验器 — 在浏览器中对照 IAB 规则校验 VAST XML 标签、识别版本并检查必需节点。
- VAST 标签检查器 — 解析 VAST XML,展开 InLine/Wrapper 结构、媒体文件与跟踪 URL,不触发像素。
- VAST 错误码查询 — 查询任意 IAB VAST 或 VPAID 错误码的含义、类别与可能的修复方法。
- OpenRTB 枚举参考 — 查询每个 OpenRTB 2.x 枚举列表,含整数码、含义与属性路径,可搜索。
- schain 生成器 — 为 OpenRTB 构建并校验 IAB SupplyChain 对象,导出 JSON 与序列化字符串。
- Prebid 广告单元生成器 — 构建含 banner、video 与 native 媒体类型和 bidder params 的 Prebid.js 广告单元配置。
全部 ArrayKit 工具