sellers.json 校验器
在你的浏览器中对照 IAB Tech Lab 规范校验一个 sellers.json 文档。你粘贴的文件留在你的设备上。
sellers.json 校验器完全在你的浏览器中运行。你粘贴的文档在你的设备上解析并检查,绝不会从 URL 抓取或上传到 ArrayKit。
打开 ads.txt 校验器
关于 sellers.json 校验器
sellers.json 校验器会在你粘贴的那一刻对一个 IAB Tech Lab sellers.json 文档进行检查。它确认必需的顶层 version 和 sellers[] 数组,然后遍历每个卖方条目:每个都需要一个在整个文件内唯一的 seller_id,以及一个为 PUBLISHER、INTERMEDIARY 或 BOTH(不区分大小写)的 seller_type。除非卖方被标为 is_confidential,否则 name 和 domain 是必需的,且 is_passthrough 必须是干净的布尔值。结果以通过/失败结论、带数组索引和 seller_id 标注的每卖方错误信息,以及一份按类型统计卖方外加机密和 passthrough 条目的汇总返回。ad-ops 和供应路径团队可在此审计自己或合作伙伴的文件,而无需把它 POST 给第三方服务——一切都在你的设备上运行。
功能特性
- 按 sellers.json 规范检查必需的顶层 version 和 sellers[] 数组
- 核实每个 seller_id 存在且在文件内唯一
- 对照 PUBLISHER、INTERMEDIARY 和 BOTH(不区分大小写)校验 seller_type
- 除非卖方设置 is_confidential = 1,否则强制要求 name 和 domain
- 确认 is_confidential 和 is_passthrough 是干净的 0/1 布尔标志
- 为每个错误标注 sellers[] 索引和有问题的 seller_id
- 按 seller_type 汇总计数,外加机密和 passthrough 合计
- 在你的浏览器中解析并校验文档——文件绝不离开你的设备
如何使用 sellers.json 校验器
- 粘贴你的 sellers.json 文档,或加载示例以查看预期形态
- 查看通过/失败结论和 seller-type 汇总计数
- 使用信息中的索引和 seller_id 跳转到每个被标记的 sellers[i] 条目
- 修复有问题的字段并重新校验,直到文档通过
示例
输入
{
"version": "1.0",
"sellers": [
{ "seller_id": "1001", "seller_type": "RESELLER" }
]
}
输出
Invalid sellers.json — 3 issues
sellers[0] (seller_id 1001) — Invalid "seller_type" "RESELLER". Must be one of PUBLISHER, INTERMEDIARY, or BOTH.
sellers[0] — "name" is required unless the seller is confidential.
sellers[0] — "domain" is required unless the seller is confidential.
seller_type 只接受 PUBLISHER、INTERMEDIARY 或 BOTH;非机密卖方需要 name 和 domain。
常见错误与故障排除
- 一个明显含有 sellers 的文件却报「Missing required top-level field version」。 — sellers.json 要求在顶层与 sellers[] 并列有一个字符串 version 字段(例如 "1.0")。请添加它——仅有 sellers 数组是不够的。
- 一个机密卖方因缺少 name 或 domain 被标记。 — 只有当该卖方 is_confidential = 1 时,name 和 domain 才是可选的。请把 is_confidential 设为 1 以省略它们,或提供这两个字段。
- 尽管值看起来正确,seller_type 仍被拒绝。 — 只有 PUBLISHER、INTERMEDIARY 和 BOTH 有效(不区分大小写)。如 RESELLER、SSP 或 EXCHANGE 的值不属于规范,会失败。
- 在你认为不同的 ID 上报「Duplicate seller_id」。 — seller_id 以字符串比较,因此 1001 和 "1001" 会冲突。每个 seller_id 在文件内必须唯一——请重新编号或去重条目。
常见问题
- sellers.json 校验器会检查什么?
- 它确认必需的顶层 version 和 sellers[] 数组,然后检查每个卖方是否有唯一的 seller_id、一个为 PUBLISHER、INTERMEDIARY 或 BOTH 的 seller_type,以及除非卖方为机密否则必需的 name 和 domain——并为每个问题标注其索引和 seller_id。
- 卖方在什么情况下可以省略 name 和 domain?
- 仅当该卖方设置 is_confidential = 1 时。sellers.json 规范允许一个机密账户隐藏其 name 和 domain,因此校验器对这些条目跳过 name/domain 要求,并在汇总中单独计数。
- sellers.json 中哪些 seller_type 值有效?
- PUBLISHER(拥有库存)、INTERMEDIARY(转售另一账户的库存)和 BOTH。检查不区分大小写,因此 publisher 和 PUBLISHER 都通过,但任何其他字符串(如 RESELLER)都会被报为无效的 seller_type。
- 为什么某个 seller_id 被报为重复?
- 每个 seller_id 在单个 sellers.json 文件内必须唯一。校验器在比较前把 ID 归一化为字符串,因此数字 1001 和字符串 "1001" 被视为同一 ID,第二次出现会被标记并指向第一次。
- 校验器会从 URL 抓取我的 sellers.json 吗?
- 不会。它绝不抓取远程 URL 或广告端点。你粘贴文档文本,它在你的设备上解析并校验,因此关于该文件的任何信息都不会上传到 ArrayKit 或任何第三方。
相关工具
- ads.txt 校验器 — 逐行校验 ads.txt 或 app-ads.txt 的字段数量、DIRECT/RESELLER 关系与重复项。
- schain 生成器 — 为 OpenRTB 构建并校验 IAB SupplyChain 对象,导出 JSON 与序列化字符串。
- OpenRTB 竞价请求校验器 — 对照 IAB 规则校验 OpenRTB 2.5 与 2.6 竞价请求的必需字段与枚举码。
- OpenRTB 枚举参考 — 查询每个 OpenRTB 2.x 枚举列表,含整数码、含义与属性路径,可搜索。
- VAST 校验器 — 在浏览器中对照 IAB 规则校验 VAST XML 标签、识别版本并检查必需节点。
- Prebid 广告单元生成器 — 构建含 banner、video 与 native 媒体类型和 bidder params 的 Prebid.js 广告单元配置。
全部 ArrayKit 工具