ORTB
中 / EN

Enumerations

Native 1.1 规范共定义 7 张枚举表(53 个取值);各表 500+ 为交易所保留段。

Native Layout IDs - To Be Deprecated§7.1

8 个值

Layout 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.

1Content Wall
2App Wall
3News Feed
4Chat List
5Carousel
6Content Stream
7Grid adjoining the content
500+Reserved for Exchange specific layouts.

Native Ad Unit IDs - To Be Deprecated§7.2

6 个值

Ad 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.

1Paid Search Units
2Recommendation Widgets
3Promoted Listings
4In-Ad (IAB Standard) with Native Element Units
5Custom /'Can't Be Contained'
500+Reserved for Exchange specific formats.

Context Type IDs§7.3

4 个值引用字段:Native Markup Request.context

The 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.

1Content-centric context such as newsfeed, article, image gallery, video gallery, or similar.
2Social-centric context such as social network feed, email, chat, or similar.
3Product context such as product listings, details, recommendations, reviews, or similar.
500+To be defined by the exchange.

Context Sub Type IDs§7.4

13 个值引用字段:Native Markup Request.contextsubtype

Next-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).

10General or mixed content.
11Primarily article content (which of course could include images, etc as part of the article)
12Primarily video content
13Primarily audio content
14Primarily image content
15User-generated content - forums, comments, etc
20General social content such as a general social network
21Primarily email content
22Primarily chat/IM content
30Content focused on selling products, whether digital or physical
31Application store/marketplace
32Product reviews site primarily (which may sell product secondarily)
500+To be defined by the exchange

Placement Type IDs§7.5

5 个值引用字段:Native Markup Request.plcmttype

The FORMAT of the ad you are purchasing, separate from the surrounding context

1In the feed of content - for example as an item inside the organic feed/grid/listing/carousel.
2In the atomic unit of the content - IE in the article page or single image page
3Outside the core content - for example in the ads section on the right rail, as a banner-style placement near the content, etc.
4Recommendation widget, most commonly presented below the article content.
500+To be defined by the exchange

Data Asset Types§7.6

13 个值引用字段:Data Request.type · Data Response.type

Below 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.

1sponsoredSponsored By message where response should contain the brand name of the sponsor.Required. Max 25 or longer.text
2descDescriptive text associated with the product or service being advertised. Longer length of text in response may be truncated or ellipsed by the exchange.Recommended. Max 140 or longer.text
3ratingRating of the product being offered to the user. For example an app's rating in an app store from 0-5.Optional. 0-5 integer formatted as string.number formatted as string
4likesNumber of social ratings or 'likes' of the product being offered to the user.number formatted as string
5downloadsNumber downloads/installs of this productnumber formatted as string
6pricePrice for product / app / in-app purchase. Value should include currency symbol in localised format.number formatted as string
7salepriceSale 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
8phonePhone numberformatted string
9addressAddresstext
10desc2Additional descriptive text associated with the product or service being advertisedtext
11displayurlDisplay 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
12ctatextCTA description - descriptive text describing a 'call to action' button for the destination URL.Optional. Max 15 or longer.text
500+XXXReserved for Exchange specific usage numbered above 500Unknown

Image Asset Types§7.7

4 个值引用字段:Image Request.type · Image Response.type

Below 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.

1IconIcon imageOptional. max height: at least 50 aspect ratio: 1:1
2LogoLogo image for the brand/app.To be deprecated in future version - use type 1 Icon.
3MainLarge image preview for the adAt least one of 2 size variants required: Small Variant: max height: at least 200 max width: at least 200, 267, or 382 aspect ratio: 1:1, 4:3, or 1.91:1 Large Variant: max height: at least 627 max width: at least 627, 836, or 1200 aspect ratio: 1:1, 4:3, or 1.91:1
500+XXXReserved for Exchange specific usage numbered above 500No recommendations