schain 构建器与校验器
为 OpenRTB 构建并校验 IAB SupplyChain 对象(schain),并同时导出 source.ext.schain JSON 和序列化字符串——全部在你的浏览器中完成。
schain 构建器与校验器完全在你的浏览器中运行。你构建或粘贴的卖方 id、域名和供应链节点都留在你的设备上,绝不会上传到 ArrayKit。
打开 OpenRTB 枚举参考
关于 schain 生成器
schain 构建器与校验器可组装那个在 OpenRTB 竞价请求中位于 source.ext.schain 的 IAB Tech Lab SupplyChain 对象。把每个中间方添加为一个有序节点,含其 asi、sid 和 hp(付款)标志,设置 complete 和 ver 值,然后同时复制 JSON 对象和交易所所期望的 URL 编码序列化字符串。切换到「校验」模式可粘贴一个现有 schain——以 JSON 或序列化字符串形式——并立即看到缺失的必需字段、错误的 complete 标志或意外的版本,同时逐节点画出跳转链。ad-ops、SSP 和 header-bidding 工程师可在此审计并修复供应路径;你粘贴的节点和卖方 id 都在你的设备上解析,绝不上传。
功能特性
- 添加、重排和移除有序供应链节点(asi、sid、hp、rid、name、domain)
- 切换 complete 标志,并把 ver 固定到当前 1.0 规范
- 导出可直接放入竞价请求的 OpenRTB source.ext.schain JSON 对象
- 生成交易所接受的 URL 编码序列化字符串(ver,complete!node!node)
- 校验模式接受 JSON schain 或序列化字符串
- 标出缺失的 asi、sid 或 hp、无效的 complete 标志以及意外的 ver
- 可视化跳转链,让你一眼确认节点顺序
- 完全在你的浏览器中运行——卖方 id 和域名留在你的设备上
如何使用 schain 生成器
- 保持选中「构建」标签页,并为每个节点填入 asi、sid 和 hp 标志
- 添加更多节点,用箭头把它们按发布商到交易所的顺序排列
- 设置 complete 标志(当整条路径已声明时为 1),并复制 JSON 或序列化字符串
- 切换到「校验」并粘贴一个现有 schain 以检查必需字段和节点顺序
示例
输入
asi: exchange1.com
sid: 1234
hp: 1
complete: 1
输出
1.0,1!exchange1.com,1234,1
一个节点序列化为 ver,complete!asi,sid,hp;JSON 放入 source.ext.schain。
常见错误与故障排除
- 校验报告某个节点缺少 asi、sid 或 hp。 — 每个节点都需要全部三个必需字段:asi 是广告系统的规范域名,sid 是来自该系统的卖方/转售方 id,而 hp 必须为 0 或 1。
- 交易所拒绝该序列化字符串。 — 字段必须经 URL 编码并按 asi,sid,hp,rid,name,domain 排序,字段之间用逗号、节点之间用 ! 分隔;头部段为 ver,complete。
- complete 被设为 1,但你漏掉了一个上游转售方。 — complete=1 断言每个中间方都已声明。若任何跳转未知,请设 complete=0,好让下游竞价方知道该路径是部分的。
- sid 与 sellers.json 中的卖方 id 不匹配。 — 每个节点上的 sid 必须等于对应系统在其 sellers.json 中发布的 seller_id,否则买方会把该路径视为未验证。
常见问题
- 什么是 schain(SupplyChain)对象?
- 它是一个 IAB Tech Lab 对象,在 OpenRTB 中位于 source.ext.schain,按顺序列出在发布商与交易所之间接触过该竞价请求的每一个广告系统,好让买方能验证供应路径。
- 每个节点上的 asi、sid 和 hp 是什么意思?
- asi 是广告系统的规范域名,sid 是该系统内的卖方或转售方账户 id(与其 sellers.json 匹配),hp 在该节点参与付款流时为 1。三者在每个节点都是必需的。
- JSON 对象和序列化字符串有什么区别?
- JSON 对象是用于竞价请求体的完整 source.ext.schain 结构。序列化字符串是一种紧凑的 URL 编码形式——ver,complete!node!node——其中每个节点为 asi,sid,hp,rid,name,domain,用于需要头部或查询参数的场合。
- complete 应为 0 还是 1?
- 只有当从发布商起的每个中间方都在 nodes 数组中声明时,才设 complete=1。若任何上游跳转未知或被省略,请设 complete=0,好让竞价方知道该链不完整。
- 该工具会从服务器抓取我的广告标签或竞价请求吗?
- 不会。你粘贴或构建 schain,一切——序列化、解析和校验——都在你的浏览器中本地进行。你输入的卖方 id、域名和节点数据绝不会发送到 ArrayKit。
- 它能校验我从线上竞价请求复制的 schain 吗?
- 可以。把它粘贴到「校验」模式,以 JSON 对象(包括包裹的 source.ext.schain)或序列化字符串形式,工具会检查必需的节点字段、complete 标志、ver,并画出跳转链。
相关工具
- sellers.json 校验器 — 对照 IAB 规范校验 sellers.json 的 version、唯一 seller_id 与 seller_type。
- ads.txt 校验器 — 逐行校验 ads.txt 或 app-ads.txt 的字段数量、DIRECT/RESELLER 关系与重复项。
- OpenRTB 竞价请求生成器 — 从表单构建符合规范的 OpenRTB 2.5 与 2.6 竞价请求并复制 JSON。
- OpenRTB 枚举参考 — 查询每个 OpenRTB 2.x 枚举列表,含整数码、含义与属性路径,可搜索。
- Prebid 广告单元生成器 — 构建含 banner、video 与 native 媒体类型和 bidder params 的 Prebid.js 广告单元配置。
- TCF 同意字符串解码器 — 解码 IAB TCF v2.2 同意字符串,查看 CMP 元数据、目的与厂商网格。
全部 ArrayKit 工具