Native Markups Request Object

• ver – Version of the native markup in use. Always 1.1.
• plcmttype – Design/format/layout of the ad unit. Smaato supports: chat list, app wall, news feed, carousel, content stream.
• plcmtcnt – Number of identical placements in this layout. Always 1.
• assets – Array of asset objects. Any bid response must comply with the array expressed in the bid request.

Assets Object

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

Image Object

• type – Type ID of the image element supported by the publisher. The publisher can display it appropriately.
• Common Image Types
  • 1 (icon) – max height: at least 50; aspect ratio: 1:1
  • 3 (main) – at least one of two 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
      Most common size is 1200×627.
• wmin – Minimum requested width (px). Use for client rescaling. Either w or wmin should be sent. If only w is included, treat as an exact requirement.
• hmin – Minimum requested height (px). Use for client rescaling. Either h or hmin should be sent. If only h is included, treat as an exact requirement.

Title Object

• len – Maximum text length for the title element. Always 140.

Data Object

• type – Type ID of the element supported by the publisher (publisher decides display format).

Most Common Data Types

• 12 (ctatext) – CTA description (text for a call-to-action button to the destination URL). Optional. Max 15 (or longer).

• 2 (desc) – Descriptive text for the product/service. Longer responses may be truncated or ellipsized by the exchange. Max 140 (or longer).

• 3 (rating) – Product rating (e.g., app store rating 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 in use. Smaato expects 1.1.
• assets – List of the native ad’s assets. Required.
• link – Destination link object for the ad. (Assets may override with their own link; if absent, the parent link applies.)
• imptrackers[] – Array of impression tracking URLs (expect a 1×1 image or 204 response). Typically used for 3rd-party trackers.

Asset Object

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

Title Object (Response)

• text – The text associated with the title element.

Image Object (Response)

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

Data Object (Response)

• value – Formatted string to display (e.g., "5 stars", "$10", or "3.4 stars out of 5").

Link Object

• url – Landing URL of the clickable link.