VAST 错误码查询
搜索每一个 IAB VAST 和 VPAID 错误码,查看其官方含义、类别与可能原因——直接在你的浏览器中匹配。
VAST 错误码查询把完整的 IAB 错误码表打包进页面,因此每次搜索与查询都在你的设备上运行。你粘贴的错误码、[ERRORCODE] 值和 VAST 响应绝不会上传到 ArrayKit。
打开 VAST 校验器
关于 VAST 错误码查询
VAST 错误码查询是一份可搜索的参考,涵盖每一个 IAB VAST 和 VPAID 错误码——从 100 XML 解析、101 schema 校验,到 300 系列 wrapper 错误码、400 系列 linear 媒体文件失败、non-linear 和 companion 错误,以及 900/901 未定义与 VPAID 错误。输入一个数字或选择一个类别,即可查看其官方含义、所属类别,以及最可能的原因与修复。它专为盯着 <Error> 信标中的 [ERRORCODE] 宏、试图弄清视频广告为何没渲染的 ad-ops 工程师、发布商和 DTC 团队打造。完整的错误码表已打包进页面,因此每次查询都在你的设备上进行——任何错误字符串、广告标签或 VAST 响应都绝不会上传到 ArrayKit。
功能特性
- 把从 100 到 901 的每一个标准 IAB VAST 3.0 和 4.x 错误码汇总到一张表中
- 按编号、关键词、类别,或错误含义与原因中的任意文本进行搜索
- 按类别筛选:Parsing、Trafficking、Wrapper、Linear、NonLinear、Companion 和 VPAID
- 每个错误码都显示其官方 IAB 含义,外加通俗易懂的可能原因与修复
- 彩色类别徽章让你能轻松扫视整段范围,例如 400 到 411
- 复制一行现成的「code — meaning」贴入工单、runbook 或 Slack 讨论串
- 涵盖 wrapper 无填充(303)、媒体文件(401/403/405)和 mezzanine(406/411)情形
- 完全在你的浏览器中运行——粘贴一个 [ERRORCODE] 值而不上传任何内容
如何使用 VAST 错误码查询
- 输入你在 <Error> ping 中看到的错误码,例如 303 或 402
- 查看它的官方含义、所属类别,以及可能的原因与修复
- 使用类别标签一次浏览整类错误
- 复制错误码及其含义,直接贴入你的缺陷报告或 runbook
示例
输入
303
输出
Category: Wrapper
Meaning: No ads VAST response after one or more Wrappers
Likely cause: the wrapper chain resolved to an empty (no-fill) VAST response.
查询 303 可解释你在调试 ad ops 时常遇到的 wrapper 无填充问题。
常见错误与故障排除
- 你看到错误 303,但 VAST 标签本身看起来是有效的。 — 303 是经过一个或多个 wrapper 后的无广告 / 无填充——上游就是没有可投放的广告。请检查底价、定向和需求,而不是 XML。
- 你日志中的错误码不在此列表内,例如 1009。 — 只有 100–901 是标准的 IAB VAST/VPAID 错误码。超出该范围的值通常是厂商或 SDK 特定的——请查阅发出该码的播放器或广告服务器的文档。
- 错误 101 在你认为正确的响应上反复触发。 — 101 是 schema 校验:XML 能解析,但违反了 VAST XSD。请对照 <VAST version> 属性中确切版本的 schema 校验该文档。
- 一个在浏览器中能正常播放的 MP4 URL 却报 403。 — 403 表示没有任何提供的 MediaFile 匹配播放器支持的类型、编解码器或投放方式——并非文件缺失。请添加一个 progressive H.264/AAC 的 MP4 版本。
常见问题
- VAST 错误码 303 是什么意思?
- 303 是一个 wrapper 错误:「经过一个或多个 Wrapper 后无广告 VAST 响应」。重定向链解析出了一个空的 VAST 文档——即无填充。XML 是有效的;上游只是没有可投放的广告,所以应查看需求与定向,而非标记本身。
- VAST 错误码究竟来自哪里?
- 播放器会把数字错误码替换进广告 <Error> URI 的 [ERRORCODE] 宏中,并将其作为跟踪像素触发。这些错误码及其含义定义在 IAB Tech Lab 的 VAST 3.0 和 4.x 规范中。
- VAST 错误 100 和 101 有什么区别?
- 100 是 XML 解析错误——响应不是格式良好的,因此根本无法解析。101 是 schema 校验——XML 能解析但不匹配 VAST schema,例如缺少必需元素或属性放错位置。
- 它是否同时涵盖 VPAID 错误码和 VAST?
- 是的。901 是通用的 VPAID 错误,与完整的 VAST 集合并列。VPAID 已被 SIMID 和 OMID 取代,但当遗留的交互素材初始化或运行失败时,901 仍会出现。
- 为什么我的错误码在查询中找不到?
- 只有 100 到 901 属于标准 IAB VAST/VPAID 范围。范围之外的错误码通常是某个 SDK、播放器或广告服务器自定义的,其含义存在于该厂商自己的文档里。
- 我能在不暴露广告标签的情况下查询一个错误码吗?
- 可以。完整的错误码表已打包进本页面,因此输入一个数字或粘贴一个 [ERRORCODE] 值都在你的设备上本地匹配。任何 VAST 响应、广告标签或错误字符串都不会发送到 ArrayKit。
相关工具
- VAST 校验器 — 在浏览器中对照 IAB 规则校验 VAST XML 标签、识别版本并检查必需节点。
- VAST 标签检查器 — 解析 VAST XML,展开 InLine/Wrapper 结构、媒体文件与跟踪 URL,不触发像素。
- VAST 宏展开器 — 在跟踪 URL 中展开 IAB VAST 4.x 宏并预览触发的请求,附可搜索参考。
- VMAP 校验器 — 校验 VMAP 广告插播 XML,并在时间轴上查看前贴、中插与后贴插播。
- OpenRTB 枚举参考 — 查询每个 OpenRTB 2.x 枚举列表,含整数码、含义与属性路径,可搜索。
- IAB 广告尺寸参考 — 查询 IAB 与常见程序化广告单元尺寸,含名称、尺寸与宽高比,可搜索。
全部 ArrayKit 工具