ORTB
…
Native 分册导航

Native

Native Ads（原生广告）是 IAB Tech Lab 发布的 OpenRTB 子协议，定义原生广告位的资产请求与响应结构：标题/图片/视频/数据资产、上下文与广告位分类、事件追踪与第三方广告投放（assetsurl/DCO）。站内数据覆盖 1.0 / 1.1 / 1.2 三个版本。

本页目录

OpenRTB 请求与响应承载

Native 是 OpenRTB 的子协议：资产请求由 BidRequest.imp.native 承载，资产响应由 BidResponse.seatbid.bid.adm 承载（1.2 起可以 assetsurl/dcourl 改为第三方拉取）。本节按请求/响应两侧说明承载内容与四个承载点。

  • 请求侧 · BidRequest.imp.native承载 Native Markup Request（§4.1）：Exchange 声明可接受的资产清单（title/img/video/data）、分类字段（context/contextsubtype/plcmttype）与追踪支持（eventtrackers，1.2 起）；DSP 据此解析并决定是否参竞。
  • 响应侧 · BidResponse.seatbid.bid.adm承载 Native Markup Response（§5.1）：DSP 按请求契约回资产（每个资产回显请求 id），link 提供点击落地；1.2 起可以 assetsurl/dcourl 改为第三方拉取；Exchange/渲染侧按契约渲染并触发 eventtrackers（legacy 为 imptrackers/jstracker）。

四个承载点

  • BidRequest.imp.native请求侧承载点：Native Markup Request（JSON 串或直接对象）
  • BidResponse.seatbid.bid.adm响应侧承载点：Native Markup Response（资产 JSON）
  • assetsurl / dcourl1.2 起：第三方广告投放；SSP 自第三方 URL 拉取资产，dcourl 承载 DCO
  • eventtrackers1.2 起：event/method 对的事件追踪，取代 imptrackers/jstracker

对象模型参照树（1.2 基线）

Bid Request 侧（§4）

Native Markup Request §4.1
├─ assets 1..* ── Asset Request §4.2
│ ├─ title 0..1 ── Title Request §4.3
│ ├─ img 0..1 ── Image Request §4.4
│ ├─ video 0..1 ── Video Request §4.5
│ └─ data 0..1 ── Data Request §4.6
├─ eventtrackers 0..* ── Event Trackers Request §4.7 · 1.2+
├─ context / contextsubtype / plcmttype ── 分类三件套，枚举见 §7.1–7.3
├─ privacy ── 合规标志（0/1）
└─ [≤1.1] layout / adunit 旧分类：1.1 预告废弃、1.2 移除

Bid Response 侧（§5）

Native Markup Response §5.1
├─ assets 1..* ── Asset Response §5.2
│ ├─ title ── Title Response §5.3
│ ├─ img ── Image Response §5.4
│ ├─ data ── Data Response §5.5
│ └─ video ── Video Response §5.6
├─ link 1 ── Link Response §5.7 ── 点击落地
├─ eventtrackers 0..* ── Event Tracker Response §5.8 · 1.2+
├─ assetsurl / dcourl ── 第三方广告投放（1.2）：自第三方 URL 拉取资产 / DCO
└─ [≤1.1] imptrackers / jstracker 旧追踪：1.2 起被 eventtrackers 取代

树以 Native 1.2 当前官方版为基线：1.0/1.1 无 eventtrackers 分支（1.2 引入）；分类体系 1.0 用 layout/adunit、1.1 起迁移 context 三件套；warn 色行为该版本线已废弃/移除的旧构造。

版本演进

三个版本、两条主线：分类体系（layout/adunit → context 三件套）与追踪机制（imptrackers/jstracker → eventtrackers）。按发布倒序排列，入口直达各版本三件套。

  1. Native 1.2

    当前官方2017-07

    1.2 引入事件追踪器（eventtrackers 取代 imptrackers/jstracker）、隐私标志位（privacy）、第三方广告投放（assetsurl）与 DCO（beta）；废弃 LayoutID/AdUnitID，以 Context/Placement 分类取代。

    15 对象 · 79 字段 · 7 枚举表（46 取值）· 3 组官方示例

    数据基线：官方 Markdown 全文（commit 5b9afa2）采集于 2026-08-24 · CC-BY 3.0 (IAB Tech Lab)

    对象枚举示例

  2. Native 1.1

    历史·draft2016-03（定稿 2015-10）

    去除 'native' 根节点；新增 Context/ContextSubType/PlacementType 分类字段；预告废弃 LayoutID/AdUnitID；新增资产尺寸/长度建议。

    13 对象 · 62 字段 · 7 枚举表（53 取值）· 2 组官方示例

    数据基线：官方历史 PDF 的 OCR 识别稿，采集于 2026-08-25 · CC-BY 3.0 (IAB / IAB Tech Lab)

    对象枚举示例

  3. Native 1.0

    历史·draft2015-02（Final Draft 1.0.0.2 定稿 2015-01）

    首个正式版本：请求/响应两侧资产模型，'native' 根节点，LayoutID/AdUnitID 分类。

    14 对象 · 60 字段 · 4 枚举表（31 取值）· 4 组官方示例

    数据基线：官方历史 PDF 的 OCR 识别稿，采集于 2026-08-25 · CC-BY 3.0 (IAB / IAB Tech Lab)

    对象枚举示例

数据源

1.2 主源：IAB Tech Lab Native-Ads 官方仓库 Markdown 全文（CC-BY 3.0）；1.0/1.1 底稿：官方历史 PDF 的 OCR 识别稿。交叉校验源：官方工作组 openrtb2x（1.0 JSON Schema 与 fixtures）、OpenRTB 2.x、AdCOM 与 prebid openrtb2 Go 模型。详见仓库 data/native-spec/PROVENANCE.json。

字段表、枚举表与示例已逐条对照官方源人工校对，并经 prebid openrtb2 Go 模型交叉校验；官方原文笔误忠实保留，差异均登记于溯源记录。

推荐阅读路径

六步阅读顺序：前两步在本页建立链路承载与对象结构，中间三步进入 1.2 正文，最后一步回环到 OpenRTB 承载字段。

  1. 1链路位置：OpenRTB 请求与响应承载
  2. 2对象模型参照树（1.2 基线）
  3. 31.2 对象与字段：请求/响应两侧
  4. 4分类与枚举表（§7）
  5. 5官方示例：请求/响应完整载荷
  6. 6跨协议：OpenRTB Imp / Bid 承载字段