Native 分册导航

Native 1.0

对象: 14
字段: 60

本页目录

Bid Request 侧（§4）
Bid Response 侧（§5）

本版本数据来自官方历史 PDF 的 OCR 识别稿，逐表人工审核后入库，为 draft 状态；审核修复与忠实保留的官方怪癖均登记于对象注记与溯源记录。

Bid Request 侧（§4）

Native Markup Request§4.1	7 字段1 必填	`Native Markup Request` 对象定义本次竞价请求中可供出价的原生广告机会。若拍卖所提供的展示为原生广告格式，则它必须直接包含在 impression 对象中。Default 列规定未提供显式取值时可选参数应如何解释。译稿校对中ENThe Native Object defines the native advertising opportunity available for bid via this bid request. It must be included directly in the impression object if the impression offered for auction is a native ad format. The Default column dictates how optional parameters should be interpreted if explicit values are not provided.
Asset Request§4.2	7 字段1 必填	交易平台（exchange）代表渲染客户端所请求或支持的每个资产的主容器对象。必需的对象须显式标记。每个对象中 {title,,img,video,data} 只应存在其一（官方原文如此），其余应为 null/absent。id 在 `Asset Request` 数组内须唯一，以便响应可以对齐。译稿校对中ENThe main container object for each asset requested or supported by Exchange on behalf of the rendering client. Any object that is required is to be flagged as such. Only one of the {title,,img,video,data} objects should be present in each object. All others should be null/absent. The id is to be unique within the AssetObject array so that the response can be aligned.
Title Request§4.3	2 字段1 必填	`Title Request` 对象用于原生广告的标题元素。译稿校对中ENThe Title object is to be used for title element of the Native ad.
Image Request§4.4	7 字段	`Image Request` 对象用于原生广告的所有图像元素，如图标（Icon）、主图（Main Image）等。译稿校对中ENThe Image object to be used for all image elements of the Native ad such as Icons, Main Image, etc.
Video Request§4.5	5 字段4 必填	`Video Request` 对象用于原生广告中支持的所有视频元素，对应 OpenRTB 2.3 的 `Video` 对象。交易平台实现方可施加自己的特定限制。以下为 Video 对象的必需属性；可选属性请参阅 OpenRTB 2.3。译稿校对中ENThe video object to be used for all video elements supported in the Native Ad. This corresponds to the Video object of OpenRTB 2.3. Exchange implementers can impose their own specific restrictions. Here are the required attributes of the Video Object. For optional attributes please refer to OpenRTB 2.3.
Data Request§4.6	3 字段1 必填	`Data Request` 对象用于原生单元的所有非核心元素，如评分、评论数、星级、下载量、描述等。它对本文档撰写时尚未预见到的未来 Native 元素也是通用的。译稿校对中ENThe Data Object is to be used for all non-core elements of the native unit such as Ratings, Review Count, Stars, Download count, descriptions etc. It is also generic for future of Native elements not contemplated at the time of the writing of this document.

Bid Response 侧（§5）

Native Ad Creative JSON§5.1	1 字段1 必填	在 adm 中返回的或响应 nurl 返回的 JSON 是具有以下属性的 JSON 字符串：译稿校对中ENThe JSON returned in adm or in response to nurl is a JSON string with the following attributes:
Native Response§5.2	6 字段2 必填	`Native Response` 对象是标识一条原生响应的顶层 JSON 对象，具有以下属性：译稿校对中ENThe native object is the top level JSON object which identifies a native response. The native object has following attributes
Asset Response§5.3	8 字段1 必填	对应请求中的 `Asset Request` 对象。交易平台（exchange）代表渲染客户端所请求或支持的每个资产的主容器对象。必需的对象须显式标记。每个对象中 {title,img,video,data} 只应存在其一，其余应为 null/absent。id 在资产数组内须唯一，以便响应可以对齐。译稿校对中ENCorresponds to the Asset Object in the request. The main container object for each asset requested or supported by Exchange on behalf of the rendering client. Any object that is required is to be flagged as such. Only one of the {title,img,video,data} objects should be present in each object. All others should be null/absent. The id is to be unique within the AssetObject array so that the response can be aligned.
Title Response§5.4	2 字段1 必填	对应请求中的 `Title Request` 对象，并填入取值。译稿校对中ENCorresponds to the Title Object in the request, with the value filled in.
Image Response§5.5	4 字段1 必填	对应请求中的 `Image Request` 对象。该 Image 对象用于原生广告的所有图像元素，如图标（Icon）、主图（Main Image）等。译稿校对中ENCorresponds to the Image Object in the request. The Image object to be used for all image elements of the Native ad such as Icons, Main Image, etc.
Data Response§5.6	3 字段1 必填	对应请求中的 `Data Request` 对象，并填入取值。Data 对象用于原生单元的所有杂项元素，如评分、评论数、星级、下载量、价格等。它对本文档撰写时尚未预见到的未来 Native 元素也是通用的。译稿校对中ENCorresponds to the Data Object in the request, with the value filled in. The Data Object is to be used for all miscellaneous elements of the native unit such as Ratings, Review Count, Stars, Downloads, Price count etc. It is also generic for future of Native elements not contemplated at the time of the writing of this document.
Video Response§5.7	1 字段1 必填	对应请求中的 `Video Request` 对象，但其取值为一条合规的 VAST 标签。译稿校对中ENCorresponds to the Video Object in the request, yet containing a value of a conforming VAST tag as a value.
Link Response§5.8	4 字段1 必填	用于“行动号召”（call to action）资产或原生广告的其他链接。本对象应与其在父 `Asset Response` 对象中的同级对象关联，或作为顶层原生广告响应对象中的主链接。当该同级对象被激活（点击）时，动作应将用户带到链接所指位置。译稿校对中ENUsed for 'call to action' assets, or other links from the Native ad. This Object should be associated to its peer object in the parent Asset Object or as the master link in the top level Native Ad response object. When that peer object is activated (clicked) the action should take the user to the location of the link.

枚举总览官方示例