Struct openrtb_native1::request::Request
source · pub struct Request {
pub ver: Version,
pub context: Option<ContextType>,
pub contextsubtype: Option<ContextSubType>,
pub plcmttype: Option<PlacementType>,
pub plcmtcnt: i32,
pub seq: i32,
pub assets: Vec<Asset>,
pub aurlsupport: bool,
pub durlsupport: bool,
pub eventtrackers: Option<Vec<EventTracker>>,
pub privacy: bool,
pub ext: Option<Map<String, Value>>,
}
Expand description
4.1 Native Markup Request Object
The Native Object defines the native advertising opportunity available for bid via this bid request. It will be included as a JSON-encoded string in the bid request’s imp.native field or as a direct JSON object, depending on the choice of the exchange. While OpenRTB 2.x officially supports only JSON-encoded strings, many exchanges have implemented a formal object. Check with your integration docs.
Fields§
§ver: Version
optional; string; 1.2 Version of the Native Markup version in use.
context: Option<ContextType>
recommended; integer; - The context in which the ad appears. See Table of Context IDs below for a list of supported context types.
contextsubtype: Option<ContextSubType>
optional; integer; - A more detailed context in which the ad appears. See Table of Context SubType IDs below for a list of supported context subtypes.
plcmttype: Option<PlacementType>
recommended; integer; - The design/format/layout of the ad unit being offered. See Table of Placement Type IDs below for a list of supported placement types.
plcmtcnt: i32
optional; integer; 1 The number of identical placements in this Layout. Refer Section 8.1 Multiplacement Bid Requests for further detail.
seq: i32
0 for the first ad, 1 for the second ad, and so on. Note this would generally NOT be used in combination with plcmtcnt - either you are auctioning multiple identical placements (in which case plcmtcnt>1, seq=0) or you are holding separate auctions for distinct items in the feed (in which case plcmtcnt=1, seq=>=1)
assets: Vec<Asset>
required; array of objects; - An array of Asset Objects. Any bid response must comply with the array of elements expressed in the bid request.
aurlsupport: bool
optional; integer; 0 Whether the supply source / impression supports returning an assetsurl instead of an asset object. 0 or the absence of the field indicates no such support.
durlsupport: bool
optional; integer; 0 Whether the supply source / impression supports returning a dco url instead of an asset object. 0 or the absence of the field indicates no such support. Beta feature.
eventtrackers: Option<Vec<EventTracker>>
optional; array of objects; - Specifies what type of event tracking is supported - see Event Trackers Request Object.
privacy: bool
recommended; integer; 0 Set to 1 when the native ad supports buyer-specific privacy notice. Set to 0 (or field absent) when the native ad doesn’t support custom privacy links or if support is unknown.
ext: Option<Map<String, Value>>
optional; object; - This object is a placeholder that may contain custom JSON agreed to by the parties to support flexibility beyond the standard defined in this specification.