Native Ad Format

InMobi supports IAB Dynamic Native Ads 1.2 specifications. For more information, see OpenRTB Dynamic Native Ads API (version 2.5).

Note

InMobi supports IAB Dynamic Native Ads versions: 1.1 & 1.2.
The ad-markup 'adm' in the bid-response will be a native response object represented as a 'JSON string'.
For bid requests received with Native version 1.1, impressions will be billed using trackers in the 'imptrackers' array within the ad markup 'adm'.
For bid requests received with Native version 1.2, impressions will be billed using trackers in the 'eventtrackers' array within the ad markup 'adm'.

Native Format Ad Request Markup details

OBJECT: Bidrequest.Imp.Native.Request

Attribute	Type	Description
ver	string; default 1; optional	Version of the Native Markup version in use.
plcmtcnt	integer; default 1; optional	The number of identical placements in this Layout. Multiplacement bid requests are currently not supported. InMobi will return a maximum of one bid.
assets	object array; required	An array of Asset Objects. Any bid must comply with the array of elements expressed here.
seq	Integer; default 0; optional	xx (see the IAB Core Six layout types). 0 for the first ad, 1 for the second ad, and so on. This is not the sequence number of the content in the stream.
plcmttype	Integer; recommended	The design/format/layout of the ad unit being offered. Refer IAB Dynamic Native Ads 1.2 specifications
eventtrackers	array of objects; optional	Specifies what type of event tracking is supported – see Event Trackers Request Object.
privacy	Integer; recommended	Set to 1 when the native ad supports buyer-specific privacy notice. The field is absent when the native ad doesn’t support custom privacy links or if support is unknown.

OBJECT: Bidrequest.Imp.Native.Request.Assets

This is the main container object for each asset requested or supported by Exchange on behalf of the rendering client. You must flag the object you require. Also, you must add only one of the {title,img,data} objects.

Attribute	Type	Description
id	Integer; required	Unique asset ID. Denotes the counter for the array.
required	integer; default 0; required	Set to 1 if the asset is required (The InMobi RTB Platform will not accept a bid without it)
title	object; optional; recommended	Title object for title assets. See Title Object definition below.
img	object; optional; recommended	Image object for image assets. See Image Object definition below.
video	Object; optional	Video object for video assets.
data	object; optional	Data object for ratings, prices, and so on. See the Data Object definition below.

OBJECT: Bidrequest.Imp.Native.Request.Assets.Title

You must use the Title object for the title element of the Native ad.

Attribute	Type	Description
len	Integer; required	The maximum length of the text in the title element. Recommended to be 25, 90, or 140.

OBJECT: Bidrequest.Imp.Native.Request.Assets.Image

You must use the Image object for all image elements of the Native ad such as Icons, Main Image, and so on.

Attribute	Type	Description
type	Integer; optional	Type ID of the image element supported by the publisher. The publisher can display this information in an appropriate format. Refer IAB Dynamic Native Ads 1.2 specifications
wmin	Integer; required	The minimum requested width of the image in pixels.
hmin	Integer; required	The minimum requested height of the image in pixels.
w	Integer; optional	Width in device independent pixels (DIPS)
h	Integer; optional	Height in device independent pixels (DIPS)
ext	Object; optional	Refer to Section 4.1.4.1 for Image Object Extension

OBJECT: Bidrequest.Imp.Native.Request.Assets.Video

Attribute	Type	Description
mimes	Required; Array of string	Content MIME types supported.
minduration	Required; integer	Minimum video ad duration in seconds
maxduration	Integer	Maximum video ad duration in seconds
protocols	Array of integers	An array of video protocols the publisher can accept in the bid response. For more information, see OpenRTB Dynamic Native Ads API (version 2.5).

OBJECT: Bidrequest.Imp.Native.Request.Assets.Data

You must use the Data Object for all the non-core elements of the native unit such as Brand Name, Ratings, Review Count, Stars, Download count, descriptions, and so on.

Attribute	Type	Description
type	Integer; required	Type ID of the element supported by the publisher. The publisher can display this information in an appropriate format. Refer IAB Dynamic Native Ads 1.2 specifications
len	integer; optional	The maximum length of the text in the element’s response.

OBJECT: Event Tracker's Request

