Native 分册导航
Native Markup Response§5.1 · Bid Response
`Native Markup Response` 对象是标识一条原生响应的顶层 JSON 对象，具有以下属性：译稿校对中ENThe native object is the top level JSON object which identifies a native response. The native object has following attributes:
| 属性 | 类型 | 必填性 | 默认值 | 描述 |
|---|---|---|---|---|
| ver | string | 推荐 | "1.2" | 正在使用的 Native Markup 版本号。译稿校对中ENVersion of the Native Markup version in use. |
| assets | object[] | 推荐 | — | 原生广告的资产列表。无 assetsurl 时必填；即使提供了 assetsurl 也推荐作为兜底填写。译稿校对中ENList of native ad’s assets. Required if no assetsurl. Recommended as fallback even if assetsurl is provided. |
| assetsurl | string | 可选 | — | assets 对象的替代来源 URL。存在时覆盖响应中的资产对象。译稿校对中ENURL of an alternate source for the assets object. Where present, overrides the asset object in the response. |
| dcourl | string | 可选 | — | 可找到用于填充本广告的动态创意优化（DCO, Dynamic Creative Optimization）规范的 URL。Beta 选项；存在时覆盖响应中的资产对象。译稿校对中ENURL where a dynamic creative specification may be found for populating this ad. Beta option, where present, overrides the asset object in the response. |
| link | object | 必填 | — | 目的地链接。这是广告的默认 link 对象；个别资产也可以有自己的 link 对象。译稿校对中ENDestination Link. This is the default link object for the ad. Individual assets can also have a link object. |
| imptrackers | string[] | 可选 | — | 曝光追踪 URL 数组。将被废弃——由 eventtrackers 取代。译稿校对中ENArray of impression tracking URLs. To be deprecated - replaced with eventtrackers. |
| jstracker | string | 可选 | — | 可选的 JavaScript 曝光追踪器。将被废弃——由 eventtrackers 取代。译稿校对中ENOptional JavaScript impression tracker. To be deprecated - replaced with eventtrackers. |
| eventtrackers | object[] | 可选 | — | 随广告运行的追踪对象数组，取代 imptrackers 与 jstracker。译稿校对中ENArray of tracking objects to run with the ad, replacing imptrackers and jstracker. |
| privacy | string | 可选 | — | 若请求中声明了支持，则为告知用户买方定向行为的页面 URL。译稿校对中ENIf support was indicated in the request, URL of a page informing the user about the buyer’s targeting activity. |
| ext | object | 可选 | — | 自定义 JSON 的占位对象，以支持超出标准规范的灵活性。译稿校对中ENThis object is a placeholder for custom JSON to support flexibility beyond the standard specification. |
注记
1 The provided “assetsurl” or “dcourl” should be expected to provide a valid response when called in any context, including importantly the brand name and example thumbnails and headlines (to use for reporting, blacklisting, etc), but it is understood the final actual call should come from the client device from which the ad will be rendered to give the buyer the benefit of the cookies and header data available in that context.
Note: Prior to VERSION 1.1, the native response’s root node was an object with a single field “native” that would contain the object above as its value. The Native Object specified above is now the root object.
Note re: assetsurl format responses: In the case of assetsurl or dcourl (beta) bidding, since the ultimate buyer/creative engine cannot alter the assets response based on the details inside the assets request (as it does not receive said request), it is critical that all required assets are provided, and such communications will need to be handled offline for recommended/optional elements.
In the normal embedded response, certain attributes of the response are assumed based on matching the ID of the asset object in the response to the ID of the asset object in the request. Since the asset response will not be reading the asset request directly in this implementation, that information is added as option in the below object definitions and marked for that use case.
It is also recommended that where the standard specifies multiple options for an element, that all options be provided. IE all 4 supported thumbnail aspect ratios and all 3 supported title lengths.
The ID component of the asset responses can be omitted.
Note that this change to provide the metadata description of the asset in the response, rather than using the asset ID to implicitly specify that, may be reflected into the inline version of responses in a future version to align the two methods of replying. Making that change now would break backwards compatibility of the inline response mechanism.
译注
译者注assetsurl 存在时覆盖 assets，但仍建议同时填 assets 作兜底：部分渲染侧在二次请求超时或失败时不会重试，缺失内嵌资产会导致空创意。译稿校对中
dcourl 为 Beta 选项：启用前需确认渲染侧支持 DCO 拉取，否则该响应可能被按无资产处理。译稿校对中