ORTB
…
分册导航

协议本体总览

供应链分册的总入口:四组标准逐册展开,每册正文照录官方规范原文,并附从原文抽出的字段表、变量表、官方示例与 CASE 对照。

共 6 章 · live 6 · draft 0 · planned 0

本页目录

分组

声明文件

2 章
  • 授权数字卖家(Authorized Digital Sellers, ads.txt)1.1:发布者在自己域名下声明被授权销售其库存的广告系统与账户 ID。记录四字段语法、五个变量声明、转介与缓存规则、九组官方示例。

    • 访问方法:路径、Content-Type、重定向与状态码处理
    • 文件格式与数据记录四字段
    • 语法定义:注释、记录、扩展字段
    • 变量声明记录与五个受支持变量
    • 过期与缓存
    • 九组官方示例
    • 实施者注意事项与版本
  • 应用授权卖家(Authorized Sellers for Apps, app-ads.txt):ads.txt 在经应用商店分发的软件上的扩展,声明文件放在开发者网站而非应用内。含开发者网址规范化规则与官方附录 A/B 测试用例。

    • 四方职责:应用开发者、广告网络与卖方平台、应用商店、授权卖家核验方
    • 开发者网址在商店页的提供与变更
    • 商店侧的结构化应用信息
    • 核验方的抓取流程与规范化
    • 开发者网址规范化测试用例(附录 A)
    • 开发者网址到 app-ads.txt 路径的测试用例(附录 B)
    • 限制与约束

身份披露

1 章
  • 广告系统在自己根域下公开其代表的卖家身份与这些卖家在其系统内的标识,使买方能够发现一次竞价请求的最终卖家与全部中介。含 Parent / Identifier / Seller 三个对象、标准 identifier 名单与官方样例文件。

    • 访问方法与文件格式
    • 过期与缓存
    • 实施:哪些广告系统必须发布该文件
    • Parent / Identifier / Seller 三个对象的字段
    • 标准 identifier 名单
    • 官方样例文件(含其 JSON 瑕疵说明)

请求内承载

1 章
  • OpenRTB 供应链对象(SupplyChain object, schain):让买方看到销售或转售某次竞价请求的全部主体。含节点定义、SupplyChain 与 SupplyChainNode 两对象、各版本承载位、转售时的构造规则,以及非 OpenRTB 请求下的 URL 参数序列化格式与六组官方配对示例。

    • 节点定义:asi 与 sid 的语义与唯一性约束
    • SupplyChain 与 SupplyChainNode 两对象的字段
    • 各 OpenRTB 版本的承载位
    • 转售与首发时的构造规则
    • 域名写法的有效与无效示例
    • 非 OpenRTB 请求的 URL 序列化:格式、属性序、编码规则
    • 六组「对象 ↔ 序列化串」官方配对示例

实施与场景

1 章
  • 官方两篇指南:库存共享指南处理 CTV / vMVPD 场景下多方对同一应用内广告位拥有销售权的情形(CASE A、B.1、B.2、C),实施指南把 ads.txt 的 DIRECT / RESELLER 与 sellers.json 直接挂钩并给出七个 CASE 的五栏对照(竞价请求、ads.txt、sellers.json、判定、结论)。

    • 背景与适用范围:库存共享在范围内、收益分成在范围外
    • 对 ads.txt 与 app-ads.txt 标准的更新
    • 库存共享 CASE A、B.1、B.2、C 的事实项与文件内容
    • 实施指南 CASE A–G 的五栏对照
    • Validation 栏的互锁判定(本站关系清单的原文出处)
    • 发布者、交易平台与 DSP 三方的实施指引

规范与指南登记

各册的官方源文件、采集基线 commit、校验和与已入库统计。校验和用于探测官方源变动:源文件一改,npm run supplychain:gen 与数据守卫测试就会失败。