The event trackers object specifies the types of events the bidder can request to be tracked in the bid response, and which types of tracking are available for each event type and is included as an array in the request.

Attribute	Type	Description
event	Integer; required	Type of event available for tracking. See Event Types table. InMobi supports 1 = Impression tracking
methods	array of integers; required	Array of the types of tracking available for the given event. See Event Tracking Methods table. InMobi supports 1 = img pixel

Native Ad Response Markup Details

OBJECT: Bid.adm.native

The native object is the top-level JSON object which identifies a native response.
Note that bid.adm is a string field. The content of the adm field will be a JSON encoded string (stringified JSON).

Attribute	Type	Description
ver	integer; default 1; recommended	The version of the Native Markup version in use.
assets	object array; required	List of native ad’s assets.
link	object; required	Destination Link. This is the default link object for the ad.
eventtrackers	an array of objects; optional	An array of tracking objects to run with the ad, in response to the declared supported methods in the request.
privacy	String; optional	If support was indicated in the request, the URL of a page informing the user about the buyer’s targeting activity

OBJECT: Bid.adm.native.assets

Corresponds to the Asset Object in the request. The main container object for each asset requested or supported by Exchange on behalf of the rendering client. Any object that is required is to be flagged as such. Only one of the {title,img,data} objects should be present in each object. All others should be null/absent. The id is to be unique within the AssetObject array so that the response can be aligned.

Attribute	Type	Description
id	integer; required	Unique asset id assigned by the exchange.
required	Integer; default 0	Set to 1 if the asset is required (will not accept a bid without it).
title	Object; optional	Title object for title assets. See Title Object definition. (Section 5.1.2). Refer IAB Dynamic Native Ads 1.2 specifications
img	Object; optional	Image object for image assets. See Image Object definition (Section 5.1.3). Refer IAB Dynamic Native Ads 1.2 specifications
data	Object; optional	Data object for ratings, prices, and so on. See the Data Object definition (Section 6.7.5). Refer IAB Dynamic Native Ads 1.2 specifications
link	Object; optional	Refer to Section 5.1.6 Refer IAB Dynamic Native Ads 1.2 specifications

OBJECT: Bid.adm.native.assets.title

Corresponds to the Title Object in the request, with the value filled in.

Attribute	Type	Description
text	string; required	The text to be placed in the text element.

OBJECT: Bid.adm.native.assets.img

Corresponds to the Image Object in the request. The Image object to be used for all image elements of the Native ad such as Icons, Main Image, etc.

Attribute	Type	Description
url	string; required	URL of the image asset.
w	integer; recommended	Width of the image in pixels.
h	integer; recommended	Height of the image in pixels.

OBJECT: Bid.adm.native.assets.data

Corresponds to the Data Object in the request, with the value filled in. The Data Object is to be used for all miscellaneous elements of the native unit such as Brand Name, Ratings, Review Count, Stars, Downloads, Price count etc.

Attribute	Type	Description
label	String; optional	The optional formatted string name of the data type to be displayed.
value	string; required	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”.

OBJECT: Bid.adm.native.assets.link

This is used for ‘call to action’ assets, or other links from the Native ad.

Attribute	Type	Description
url	string; required	Landing URL of the clickable link.
clicktrackers	string array	List of third-party tracker URLs to be fired on click of the URL. InMobi Click tracker should be inserted here
fallback	string	Fallback URL for deeplink. To be used if the URL given in the "url" property is not supported by the device.

OBJECT: EVENT TRACKER

This is where the InMobi impression beacon will be inserted

Attribute	Type	Description
event	Integer; required	Since InMobi impression tracker is a 1x1 img pixel, this is ‘1’ for InMobi impression counting. However, advertiser specific events can have other event types as well. Refer IAB Dynamic Native Ads 1.2 specifications
method	Integer; required	For impression counting, this will be ‘1’. Refer IAB Dynamic Native Ads 1.2 specifications
url	Text; optional	All event URLs will be present here.

Last Updated on: 14 Sep, 2022

You are almost there...

By installing this SDK update, you agree that your Children Privacy Compliance setting remains accurate or that you will update that setting, whenever there is a change in your app's audience. You may update the app's Children Privacy Compliance settings at https://publisher.inmobi.com/my-inventory/app-and-placements.

I AGREE

Additional Reading