该对象描述展示(impression)将出现于其中的内容,内容可以是联合发行的(syndicated),也可以是非联合发行的。当联合发行的内容承载展示、且不一定符合发布方(publisher)的整体内容定位时,该对象尤为有用。受联合发行方式影响,交易平台(exchange)可能知晓、也可能不知晓内容实际运行所在的页面——例如,它可能是嵌入在某个未知网络资产或设备的 iframe 中的视频展示。译稿校对中ENThis object describes the content in which the impression will appear, which may be syndicated or non-syndicated content. This object may be useful when syndicated content contains impressions and does not necessarily match the publisher's general content. The exchange might or might not have knowledge of the page where the content is running, as a result of the syndication method. For example might be a video impression embedded in an iframe on an unknown web property or device.
| Attribute | Type | Description |
|---|---|---|
| id | string | 唯一标识该内容的 ID。译稿校对中ENID uniquely identifying the content. |
| episode | integer | 集数编号。译稿校对中ENEpisode number. |
| title | string | 内容标题。视频示例:“Search Committee”(电视节目)、“A New Hope”(电影)、“Endgame”(网络自制);非视频示例:“Why an Antarctic Glacier Is Melting So Quickly”(《时代》杂志文章)。译稿校对中ENContent title. Video Examples: "Search Committee" (television), "A New Hope" (movie), or "Endgame" (made for web). Non-Video Example: "Why an Antarctic Glacier Is Melting So Quickly" (Time magazine article). |
| series | string | 内容所属系列。视频示例:“The Office”(电视节目)、“Star Wars”(电影)、“Arby ‘N’ The Chief”(网络自制);非视频示例:“Ecocentric”(《时代》杂志博客)。译稿校对中ENContent series. Video Examples: "The Office" (television), "Star Wars" (movie), or "Arby 'N' The Chief" (made for web). Non-Video Example: "Ecocentric" (Time Magazine blog). |
| season | string | 内容所属季(如 “Season 3”)。译稿校对中ENContent season (e.g., "Season 3"). |
| artist | string | 内容署名艺人(artist)。译稿校对中ENArtist credited with the content. |
| genre | string | 最能描述该内容的体裁(genre,如摇滚、流行等)。译稿校对中ENGenre that best describes the content (e.g., rock, pop, etc). |
| album | string | 内容所属专辑;通常用于音频。译稿校对中ENAlbum to which the content belongs; typically for audio. |
| isrc | string | (International Standard Recording Code, isrc)isrc 国际标准录音制品编码,符合 ISO-3901 标准。译稿校对中ENInternational Standard Recording Code conforming to ISO-3901. |
| producer | object | 内容制作方 Producer 的详细信息(参见第 3.2.17 节)。译稿校对中ENDetails about the content Producer (Section 3.2.17). |
| url | string | 内容的 URL,供买方进行语境化(contextualization)或审查。译稿校对中ENURL of the content, for buy-side contextualization or review. |
| cat | string[] | 描述内容制作方的 IAB 内容分类(IAB content categories)数组。参见列表 5.1(List 5.1)。译稿校对中ENArray of IAB content categories that describe the content producer. Refer to List 5.1. |
| prodq | integer | (Production Quality, prodq)prodq 制作品质。参见列表 5.13(List 5.13)。译稿校对中ENProduction quality. Refer to List 5.13.枚举 Production Qualities · 4 个值0Unknown 1Professionally Produced 2Prosumer 3User Generated (UGC) |
| videoquality deprecated | integer | 已弃用(DEPRECATED),由 prodq 取代。视频质量。参见列表 5.13(List 5.13)。译稿校对中ENNote: Deprecated in favor of prodq. Video quality. Refer to List 5.13. |
| context | integer | 内容类型(游戏、视频、文本等)。参见列表 5.18(List 5.18)。译稿校对中ENType of content (game, video, text, etc.). Refer to List 5.18.枚举 Content Contexts · 7 个值1Video (i.e., video file or stream such as Internet TV broadcasts) 2Game (i.e., an interactive software game) 3Music (i.e., audio file or stream such as Internet radio broadcasts) 4Application (i.e., an interactive software application) 5Text (i.e., primarily textual document such as a web page, eBook, or news article) 6Other (i.e., none of the other categories applies) 7Unknown |
| contentrating | string | 内容分级(content rating,如 MPAA 分级)。译稿校对中ENContent rating (e.g., MPAA). |
| userrating | string | 用户对内容的评分(如星级数、点赞数等)。译稿校对中ENUser rating of the content (e.g., number of stars, likes, etc.). |
| qagmediarating | integer | 依据 IQG(Inventory Quality Guidelines,库存质量指南)的媒体评级。参见列表 5.19(List 5.19)。译稿校对中ENMedia rating per IQG guidelines. Refer to List 5.19.枚举 Media Ratings · 3 个值1All Audiences 2Everyone Over Age 12 3Mature Audiences |
| keywords | string | 描述该内容的关键词列表,以逗号分隔。译稿校对中ENComma separated list of keywords describing the content. |
| livestream | integer | 是否直播:0 = 非直播,1 = 内容正在直播(如直播流、实时博客)。译稿校对中EN0 = not live, 1 = content is live (e.g., stream, live blog). |
| sourcerelationship | integer | 来源关系:0 = 间接,1 = 直接。译稿校对中EN0 = indirect, 1 = direct. |
| len | integer | 内容时长,单位为秒;适用于视频或音频。译稿校对中ENLength of content in seconds; appropriate for video or audio. |
| language | string | 内容语言,采用 ISO-639-1-alpha-2 编码。译稿校对中ENContent language using ISO-639-1-alpha-2. |
| embeddable | integer | 指示该内容是否可嵌入(如可嵌入的视频播放器):0 = 否,1 = 是。译稿校对中ENIndicator of whether or not the content is embeddable (e.g., an embeddable video player), where 0 = no, 1 = yes. |
| data | object[] | 附加内容数据。每个 Data 对象(参见第 3.2.21 节)代表一个不同的数据源。译稿校对中ENAdditional content data. Each Data object (Section 3.2.21) represents a different data source. |
| ext | object | 供交易平台(exchange)对 OpenRTB 进行专属扩展(exchange-specific extensions)的占位对象。译稿校对中ENPlaceholder for exchange-specific extensions to OpenRTB. |
译注
译者注Content:Site 与 App 的子对象,描述展示将出现于其中的具体内容;业内文档一般保留英文对象名 Content。在 CTV / 视频 / 音频场景中为核心对象,携带剧集、直播、分级等内容侧信号。译稿校对中
Content vs Site/App:Site/App 描述发布方(媒体)层面的属性,Content 描述具体内容层面的属性;当内容为联合发行(syndicated)时,内容取向可能与发布方的整体定位不一致,品牌安全与语境化判断应以 Content 为准。译稿校对中
title vs series:title 是单集/单部作品的名称,series 是所属系列(IP)名;配合 season(季)与 episode(集)可构成“系列 → 季 → 集”三级定位,是 CTV 采买中剧集定向的基础。译稿校对中
isrc:国际标准录音制品编码(ISO-3901),唯一标识录音制品(歌曲、音乐录像等),业界惯用缩写 ISRC;在音乐流媒体广告场景中用于内容级归因与核验。译稿校对中
prodq vs videoquality:videoquality 已弃用,由 prodq 取代;两者引用同一词表(列表 5.13)。新接入方应只使用 prodq,解析时对 videoquality 做向后兼容即可。译稿校对中
三类评级字段区分:contentrating 是官方内容分级(如 MPAA 电影分级);userrating 是用户自发评分(星级、点赞等);qagmediarating 是 IQG 框架下的媒体评级(列表 5.19)。三者来源与用途均不同,勿混用。译稿校对中
MPAA:美国电影协会(Motion Picture Association of America),其分级体系(G/PG/PG-13/R 等)是北美电影分级的业界惯用参照;现机构已更名 MPA,但分级名称仍惯称 MPAA。译稿校对中
livestream / sourcerelationship:直播标志与来源关系(直接/间接)是 CTV 采买中的重要信号:直播内容通常适用不同的定价与创意规则;直接来源往往意味着更高的供应链透明度。译稿校对中
字段描述已与 2.6 官方 draft 对账;2.5 独有字段来自第三方 Go 实现源(Apache 2.0),官方 PDF 兜底校对 · 初稿校对中