标准类别版本发布日期官方源文件已入库
ads.txt (Authorized Digital Sellers)规范1.12022-07vendor/iab-supplychain/ads.txt v1.1.mdsha256: de5544b9b9bfsections 44 · fields 4 · variables 5 · examples 9 · exampleFiles 14
app-ads.txt (Authorized Sellers for Apps)app-ads.txt.md 正文无版本号与发布日期;仓库首次提交 2026-03-25 是该文件进 Supply-Chain-Validation 仓库的时间,与规范发布无关,故不作发布日期使用。规范——vendor/iab-supplychain/app-ads.txt.mdsha256: f8ad57c8b4a6sections 34 · canonicalizationCases 18 · urlMappingCases 6
sellers.json规范1.0July 2019vendor/iab-supplychain/sellers-json.mdsha256: da90706a38d7sections 13 · objects 3 · fields 16
OpenRTB SupplyChain objectsupplychainobject.md 无版本戳与发布日期;正文两处提到 “version 1.0 of the spec / of SupplyChain”,是 ver 字段的取值示例而非文档版本声明。仓库该文件首次提交 2019-04-11、最后提交 2022-03-24,仅作文件改动取证,不当规范发布日期。规范——vendor/iab-openrtb3/supplychainobject.mdsha256: 95f94bcf5bf5sections 22 · fields 11
ads.txt & app-ads.txt: Guidance for Inventory Sharing官方指南——vendor/iab-supplychain/Explainer Guide.mdsha256: 6a036746d233cases 5
Ads.txt Implementation Guidance官方指南——vendor/iab-supplychain/Implementation Guidance.mdsha256: fe92b8850fa8cases 7 · validationRules 28
  • InteractiveAdvertisingBureau/Supply-Chain-Validation ↗ · main @ 7682963ae241 · 抓取日期 2026-10-29

    vendor/iab-supplychain · 仓库根无 LICENSE 文件。ads.txt 自述「Ads.txt by Programmatic Supply Chain Working Group」CC-BY 3.0,app-ads.txt 与 sellers.json 也各自在正文头部声明 CC-BY 3.0;两篇指南无授权段,仓库 README 的 CC-BY 3.0 一行只署名 Ads.txt。

    仓库 2026-03-25 创建,创建后由 ads.txt-app-ads.txt 改名为 Supply-Chain-Validation;正文 TOC 锚点与图片链接仍写旧仓库路径,靠 GitHub 301 兜底不断链。

  • InteractiveAdvertisingBureau/openrtb ↗ · main @ f3fb64bb9e5f · 抓取日期 2026-10-29

    vendor/iab-openrtb3 · 仓库根无 LICENSE 文件;仓库 README 就 OpenRTB Specification 声明 CC-BY 3.0,但 supplychainobject.md 自身没有授权段。

    OpenRTB 3.0 仓库,非站内已 vendor 的 openrtb2.x;本模块只取其中的 supplychainobject.md。

官方源瑕疵清单

采集过程中发现的官方文档瑕疵,逐条附文件名与行号级证据。站内一律照录不修复:样本保持官方原样,可解析副本另行标明,两者不混用。

