OpenRTB 竞价请求校验器
在你的浏览器中对照 IAB 规则校验一个 OpenRTB 2.5 或 2.6 竞价请求。你粘贴的 JSON 留在你的设备上。
OpenRTB 竞价请求校验器完全在你的浏览器中运行。你粘贴的竞价请求 JSON 在你的设备上解析并检查,绝不会上传到 ArrayKit 或发送到任何交易所。
打开 OpenRTB 竞价请求生成器
关于 OpenRTB 竞价请求校验器
OpenRTB 竞价请求校验器会在你粘贴的那一刻,对照 IAB OpenRTB 2.5 和 2.6 规则对一个实时竞价请求进行检查。选择一个版本,它会确认必需的 id 和 imp[] 存在、每个 impression 恰好携带一个媒体对象(banner、video、native 或 audio)、字段类型是否吻合,并核实每个枚举字段——auction type、video protocols、placement 或 plcmt、devicetype、connectiontype 和 api 框架——所持的码在该版本中确实存在。结果以通过/失败结论加上一份可跳转的路径寻址列表返回。ad-ops 工程师和 SSP/DSP 接入人员可在此调试线上流量样本,而无需向第三方端点 POST 竞价请求——一切都在你的设备上运行。
功能特性
- 使用版本感知的枚举集合对照 OpenRTB 2.5 或 2.6 校验
- 确认必需的 id 以及一个非空的 imp[] impression 数组
- 检查每个 impression 恰好声明 banner、video、native 或 audio 之一
- 核实 IAB 枚举码:at、video protocols、placement/plcmt、devicetype、connectiontype、api
- 处理 2.6 的 plcmt 字段,并按版本标出已弃用的 placement 用法
- 每条发现都携带如 imp[0].video.plcmt 的 JSON 路径,便于你精确定位
- 把阻断性错误与建议性警告(如弃用和重复的 imp id)分开
- 在你的浏览器中解析并检查竞价请求——样本绝不离开你的设备
如何使用 OpenRTB 竞价请求校验器
- 选择你的交易所所用的 OpenRTB 版本(2.5 或 2.6)
- 粘贴竞价请求 JSON,或加载示例以查看预期形态
- 查看通过/失败结论和路径寻址的发现列表
- 在标注的路径处修复每个错误并重新检查,直到请求有效
示例
输入
{
"id": "r1",
"imp": [{ "id": "1", "video": { "plcmt": 5 } }],
"site": { "id": "s1" }
}
输出
Invalid (OpenRTB 2.6)
imp[0].video.plcmt — 5 is not a valid video plcmt for OpenRTB 2.6. Allowed: 1, 2, 3, 4.
在 OpenRTB 2.6 中,plcmt 字段只接受码 1–4。
常见错误与故障排除
- 尽管请求含有 impression,仍报「Missing required field imp」。 — imp 必须是一个 JSON 数组——imp: [{ ... }],而非单个对象。校验器也会标出空的 [],因为至少需要一个 impression。
- 同时带有 banner 和 video 对象的 impression 被拒绝。 — 本校验器要求每个 impression 恰好一个媒体对象。请把多格式库存拆分为各自独立的 imp 条目,每个仅一种媒体类型。
- 在此前能通过的请求上,devicetype 或 connectiontype 被标为无效。 — 某些码是版本特定的:devicetype 8(OOH)和 connectiontype 7(5G)仅存在于 2.6。请把版本切换开关调到与你的交易所一致。
- 升级到 OpenRTB 2.6 后,placement 被标记。 — 2.6 弃用了 video.placement,转而使用 video.plcmt(Plcmt Subtypes)。请把值移到 plcmt,其有效码为 1–4,警告即会清除。
常见问题
- OpenRTB 竞价请求校验器会检查什么?
- 它确认必需的 id 和一个非空的 imp[] 数组、每个 impression 恰好有一个媒体对象(banner、video、native 或 audio)、字段类型正确,以及每个枚举字段所持的码对所选 OpenRTB 版本有效。
- OpenRTB 2.6 中 placement 和 plcmt 有什么区别?
- video.placement(Video Placement Types,码 1–5)是 2.5 的字段;OpenRTB 2.6 弃用它,转而使用 video.plcmt(Plcmt Subtypes,码 1–4)。在 2.6 中,校验器检查 plcmt,并在遗留的 placement 字段仍存在时给出警告。
- 当一个 impression 同时携带 banner 和 video 时,为什么我的请求会失败?
- 校验器要求每个 impression 恰好一个媒体对象,因此同一 imp 上 banner 加 video 会在该 imp 路径处被报告为错误。请改为把多格式库存建模为独立的 impression 对象。
- devicetype 和 connectiontype 允许哪些码?
- devicetype 在 2.5 中接受 1–7,在 2.6 中接受 1–8(8 = OOH Device)。connectiontype 在 2.5 中接受 0–6,在 2.6 中接受 0–7(7 = Cellular 5G)。校验器会在错误信息中列出你所选版本的允许码。
- 在 OpenRTB 2.5 和 2.6 之间切换会改变结果吗?
- 会。枚举集合是版本感知的,因此 2.6 新增的码(OOH devicetype、5G connectiontype、SIMID api、plcmt 字段)在 2.6 中有效,但在 2.5 中被拒绝。请始终选择你的交易所协商的版本。
- 当我校验竞价请求时,它会被发送到广告服务器吗?
- 不会。工具在你的设备上解析并检查 JSON,绝不抓取远程广告标签或向任何地方 POST 请求。关于该竞价请求的任何信息都不会上传到 ArrayKit 或交易所。
相关工具
- OpenRTB 竞价请求生成器 — 从表单构建符合规范的 OpenRTB 2.5 与 2.6 竞价请求并复制 JSON。
- OpenRTB 枚举参考 — 查询每个 OpenRTB 2.x 枚举列表,含整数码、含义与属性路径,可搜索。
- VAST 校验器 — 在浏览器中对照 IAB 规则校验 VAST XML 标签、识别版本并检查必需节点。
- sellers.json 校验器 — 对照 IAB 规范校验 sellers.json 的 version、唯一 seller_id 与 seller_type。
- schain 生成器 — 为 OpenRTB 构建并校验 IAB SupplyChain 对象,导出 JSON 与序列化字符串。
- ads.txt 校验器 — 逐行校验 ads.txt 或 app-ads.txt 的字段数量、DIRECT/RESELLER 关系与重复项。
全部 ArrayKit 工具