Native 分册导航
Enumerations
字段表、枚举表与示例已逐条对照官方源人工校对,并经 prebid openrtb2 Go 模型交叉校验;官方原文笔误忠实保留,差异均登记于溯源记录。
Native 1.2 规范共定义 7 张枚举表(46 个取值);各表 500+ 为交易所保留段。译稿校对中
全部枚举表
广告出现所在的上下文——从高层看页面上围绕广告的内容类型。这直接对应新的 Deep Dive on In-Feed Ad Units。它标示主要上下文,但不暗示页面上不能存在其他内容——例如预期大多数内容平台都带有一些社交组件等。ENThe context in which the ad appears - what type of content is surrounding the ad on the page at a high level. This maps directly to the new Deep Dive on In-Feed Ad Units. This denotes the primary context, but does not imply other content may not exist on the page - for example it's expected that most content platforms have some social components, etc.
| 1 | 以内容为中心的上下文,如新闻 feed、文章、图片画廊、视频画廊或类似。ENContent-centric context such as newsfeed, article, image gallery, video gallery, or similar. |
| 2 | 以社交为中心的上下文,如社交网络 feed、邮件、聊天或类似。ENSocial-centric context such as social network feed, email, chat, or similar. |
| 3 | 产品上下文,如产品列表、详情、推荐、评论或类似。ENProduct context such as product listings, details, recommendations, reviews, or similar. |
| 500+ | 由交易平台(exchange)定义。ENTo be defined by the exchange. |
广告出现所在的下一级上下文。同样,这反映主要上下文,不暗示不存在其他元素。例如一篇文章很可能包含图片,但它首先仍然是一篇文章。SubType 只应按所示与主要上下文类型组合(即上下文类型为 1 时,仅以 1 开头的上下文子类型有效)。ENNext-level context in which the ad appears. Again this reflects the primary context, and does not imply no presence of other elements. For example, an article is likely to contain images but is still first and foremost an article. SubType should only be combined with the primary context type as indicated (ie for a context type of 1, only context subtypes that start with 1 are valid).
| 10 | 通用或混合内容。ENGeneral or mixed content. |
| 11 | 以文章内容为主(文章本身当然可以包含图片等)。ENPrimarily article content (which of course could include images, etc as part of the article). |
| 12 | 以视频内容为主。ENPrimarily video content. |
| 13 | 以音频内容为主。ENPrimarily audio content. |
| 14 | 以图像内容为主。ENPrimarily image content. |
| 15 | 用户生成内容——论坛、评论等。ENUser-generated content - forums, comments, etc. |
| 20 | 通用社交内容,如通用社交网络。ENGeneral social content such as a general social network. |
| 21 | 以邮件内容为主。ENPrimarily email content. |
| 22 | 以聊天/IM 内容为主。ENPrimarily chat/IM content. |
| 30 | 以销售产品为核心的内容,无论数字或实体。ENContent focused on selling products, whether digital or physical. |
| 31 | 应用商店/市场。ENApplication store/marketplace. |
| 32 | 以产品评论网站为主(可能次要地销售产品)。ENProduct reviews site primarily (which may sell products secondarily). |
| 500+ | 由交易平台定义。ENTo be defined by the exchange. |
所购买广告的格式(FORMAT),与周围上下文分开。ENThe FORMAT of the ad you are purchasing, separate from the surrounding context
| 1 | 在内容 feed 中——例如作为自然 feed/网格/列表/轮播/菜单磁贴中的一项。ENIn the feed of content - for example as an item inside the organic feed/grid/listing/carousel/in menu tile. |
| 2 | 在内容的原子单元中——即在文章页或单图页中。ENIn the atomic unit of the content - IE in the article page or single image page. |
| 3 | 在核心内容之外——例如在右栏广告区、作为靠近内容的横幅式投放,或 CTV 设备上的头条横幅等。ENOutside the core content - for example in the ads section on the right rail, as a banner-style placement near the content, this could also be a headline banner on CTV devices, etc. |
| 4 | 推荐组件,最常见于文章内容下方呈现。ENRecommendation widget, most commonly presented below the article content. |
| 500+ | 由交易平台定义。ENTo be defined by the exchange. |
以下为规范撰写时原生广告常见资产元素类型清单。本清单非穷尽,旨在由买方与卖方随格式演进而扩展。实现方交易平台可能不支持所有资产变体,或引入其系统独有的新变体。ENBelow is a list of common asset element types of native advertising at the time of writing this spec. This list is non-exhaustive and intended to be extended by the buyers and sellers as the format evolves. An implementing exchange may not support all asset variants or introduce new ones unique to that system.
| 1 | sponsored | Sponsored By 消息,响应中应包含赞助方的品牌名。ENSponsored By message where response should contain the brand name of the sponsor.必填。最大 25 或更长。 | text |
| 2 | desc | 与被广告产品或服务相关的描述性文本。响应中过长的文本可能被交易平台截断或加省略号。ENDescriptive text associated with the product or service being advertised. Longer length of text in response may be truncated or ellipsed by the exchange.推荐。最大 140 或更长。 | text |
| 3 | rating | 提供给用户的产品评分。例如应用在应用商店中 0-5 的评分。ENRating of the product being offered to the user. For example an app’s rating in an app store from 0-5.可选。0-5 整数,以字符串格式表示。 | number formatted as string |
| 4 | likes | 提供给用户的产品社交评分或“likes”数量。ENNumber of social ratings or “likes” of the product being offered to the user. | number formatted as string |
| 5 | downloads | 该产品的下载/安装数量。ENNumber downloads/installs of this product. | number formatted as string |
| 6 | price | 产品/应用/应用内购买的价格。取值应以本地化格式包含货币符号。ENPrice for product / app / in-app purchase. Value should include currency symbol in localised format. | number formatted as string |
| 7 | salesprice | 可与 price 一起使用以表示相对常规价格折扣价的促销价。取值应以本地化格式包含货币符号。ENSale price that can be used together with price to indicate a discounted price compared to a regular price. Value should include currency symbol in localised format. | number formatted as string |
| 8 | phone | 电话号码。ENphone number | formatted string |
| 9 | address | 地址。ENAddress | text |
| 10 | desc2 | 与被广告产品或服务相关的附加描述性文本。ENAdditional descriptive text associated with the product or service being advertised. | text |
| 11 | displayurl | 文字广告的展示 URL。当赞助实体不拥有该内容时使用;即 sponsored by BRAND on SITE(SITE 经本字段传递)。ENDisplay URL for the text ad. To be used when sponsoring entity doesn’t own the content. IE sponsored by BRAND on SITE (where SITE is transmitted in this field). | text |
| 12 | ctatext | CTA 描述——描述目的地 URL 的「call to action」按钮的描述性文本。ENCTA description - descriptive text describing a ‘call to action’ button for the destination URL.可选。最大 15 或更长。 | text |
| 500+ | XXX | 保留供 500 以上编号的交易平台专用用途。ENReserved for Exchange specific usage numbered above 500. | Unknown |
以下为规范撰写时原生广告常见图像资产元素类型清单。本清单非穷尽,实现方交易平台可能不支持所有资产变体,或引入其系统独有的新变体。为促进采纳,对最小尺寸与宽高比均给出推荐。此处所说「minimum maximum height」或「max height of at least」指供应方平台(SSP, Supply-Side Platform)应支持至少该值的最大高度;其可以自由支持更大值,但需求方平台(DSP, Demand-Side Platform)知道只要有该尺寸的图像就会被接受。注意使用 min-max-height 框架时 SSP 负责将图像缩放到精确尺寸;精确尺寸在竞价请求时可能不可得。宽度由 3 种受支持宽高比计算。注意我们将先前重叠的类型 1 与类型 2 合并为仅类型 1——用于应用图标、品牌 logo 或类似。ENBelow is a list of common image asset element types of native advertising at the time of writing this spec. This list is non-exhaustive and intended to be extended by the buyers and sellers as the format evolves. An implementing exchange may not support all asset variants or may introduce new ones unique to that system. In order to facilitate adoption, recommendations are made for both minimum sizes and aspect ratios. We speak here of 'minimum maximum height' or ‘max height of at least’, which means the SSP should support a max height of at least this value. They are free to support larger, but the DSP knows that if they have an image of this size it will be accepted. Note that SSPs will be responsible for sizing image to exact size if min-max-height framework is used; exact size may not be available at bid request time. Width is calculated from the 3 supported aspect ratios. Note we merged the prior overlapping type 1 and type 2 as just type 1 - to be used for app icon, brand logo, or similar.
| 1 | Icon | 图标图像。ENIcon image可选。 最大高度:至少 50 宽高比:1:1 |
| 3 | Main | 广告的大图预览。ENLarge image preview for the ad两种尺寸变体至少必需其一: 小变体: 最大高度:至少 200 最大宽度:至少 200、267 或 382 宽高比:1:1、4:3 或 1.91:1 大变体: 最大高度:至少 627 最大宽度:至少 627、836 或 1198 宽高比:1:1、4:3 或 1.91:1 |
| 500+ | XXX | 保留供 500 以上编号的交易平台专用用途。ENReserved for Exchange specific usage numbered above 500无推荐 |
| 1 | impression | 曝光。ENImpression |
| 2 | viewable-mrc50 | 使用 MRC 定义的可见曝光:50% 可见持续 1 秒。ENVisible impression using MRC definition at 50% in view for 1 second |
| 3 | viewable-mrc100 | 100% 可见持续 1 秒(即 GroupM 标准)。EN100% in view for 1 second (ie GroupM standard) |
| 4 | viewable-video50 | 视频的可见曝光:使用 MRC 定义,50% 可见持续 2 秒。ENVisible impression for video using MRC definition at 50% in view for 2 seconds |
| 500+ | exchange-specific |
| 1 | img | 图像像素追踪——所提供的 URL 将在事件发生时以 1x1 像素形式插入。ENImage-pixel tracking - URL provided will be inserted as a 1x1 pixel at the time of the event. |
| 2 | js | 基于 JavaScript 的追踪——所提供的 URL 将在事件发生时以 js 标签形式插入。ENJavascript-based tracking - URL provided will be inserted as a js tag at the time of the event. |
| 500+ | exchange-specific | 可包含自定义测量公司(如 moat、doubleverify、IAS 等)——此情况下通常会传递额外元素。ENCould include custom measurement companies such as moat, doubleverify, IAS, etc - in this case additional elements will often be passed. |