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.

Modified: June 13, 2019 at 10:04 am