Native 1.1 Specification

Home » Marketer Documentation » Native 1.1 Specification

Native Markups Request Object

• ver – Version of the native markup version in use. Always set to 1.1 
• plcmttype – The design/format/layout of the ad unit being offered. Smaato supports chat list, app wall, news feed, carousel, and content stream 
• plcmtcnt – The number of identical placements in this Layout. Always set to 1. 
• assets – An array of asset objects. Any bid response must comply with the array of elements expressed in the bid request.

Assets Object

• id – Unique asset ID, assigned by the exchange. Typically, a counter for the array. 
• required – Set to 1 if asset is required (exchange will not accept a bid without it)
• title – Title object for title assets. See TitleObject definition. 
• img – Image object for image assets. See ImageObject definition. 
• data – Data object for brand name, description, ratings, prices etc. See DataObject definition.

Image Object

• type – Type ID of the image element supported by the publisher. The publisher can display this information in an appropriate format. 
  • Common Image Types:
    • 1 (icon) – max height: at least 50 aspect ratio: 1:1 
    • 3 (main) – At 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 1198 aspect ratio: 1:1, 4:3, or 1.91:1 . The most common size is 1200×627.
• wmin – The minimum requested width of the image in pixels. This option should be used for any rescaling of images by the client. Either w or wmin should be transmitted. If only w is included, it should be considered an exact requirement. 
• hmin – The minimum requested height of the image in pixels. This option should be used for any rescaling of images by the client. Either h or hmin should be transmitted. If only h is included, it should be considered an exact requirement.

Title Object

• len – Maximum length of the text in the title element. Always set to 140.

Data Object

• type – Type ID of the element supported by the publisher. The publisher can display this information in an appropriate format. 
  • Most Common Data Types:
    • 12 (ctatext) CTA description – descriptive text describing a ‘call to action’ button for the destination URL. Optional. Max 15 or longer. 
    • 2 (desc) – Descriptive text associated with the product or service being advertised. A longer length of text in response may be truncated or ellipse by the exchange. Max 140 or longer. 
    • 3 (rating) Rating of the product being offered to the user. For example, an app’s rating in an app store from 0-5. number formatted as string 
• len – Maximum length of the text in the element’s response

Native Markups Response Object

• ver – Version of the Native Markup version in use. Smaato expects 1.1. 
• assets – List of native ad’s assets. Required. 
• link – Destination Link. This is the default link object for the ad. Individual assets can also have a link object which applies if the asset is activated(clicked). If the asset doesn’t have a link object, the parent link object applies. 
• imptrackers[] – Array of impression tracking URLs, expected to return a 1×1 image or 204 response – typically only passed when using 3rd party trackers.

Asset Object

• id – Unique asset ID, assigned by exchange, must match one of the asset IDs in request. 
• required – Set to 1 if asset is required. 
• title – Title object for title assets. 
• img – mage object for image assets

Title Object

• text – The text associated with the text element.

Image Object

• url – URL of the image asset. 
• w – Width of the image in pixels. 
• h – Height of the image in pixels.

Data Object

• value – The formatted string of data to be displayed. Can contain a formatted value such as “5 stars” or “$10” or “3.4 stars out of 5”. 

Link Object

• url – Landing URL of the clickable link.

Last Modified: November 29, 2021 at 2:07 pm