Native 分册导航
Enumerations
本版本数据来自官方历史 PDF 的 OCR 识别稿,逐表人工审核后入库,为 draft 状态;审核修复与忠实保留的官方怪癖均登记于对象注记与溯源记录。
Native 1.1 规范共定义 7 张枚举表(53 个取值);各表 500+ 为交易所保留段。译稿校对中
全部枚举表
Native Layout IDs - To Be Deprecated§7.1
8 个值Layout ID 将在未来版本中废弃,不建议新实现使用。以下为上文引言中所述的核心布局清单。实现方交易平台(exchange)可能不支持所有资产变体,或引入其系统独有的新变体。ENLayout ID is to be deprecated in a future version and is not suggested for new implementations. Below is a list of the core layouts described in the introduction above. An implementing exchange may not support all asset variants or introduce new ones unique to that system.
| 1 | 内容墙。ENContent Wall |
| 2 | 应用墙。ENApp Wall |
| 3 | 新闻 Feed。ENNews Feed |
| 4 | 聊天列表。ENChat List |
| 5 | 轮播。ENCarousel |
| 6 | 内容流。ENContent Stream |
| 7 | 邻接内容的网格。ENGrid adjoining the content |
| 500+ | 保留供交易平台专用布局。ENReserved for Exchange specific layouts. |
Native Ad Unit IDs - To Be Deprecated§7.2
6 个值Ad Unit ID 将在未来版本中废弃,不建议新实现使用。以下为 IAB 在此描述的核心广告位 ID 清单:http://www.iab.net/media/file/IABNativeAdvertisingPlaybook120413.pdf。In feed 单元本质上是一种布局,已从清单中移除;in feed 单元可通过请求上的 layout 参数识别。实现方交易平台可能不支持所有资产变体,或引入其系统独有的新变体。ENAd Unit ID is to be deprecated in a future version and is not suggested for new implementations. Below is a list of the core ad unit ids described by IAB here http://www.iab.net/media/file/IABNativeAdvertisingPlaybook120413.pdf. In feed unit is essentially a layout, it has been removed from the list. The in feed units can be identified via the layout parameter on the request. An implementing exchange may not support all asset variants or introduce new ones unique to that system.
| 1 | 付费搜索单元。ENPaid Search Units |
| 2 | 推荐组件。ENRecommendation Widgets |
| 3 | 推广列表。ENPromoted Listings |
| 4 | 含原生元素的 In-Ad(IAB 标准)单元。ENIn-Ad (IAB Standard) with Native Element Units |
| 5 | 自定义/「无法被容纳」。ENCustom /'Can't Be Contained' |
| 500+ | 保留供交易平台专用格式。ENReserved for Exchange specific formats. |
广告出现所在的上下文——从高层看页面上围绕广告的内容类型。这直接对应新的 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+ | 由交易平台定义。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 product 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. |
| 2 | 在内容的原子单元中——即在文章页或单图页中。ENIn the atomic unit of the content - IE in the article page or single image page |
| 3 | 在核心内容之外——例如在右栏广告区、作为靠近内容的横幅式投放等。ENOutside the core content - for example in the ads section on the right rail, as a banner-style placement near the content, 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 | saleprice | 可与 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-maxheight 框架时 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-maxheight framework is used; exact size may not be available at bid request time. Width is calculated from the 3 supported aspect ratios. Note we are merging 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 |
| 2 | Logo | 品牌/应用的 logo 图像。ENLogo image for the brand/app.将在未来版本中废弃——使用类型 1 Icon。 |
| 3 | Main | 广告的大图预览。ENLarge image preview for the ad两种尺寸变体至少必需其一: 小变体: 最大高度:至少 200 最大宽度:至少 200、267 或 382 宽高比:1:1、4:3 或 1.91:1 大变体: 最大高度:至少 627 最大宽度:至少 627、836 或 1200 宽高比:1:1、4:3 或 1.91:1 |
| 500+ | XXX | 保留供 500 以上编号的交易平台专用用途。ENReserved for Exchange specific usage numbered above 500无推荐 |