ORTB
分册导航

AdSource 元素

元素
本页目录

定位

断点的广告来源:内联 VASTAdData、引用 AdTagURI、或非 VAST 的 CustomAdData,三选一。

规范章节
§2.3.2
父元素
AdBreak
基数
0..1
子元素
VASTAdData | AdTagURI | CustomAdData(三选一)

属性与取值

属性类型必填取值说明
idinteger广告来源标识
allowMultipleAdsboolean是否允许把 VAST ad pod 或多条广告 buffet 播进本断点;缺省时播放器接受多条;播放器可忽略非 VAST 的 ad pod
followRedirectsboolean播放器是否应遵循广告响应内的 wrapper/redirect;缺省时由播放器自行决定

CustomAdData/@templateType

  • vast1VAST 1.x 模板
  • vast2VAST 2.x 模板
  • proprietary私有模板

AdTagURI/@templateType

  • vast1VAST 1.x 模板
  • vast2VAST 2.x 模板
  • vast3VAST 3.0 模板
  • proprietary私有模板

子元素与结构

  • VASTAdDatachoice内联 VAST 3.0 文档,不包 CDATA,但应声明 VAST 命名空间
  • AdTagURIchoice指向另一系统广告响应的 URI,必须包 CDATA;带必填 templateType
  • CustomAdDatachoice非 VAST 广告响应的任意字符串,必须包 CDATA;带必填 templateType

XML 片段

<AdSource allowMultipleAds="true" followRedirects="true" id="1">
  <AdTagURI templateType="vast3"><![CDATA[https://ads.example.com/vast?slot=mid1]]></AdTagURI>
</AdSource>

播放器行为

  • 1提供了 AdSource 就必须用三种子元素之一声明来源
  • 2templateType 帮助播放器识别广告响应模板;VASTAdData 专用于 VAST,故无需 templateType
  • 3数字即 VAST 版本号:vast3 表示 VAST 3.0

失效形态

  • AdSource 存在却无任何来源子元素
  • AdTagURI / CustomAdData 缺 templateType(必填)
  • 非 VAST 内容未包 CDATA
本章正文数据化自 IAB VMAP 1.0.1 官方 PDF 与官方仓库 XSD,二者交叉核对。