共 16 条

  • supplychainobject.md · Examples(多跳全字段)

    取值不一致

    序列化示例里的 rid 与其上方 SupplyChain 对象不一致:对象写 bid-request-2,序列化串写 bid-request2(少一个连字符)。站内两份都照录,round-trip 测试须把这处标为已知官方瑕疵而非本站解析错误。

    证据: vendor/iab-openrtb3/supplychainobject.md:395 · vendor/iab-openrtb3/supplychainobject.md:402

  • supplychainobject.md · Examples(四个 BidRequest 样例)

    非合法 JSON

    四个 BidRequest 样例都不是合法 JSON:app 对象收尾大括号后缺逗号,第二个样例的 sid 行尾也缺逗号;且围栏无语言标记。另四处均把 schain 放在 source.ext.schain(2.5 承载位),而同文档正文明确 2.6+ 应放 source.schain——示例与正文自相矛盾。

    证据: vendor/iab-openrtb3/supplychainobject.md:143-253 · vendor/iab-openrtb3/supplychainobject.md:28

  • Implementation Guidance.md · CASE A 五栏表

    非合法 JSON

    CASE A 的 sellers.json 栏把 seller_type 写成 "Publisher",与 sellers.json 规范枚举 PUBLISHER/INTERMEDIARY/BOTH 字面不符(规范说该字段大小写不敏感,故语义可用);同栏 Bid Request 描述里 placecment 为官方拼写错误。围栏标记为 ```json 但内容含散文,非合法 JSON。

    证据: vendor/iab-supplychain/Implementation Guidance.md:71 · vendor/iab-supplychain/Implementation Guidance.md:112

  • Supply-Chain-Validation 与 openrtb 两个仓库

    许可声明不一致

    两个仓库根目录都没有 LICENSE 文件,而授权声明的覆盖面并不齐:ads.txt 自述「Ads.txt by Programmatic Supply Chain Working Group」、app-ads.txt 自述「OpenRTB Specification the IAB Tech Lab」、sellers.json 自述「Sellers.json by OpenRTB Working Group」,三处署名主体各不相同;Explainer Guide、Implementation Guidance 与 supplychainobject.md 三篇则通篇没有授权段,只能从各自仓库 README 推及,而 Supply-Chain-Validation 的 README 那一行只署名 Ads.txt。本站按各篇自述记录,不把 README 的署名外推到未自述的文档上,也不替官方补一份仓库级许可。

    证据: vendor/iab-supplychain/ads.txt v1.1.md:15-17 · vendor/iab-supplychain/app-ads.txt.md:33-35 · vendor/iab-supplychain/sellers-json.md:13-15 · vendor/iab-supplychain/README.md:15-17 · vendor/iab-openrtb3/README.md:45-46

  • Supply-Chain-Validation 仓库

    内部链接过期

    仓库 2026-03-25 创建后由 ads.txt-app-ads.txt 改名而来,两篇指南的 TOC 锚点仍逐条写死旧仓库路径(github.com/InteractiveAdvertisingBureau/ads.txt-app-ads.txt/blob/main/…)。GitHub 对改名仓库做 301,链接不断但路径名已过期;站内 TOC 一律不采集,只采正文。

    证据: vendor/iab-supplychain/Explainer Guide.md:5-21 · vendor/iab-supplychain/Implementation Guidance.md:5-9

  • ads.txt v1.1.md · §4.1 / §4.2

    示例写法不一致

    §4 的九个示例中,4.1 与 4.2 把 ads.txt 内容写成行内码而非围栏代码块(其余七例用围栏)。采集器两种都要认,否则这两例的文件内容会丢。

    证据: vendor/iab-supplychain/ads.txt v1.1.md:230 · vendor/iab-supplychain/ads.txt v1.1.md:238

  • supplychainobject.md · 域名写法示例

    示例无标记

    Valid / Invalid examples 两组各只有裸域名行、无围栏无列表标记,与正文散文同形。采集时按「上一行是 Valid/Invalid examples: 标签」的状态机归类,若官方将来改写这段排版,归类会失效——由 __tests__ 的条数断言守住。

    证据: vendor/iab-openrtb3/supplychainobject.md:116-122

  • ads.txt v1.1.md · §4.6 BEFORE 段

    代码围栏畸形

    有一处代码围栏的开栏行同行即带内容(```# ads.txt file for Programmer A:),不是标准的独占一行开栏。只从下一行开始收会丢掉这行注释,采集器专门处理了这种写法。

    证据: vendor/iab-supplychain/ads.txt v1.1.md:331

  • ads.txt v1.1.md · §3.5.1 MANAGERDOMAIN

    缺句末标点

    MANAGERDOMAIN 描述里 “Syntax of the domain is [PSL+1 domain, required], [ISO 3166-1 alpha-2 country code, optional, blank=global]” 之后缺句号,直接接上 “This variable should only be used…”。抽取值语法时按方括号组收尾而非按句号切,否则会把后半句一并吞进去。

    证据: vendor/iab-supplychain/ads.txt v1.1.md:210

  • Explainer Guide.md · CASE A 脚注

    标记未闭合

    CASE A 末尾的 Note 段粗体标记未闭合(**Note: … as it is optional.* 只用一个 * 收尾),配对替换吃不掉残留的 **。stripMd 增加了一道「抹平残留 **」的兜底,否则该段正文会带着标记符号渲染。

    证据: vendor/iab-supplychain/Explainer Guide.md:113

  • app-ads.txt.md · 附录 A

    多行粘连

    官方原文把 2 条测试用例写在同一行(缺换行),采集时按 URL 边界拆开:https://another.subdomain.example.co.uk/test / https://subdomain.www.example.co.uk/test

    证据: vendor/iab-supplychain/app-ads.txt.md

  • app-ads.txt.md · 附录 B

    要点粘行

    官方原文用 ● 把回退项接在上一行末尾而非换行,采集时拆为独立条目:Test developer URL with multiple subdomains

    证据: vendor/iab-supplychain/app-ads.txt.md

  • sellers-json.md · Sample File Contents

    非合法 JSON

    官方样例不是合法 JSON:seller_type 的收尾引号写成弯引号 U+201D("PUBLISHER”)。站内照录原文,另存一份仅替换该弯引号的可解析副本。原始错误:Bad control character in string literal in JSON at position 339 (line 16 column 27)

    证据: vendor/iab-supplychain/sellers-json.md:172

  • Implementation Guidance.md · CASE A–G 关系图

    图片路径过期

    7 张 CASE 关系图全部链接改名前的 ads.txt-app-ads.txt 仓库,且分别钉在 7 个不同的历史 commit 上(GitHub 对改名仓库做 301,故不断链,但路径名与 commit 都已过期)。Explainer Guide 通篇无图。站内照录官方 URL,不镜像到 public/——与 SIMID 模块同一处理。

    证据: vendor/iab-supplychain/Implementation Guidance.md:60 · vendor/iab-supplychain/Implementation Guidance.md:149 · vendor/iab-supplychain/Implementation Guidance.md:255 · vendor/iab-supplychain/Implementation Guidance.md:376 · vendor/iab-supplychain/Implementation Guidance.md:470 · vendor/iab-supplychain/Implementation Guidance.md:588 · vendor/iab-supplychain/Implementation Guidance.md:679

  • Implementation Guidance.md · CASE A–G 的 Validation 栏

    措辞不一致

    七个 CASE 的 Validation 栏是同一套四条判定(sellers.domain 对 OWNERDOMAIN / MANAGERDOMAIN / MANAGERDOMAIN+GEO 的等值与不等值分支),但官方字面不统一:域名占位符 A=publisher.com B=publisher.com C=publisher.com D=site.com E=site.com F=publisher.com G=publisher.com;CASE E 的第四条结论只写到 "THEN seller is reseller",漏了其余六例都有的 "of inventory"。本站按规则形状归一为单一来源,字面差异如实记录,不替官方统一措辞。

    证据: vendor/iab-supplychain/Implementation Guidance.md:120-135 · vendor/iab-supplychain/Implementation Guidance.md:441-456 · vendor/iab-supplychain/Implementation Guidance.md:558-573

  • Implementation Guidance.md · CASE G 的 Bid Request 与 Answer 栏

    取值不一致

    CASE G 叙述为「site.com 的库存由 xyzmedia.com(sid xyz)经 exchange.com(sid 1240)转卖」,ads.txt 栏也写 xyzmedia.com, 123xyz, DIRECT;但 Bid Request 栏首节点(sid 123xyz)的 asi 误写成 "ecxhange.co m",按 ads.txt 行与叙述应为 xyzmedia.com——首节点 asi 指错了广告系统。第二节点(sid 1240)的 asi 写作 "ecxhange.com",是 exchange.com 的拼写错误(同样的 ecxhange 拼错也见于 CASE B/C/F 的 Bid Request 栏)。Answer 栏把 XYZ Media 误拼为 "ZYZ Media"。本站照录原文,不替官方改字;这些瑕疵意味着 CASE G 的字面 schain 并不满足「下游 sellers.domain=上游 asi」的实体连续性,引用该例时须以 ads.txt 栏与叙述为准。

    证据: vendor/iab-supplychain/Implementation Guidance.md:691-709 · vendor/iab-supplychain/Implementation Guidance.md:725-726 · vendor/iab-supplychain/Implementation Guidance.md:778

采集说明

ads.txt 1.1、app-ads.txt、sellers.json 1.0 与两篇实施指南 vendor 自 IAB Tech Lab 官方仓库 Supply-Chain-Validation(前身名 ads.txt-app-ads.txt);OpenRTB SupplyChain 对象规范 vendor 自官方 openrtb(3.0)仓库的 supplychainobject.md,该仓库与站内已 vendor 的 openrtb2.x 是两个仓库。ads.cert 明确不收录:openrtb 仓库里只剩 714 字节转发存根,1.0 beta 从未成为标准,v2.0 已独立于 OpenRTB 另站发布。SupplyChainPlus 仓库只有 README 与一个 CRC32C 脚本、无规范正文,同样不收录。

内容忠实于 IAB Tech Lab 官方仓库 Supply-Chain-Validation 与 openrtb 的规范原文(CC-BY 3.0,各篇正文头部分别署名),由 scripts/gen-supplychain-spec.mjs 采集入库:照录不改写、不翻译、不修复官方瑕疵。瑕疵逐条记录在 PROVENANCE.json 的 findings 并在对应分册显示。采集基线 commit 与抓取日期见各分册的出处一节。