该对象表示音频(audio)类型的展示。其中许多字段对最小可行交易并非必需,但可在需要时提供精细控制。OpenRTB 中的音频通常假定符合 DAAST(Digital Audio Ad Serving Template)标准;因此,伴生广告(companion ads)的概念通过可选地包含一个定义这些伴生广告的 Banner 对象数组(参见第 3.2.6 节的 Banner 对象)得到支持。Audio 作为 Imp 的子对象出现,即表示该展示以音频类型提供;经发布方许可,同一展示还可通过在 Imp 下并列包含 banner、video 和/或 native 类型对象的方式同时以这些类型提供,但针对该展示的任一具体出价,只能符合所供类型中的一种。译稿校对中ENThis object represents an audio type impression. Many of the fields are non-essential for minimally viable transactions, but are included to offer fine control when needed. Audio in OpenRTB generally assumes compliance with the DAAST standard. As such, the notion of companion ads is supported by optionally including an array of Banner objects (refer to the Banner object in Section 3.2.6) that define these companion ads. The presence of a Audio as a subordinate of the Imp object indicates that this impression is offered as an audio type impression. At the publisher's discretion, that same impression may also be offered as banner, video, and/or native by also including as Imp subordinates objects of those types. However, any given bid for the impression must conform to one of the offered types.
| Attribute | Type | Description |
|---|---|---|
| mimes required | string[] | 支持的内容 MIME 类型(如 “audio/mp4”)。必填(required)。译稿校对中ENContent MIME types supported (e.g., "audio/mp4"). |
| minduration | integer | 音频广告的最短时长,单位为秒。译稿校对中ENMinimum audio ad duration in seconds. |
| maxduration | integer | 音频广告的最长时长,单位为秒。译稿校对中ENMaximum audio ad duration in seconds. |
| protocols | integer[] | 支持的音频协议数组。参见列表 5.8(List 5.8)。译稿校对中ENArray of supported audio protocols. Refer to List 5.8.枚举 Creative Subtypes - Audio/Video · 16 个值1VAST 1.0 2VAST 2.0 3VAST 3.0 4VAST 1.0 Wrapper 5VAST 2.0 Wrapper 6VAST 3.0 Wrapper 7VAST 4.0 8VAST 4.0 Wrapper 9DAAST 1.0 10DAAST 1.0 Wrapper 11VAST 4.1 12VAST 4.1 Wrapper 其余 4 个值见枚举总览 → |
| startdelay | integer | 指示前插(pre-roll)、中插(mid-roll)或后插(post-roll)广告位的起始延迟,单位为秒。参见列表 5.12(List 5.12)。译稿校对中ENIndicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placements. Refer to List 5.12.枚举 Start Delay Modes · 4 个值>0Mid-Roll (value indicates start delay in second) 0Pre-Roll -1Generic Mid-Roll -2Generic Post-Roll |
| sequence | integer | 当同一竞价请求中提供多个广告展示时,该序号用于支持多个创意的协同投放。译稿校对中ENIf multiple ad impressions are offered in the same bid request, the sequence number will allow for the coordinated delivery of multiple creatives. |
| battr | integer[] | 被拦截的创意属性。参见列表 5.3(List 5.3)。译稿校对中ENBlocked creative attributes. Refer to List 5.3.枚举 Creative Attributes · 24 个值1Audio Ad (Autoplay) 2Audio Ad (User Initiated) 3Expandable (Automatic) 4Expandable (User Initiated - Click) 5Expandable (User Initiated - Rollover) 6In-Banner Video Ad (Autoplay) 7In-Banner Video Ad (User Initiated) 8Pop (e.g., Over, Under, or Upon Exit) 9Provocative or Suggestive Imagery 10Shaky, Flashing, Flickering, Extreme Animation, Smileys 11Surveys 12Text Only 其余 12 个值见枚举总览 → |
| maxextended | integer | 允许延时(extension)时的最长延时广告时长。为空或 0 表示不允许延时;-1 表示允许延时且不设时限;大于 0 时,取值表示在 maxduration 之外支持的延长播放秒数。译稿校对中ENMaximum extended ad duration if extension is allowed. If blank or 0, extension is not allowed. If -1, extension is allowed, and there is no time limit imposed. If greater than 0, then the value represents the number of seconds of extended play supported beyond the maxduration value. |
| minbitrate | integer | 最低码率,单位为 Kbps。译稿校对中ENMinimum bit rate in Kbps. |
| maxbitrate | integer | 最高码率,单位为 Kbps。译稿校对中ENMaximum bit rate in Kbps. |
| delivery | integer[] | 支持的分发方式(如流式 streaming、渐进式 progressive)。未指定时视为全部支持。参见列表 5.15(List 5.15)。译稿校对中ENSupported delivery methods (e.g., streaming, progressive). If none specified, assume all are supported. Refer to List 5.15.枚举 Delivery Methods · 3 个值1Streaming 2Progressive 3Download |
| companionad | object[] | Banner 对象(参见第 3.2.6 节)数组,在伴生广告(companion ads)可用时使用。译稿校对中ENArray of Banner objects (Section 3.2.6) if companion ads are available. |
| api | integer[] | 该展示所支持的 API 框架列表。参见列表 5.6(List 5.6)。未明确列出的 API 视为不支持。译稿校对中ENList of supported API frameworks for this impression. Refer to List 5.6. If an API is not explicitly listed, it is assumed not to be supported.枚举 API Frameworks · 10 个值1VPAID 1.0 2VPAID 2.0 3MRAID 1.0 4ORMMA 5MRAID 2.0 6MRAID 3.0 7OMID 1.0 8SIMID 1.0 9SIMID 1.1 500+Vendor-specific codes. |
| companiontype | integer[] | 支持的 DAAST 伴生广告类型。参见列表 5.14(List 5.14)。当通过 companionad 数组包含伴生 Banner 对象时建议传递。译稿校对中ENSupported DAAST companion ad types. Refer to List 5.14. Recommended if companion Banner objects are included via the companionad array.枚举 Companion Types · 3 个值1Static Resource 2HTML Resource 3iframe Resource |
| maxseq | integer | 广告簇(ad pod)中可播放的最大广告数。译稿校对中ENThe maximum number of ads that can be played in an ad pod. |
| feed | integer | 音频信息流(audio feed)的类型。参见列表 5.16(List 5.16)。译稿校对中ENType of audio feed. Refer to List 5.16.枚举 Feed Types · 8 个值1AOD Music streaming service 2LIVE FM/AM broadcast (live content broadcast over the air but also available via online streaming) 3AOD Podcast (original, pre-recorded content distributed as episodes in a series) 4AOD Catch-up radio (recorded segment of a radio show that was originally broadcast live) 5LIVE Web radio (live content only available via online streaming, not as AM/FM broadcast) 6MISC Video game (background audio in video games) 7MISC Text to speech (audio books, website plugin that can read article) 500+MISC Vendor-specific codes. |
| stitched | integer | 指示广告是拼接到音频内容中还是独立下发:0 = 否,1 = 是。译稿校对中ENIndicates if the ad is stitched with audio content or delivered independently, where 0 = no, 1 = yes. |
| nvol | integer | (Normalization Volume, nvol)nvol 音量归一化模式。参见列表 5.17(List 5.17)。译稿校对中ENVolume normalization mode. Refer to List 5.17. |
| ext | object | 供交易平台(exchange)对 OpenRTB 进行专属扩展(exchange-specific extensions)的占位对象。译稿校对中ENPlaceholder for exchange-specific extensions to OpenRTB. |
译注
译者注Audio:Imp 的子对象,表示音频类型的展示;业内文档一般保留英文对象名 Audio。其字段与 Video 高度同构,但针对音频场景裁剪:大量字段对最小可行交易并非必需,仅在需要精细控制时使用。译稿校对中
DAAST:Digital Audio Ad Serving Template,数字音频广告投放模板,IAB 制定的音频广告标准(可视为 VAST 的音频对应物)。伴生广告(companion ads)通过可选的 companionad 数组(Banner 对象)表达。译稿校对中
多类型同售:Audio 作为 Imp 的子对象出现,即表示该展示以音频类型提供;经发布方许可,同一展示可同时以 banner、video 和/或 native 提供,但任一具体出价只能符合所供类型中的一种。译稿校对中
maxextended 三态语义:空/0 = 不允许延时;-1 = 允许延时且不设时限;>0 = 在 maxduration 之外额外支持的具体秒数。解析时需三态分别处理,勿把 -1 当作数值参与计算。译稿校对中
stitched:广告拼接标志,描述广告是拼接(stitching)进音频内容流还是独立下发;播客场景的动态广告插入(DAI)通常对应 stitched = 1,此时广告与内容同源下发,无法被客户端拦截。译稿校对中
feed / maxseq:feed 描述音频信息流类型(音乐服务、播客、电台等,见列表 5.16);maxseq 约束广告簇(ad pod,音频场景的广告串)内可播放的最大广告数,与 Video 的 pod 概念对应。译稿校对中
字段描述已与 2.6 官方 draft 对账;2.5 独有字段来自第三方 Go 实现源(Apache 2.0),官方 PDF 兜底校对 · 初稿校对中