S2S Reference

Required Headers:

Nimbus-Api-Key

Needed to validate the request to Nimbus, please ask your ad manager for this key

Example:

Nimbus-Api-Key: 8cd759c3-44bb-43b4-90ae-f5bdd714284e

Object: BidRequest

Atribute	Type	Description
imp	object array; required	Currently only an array of size 1 is supported, see section 3.2.4
app	object; optional	See ORTB 2.5 section 3.2.14
device	object; required	See ORTB 2.5 section 3.2.18
user	object; recommended	See ORTB 2.5 section 3.2.20
test	integer; default 0	When set to one auctions are not billable and a Nimbus test creative will be served, where 0 = live mode, 1 = test mode
wseat	string array;	See ORTB section 3.2.1
bseat	string array;	See ORTB section 3.2.1
wlang	string array;	See ORTB section 3.2.1
bcat	string array;	See ORTB section 3.2.1
badv	string array;	See ORTB section 3.2.1
bapp	string array;	See ORTB section 3.2.1
source	object;	Source object is needed if using the OM SDK
regs	object; recommended	See ORTB 2.5 section 3.2.1
ext	object; required	Nimbus specific extension needed for authentication validation and session identifiers

Object: Ext (BidRequest extension object)

Atribute	Type	Description
session_id	string; required	Needed for tracing and client side rate limiting, this id should be passed for each ad request, for the entire user session and be the same for the apps life cycle

Object: Regs

Atribute	Type	Description
coppa	integer	See ORTB 2.5 section 3.2.3
ext	object; recommended	See ORTB 2.5 section 3.2.3, to be GDPR compliant, the consent value is passed in this extension

Object: Ext (Regs extension object)

Atribute	Type	Description
gdpr	integer; default 0	See section gdpr compliance documentation
us_privacy	string	See section ccpa compliance documentation)
gpp	string	See IAB spec
gpp_sid	string	See IAB spec

Object: Imp

The impression object has been modified from the ORTB specification. Nimbus allows for both the Banner object and Video object to be present in the same Imp object. This allows for hybrid auctions to be run on the Nimbus ad server, where both static demand and video demand are part of the same auction for the same inventory. This removes the need to make two separate calls to Nimbus and unifies the competition. note: While both the banner object and video object are optional, at least 1 must be present in the request

Atribute	Type	Description
banner	object; optional	See ORTB 2.5 section 3.2.6
video	object; optional	See ORTB 2.5 section 3.2.7
instl	integer; default 0	See ORTB 2.5 section 3.2.4 required if using Banner Ad sizes 320x480 or 480x320
secure	integer; default 1	See ORTB 2.5 section 3.2.4
ext	object; required	Used to pass in the optional APS and Facebook data as well as the required position data

Object: Ext (Imp extension object)

Atribute	Type	Description
position	string; required	Adds meta about the placement of the impression. It allows publishers to track performance of placements, naming nomenclature is left up to the publisher. Be mindful that this affects the ability to break out reports by placements on the Nimbus dashboard. This should not be an auto incremented id, instead it should be a static string that represents the actual placement of the ad
facebook_app_id	string; optional	Needed if integrated with facebook demand and to run them in the auction, this is equal your facebook app id
aps	APS object array; optional	Needed if integrated with amazon's APS demand used by the Nimbus SDK.
skadn	skadn object; optional	See IAB Spec for more details

Object: Banner

note: The height and width in the banner object is extremely important and it is not equal to the height and width of the device. Take special care as it effects the types of ads returned Acceptable ad sizes for Banner.h and Banner.w

Canonical Name	Size (WxH)
Banner300x50	300x50
Banner320x50	320x50
Interstitial Portrait	320x480
Interstitial Landscape	480x320
HalfScreen	300x600
LetterBox	300x250
LeaderBoard	728x90

The Interstitial ad size type is special. If Interstitial Portrait or Interstitial Landscape landscape sizes are submitted in the Banner request, the Banner.Format array will be used to allow for additional ad sizes to fill the full screen placement. This is a great way to increase fill, by allowing additional demand for the same placement. If any other size from the above table is submitted Nimbus will ensure ONLY that ad size is returned in the response.

Atribute	Type	Description
bidfloor	float	This deviates from ORTB 2.5. This floor for dictates the minimum bid value RTB demand sources are allowed to pass Nimbus for a static asset. If the field is not explicitly set then a value of 0.0 will be sent to demand
battr	integer array;	Blocked creative attributes. Refer to ORTB 2.5 List 5.3
format	object array; recommended	See ORTB 2.5 section 3.2.6, is an array of supported ad sizes for the placement and is only valid given the request for a an interstitial placement, see the example bid request for an example
w	integer	See ORTB 2.5 section 3.2.6, this is equal to a single supported ad size. For example for interstitial ads set to 320, rectangle banners set to 300, and for small banners set to 728
h	integer	See ORTB 2.5 section 3.2.6 this is equal to a single supported ad size. For example for interstitial ads set to 420, rectangle banners set to 250, and for small banners set to 90
api	integer array	See ORTB 2.5 section 3.2.6, if using the Nimbus Render SDK it is recommended that values 5 and 6 be sent as they enable MRAID, see list 5.6
pos	integer; recommended	See ORTB 2.5 section 3.2.6
vcm	integer	See ORTB 2.5 section 3.2.6

Object: Video

Atribute	Type	Description
bidfloor	float	This deviates from ORTB 2.5. This floor for dictates the minimum bid value RTB demand sources are allowed to pass Nimbus for a video asset. If the field is not explicitly set then a value of 0.0 will be sent to demand
companionad	banner object array	See ORTB 2.5 section 3.2.7
companiontype	interger array	See ORTB 2.5 section 3.2.7
battr	integer array	Blocked creative attributes. Refer to ORTB 2.5 List 5.3
mimes	string array; required	See ORTB 2.5 section 3.2.7, example [video/mp4]
minduration	integer; recommended; defaults 0	See ORTB 2.5 section 3.2.7
maxduration	integer; recommended; defaults 60	See ORTB 2.5 section 3.2.7
protocols	integer array; recommended	See ORTB 2.5 section section 5.8 If using the Nimbus Render SDK the suggested values are [2,3,5,6]
w	integer	See ORTB 2.5 section 3.2.7, this is equal to the devices width
h	integer	See ORTB 2.5 section 3.2.7, this is equal to the devices height
startdelay	integer; default 0	See ORTB 2.5 section 3.2.7
placement	integer; default 0	Placement type for the impression. Refer to ORTB List 5.9
linearity	integer; default 0	Indicates if the impression must be linear, nonlinear, etc. Refer to ORTB List 5.7
playbackmethod	integer array; recommended; default 2	See ORTB 2.5 section 5.10
skip	integer; default 0	See ORTB 2.5 section 3.2.7
delivery	integer array;	Supported delivery methods (e.g., streaming, progressive). Refer to ORTB List 5.15
pos	integer; recommended	See ORTB 2.5 section 3.2.7
api	integer array;	List of supported API frameworks for this impression. Refer to ORTB List 5.6. If an API is not explicitly listed, it is assumed not to be supported
minbitrate	integer; recommended; default 0	See ORTB 2.5 section 3.2.7
maxbitrate	integer; recommended; default 20000	See ORTB 2.5 section 3.2.7

Object: Ext (Video extension object)

Atribute	Type	Description
is_rewarded	integer; default 0	Flags to Nimbus and any supporting demand that this request is for a rewarded video ad
max_pod_count	integer; default 0	**Only used for video ad podding. Limits the amount of video VAST objects that are stitched together. See the CTV endpoint.
max_pod_duration_in_seconds	integer; default 0	**Only used for video ad podding. Limits the amount of video VAST objects that are stitched together. See the CTV endpoint.

Object: Format

This is object normally is found with the imp[0].banner to extend the possible ad sizes allowed for the auction if the banner is of type full screen interstitial (320x480)

Atribute	Type	Description
w	int; required	See ORTB 2.5 section 3.2.10
h	int; required	See ORTB 2.5 section 3.2.10

Object: App

Information like the name, bundle, domain, and storeurl are constructed using the Nimbus databases. Therefore this is not information that is required to be sent. However, it is highly recommended to send all other metadata about your application for buyers

Atribute	Type	Description
name	string; recommended	See ORTB 2.5 section 3.2.14
bundle	string; recommended	See ORTB 2.5 section 3.2.14
domain	string; recommended	See ORTB 2.5 section 3.2.14
storeurl	string; recommended	See ORTB 2.5 section 3.2.14
cat	string array; recommended	See ORTB 2.5 section 3.2.14
sectioncat	string array;	See ORTB 2.5 section 3.2.14
pagecat	string array;	See ORTB 2.5 section 3.2.14
ver	string; recommended	See ORTB 2.5 section 3.2.14
privacypolicy	int; recommended; default 0	See ORTB 2.5 section 3.2.14
paid	int; recommended; default 0	See ORTB 2.5 section 3.2.14
content	object: recommended for CTV inventory	See ORTB 2.5 section 3.2.16

Object: Content

This object describes the content in which the impression will appear, which may be syndicated or nonsyndicated content. This object may be useful when syndicated content contains impressions and does not necessarily match the publisher’s general content. The exchange might or might not have knowledge of the page where the content is running, as a result of the syndication method. For example might be a video impression embedded in an iframe on an unknown web property or device. Must commonly used for CTV applications or Audio based applications

Atribute	Type	Description
id	string	See ORTB 2.5 section 3.2.16
episode	int	See ORTB 2.5 section 3.2.16
title	string	See ORTB 2.5 section 3.2.16
series	string	See ORTB 2.5 section 3.2.16
season	string	See ORTB 2.5 section 3.2.16
artist	string	See ORTB 2.5 section 3.2.16
genre	string	See ORTB 2.5 section 3.2.16
album	string	See ORTB 2.5 section 3.2.16
isrc	string	See ORTB 2.5 section 3.2.16
producer	object	See ORTB 2.5 section 3.2.17
url	string	See ORTB 2.5 section 3.2.16
cat	string array	See ORTB 2.5 section 3.2.16
prodq	int	See ORTB 2.5 section 3.2.16
context	int	See ORTB 2.5 section 3.2.16
contentrating	string	See ORTB 2.5 section 3.2.16
userrating	string	See ORTB 2.5 section 3.2.16
qagmediarating	int	See ORTB 2.5 section 3.2.16
keywords	string	See ORTB 2.5 section 3.2.16
livestream	int	See ORTB 2.5 section 3.2.16
sourcerelationship	int	See ORTB 2.5 section 3.2.16
len	int	See ORTB 2.5 section 3.2.16
language	string	See ORTB 2.5 section 3.2.16
embeddable	int	See ORTB 2.5 section 3.2.16

Object: Producer

This object defines the producer of the content in which the ad will be shown. This is particularly useful when the content is syndicated and may be distributed through different publishers and thus when the producer and publisher are not necessarily the same entity.

Atribute	Type	Description
id	string	See ORTB 2.5 section 3.2.17
name	int	See ORTB 2.5 section 3.2.17
cat	string array	See ORTB 2.5 section 3.2.17
domain	string	See ORTB 2.5 section 3.2.17

Object: APS

The APS data structure is gotten from a proper invocation of the APS SDK. This information is passed to Nimbus so that it can include APS in an agnostic fair auction. Nimbus will return the APS markup in the bid response if APS wins the auction. Note the APS SDK does not send normalized data between video and static demand. The response is also different between app platforms. For Publishers using the Nimbus Request SDK this is handled for you. For Publishers making a server call to Nimbus, simply take the information your client sends you as is and pass it Nimbus. Nimbus will normalize the Data types to []string.

Atribute	Type	Description
amzn_b	any type (string or string array); required	Data from the Response from the APS SDK
amzn_h	any type (string or string array); required	Data from the Response from the APS SDK
amzn_vid	any type (string or string array); required	Data from the Response from the APS SDK
amznp	any type (string or string array); required	Data from the Response from the APS SDK
amznrdr	any type (string or string array); required	Data from the Response from the APS SDK
amznslots	any type (string or string array); required	Data from the Response from the APS SDK
dc	any type (string or string array); required	Data from the Response from the APS SDK

Object: Device

Atribute	Type	Description
ua	string; required	See ORTB 2.5 section 3.2.18, this must be a valid web-view based user-agent. The Nimbus SDK provides this. If the user agent supplied does not meet the above standard the request will be blocked.
geo	object; recommended	See ORTB 2.5 section 3.2.18
dnt	int; recommended	See ORTB 2.5 section 3.2.18
lmt	int; recommended	See ORTB 2.5 section 3.2.18
ip	string; required	See ORTB 2.5 section 3.2.18, this must be the ip on the handheld device not a server ip, if is missing the X-Forwarded-For header will be looked for the ip. If the body and header are missing the IP the request will fail
devicetype	integer; required	See ORTB 2.5 section 3.2.18
make	string; required	See ORTB 2.5 section 3.2.18, if os is ios the make should be apple; if the os is android the make should be android
model	string; required	See ORTB 2.5 section 3.2.18, The model of the device e.g. iPhone 11 or Pixel 3
os	string; required	See ORTB 2.5 section 3.2.18, this is a Nimbus + DSP requirement. os is either android or ios
osv	string; recommended	See ORTB 2.5 section 3.2.18, if this field is missing certain DSP buyers will not buy your inventory
w	int;	See ORTB 2.5 section 3.2.18
h	int;	See ORTB 2.5 section 3.2.18
connectiontype	integer;	See ORTB 2.5 section 5.22, note we support connection type value of 7 for 5G connections.
ifa	string; required	See ORTB 2.5 section 3.2.18, this is also known as the advertising id

Object: Ext (Device extension object)

Note: This only pertains to iOS devices.

If the IDFA is not available, DSPs require an alternative, limited-scope identifier in order to provide basic frequency capping functionality to advertisers. The IDFV is the same for apps from the same vendor but different across vendors. Please refer to Apple's Guidelines for further information about when it can be accessed and used.

DSPs may also want to understand what is the status of a user on iOS 14+. The atts field will pass the AppTrackingTransparency Framework's authorization status.

Atribute	Type	Description
atts	int; required	See ORTB Apple Extension
ifv	string; required	See ORTB Apple Extension

Object: Geo

If the Geo object is missing from the Device object, the geolocation will be determined using the ip of the device and a Geo object will be constructed from that

Atribute	Type	Description
lat	float; required	See ORTB 2.5 section 3.2.19
lon	float; required	See ORTB 2.5 section 3.2.19
type	int; required	See ORTB 2.5 section 3.2.19
ipservice	int; recommended	See ORTB 2.5 section 3.2.19
country	string; required	See ORTB 2.5 section 3.2.19
city	string; recommended	See ORTB 2.5 section 3.2.19
metro	string; recommended	See ORTB 2.5 section 3.2.19
city	string; recommended	See ORTB 2.5 section 3.2.19

Object: User

If the Geo object is missing from the Device object, the geolocation will be determined using the ip of the device and a Geo object will be constructed from that

Atribute	Type	Description
buyeruid	string; recommended	See ORTB 2.5 section 3.2.20, it is used to incorporate facebook into the auction and is equal to the Facebook bidder token given by the Facebook SDK
yob	int; recommended	See ORTB 2.5 section 3.2.20
gender	string; recommended	See ORTB 2.5 section 3.2.20
keywords	string; recommended	See ORTB 2.5 section 3.2.20

Object: Ext (User extension object)

Atribute	Type	Description
consent	string; optional	The GDPR generated consent string. See the IAB spec

Object: Source (User extension object)

Atribute	Type	Description
ext	object; required	Needed to pass OM SDK information

Object: Ext (Source extension object)

Atribute	Type	Description
omidpn	string; required	identifier of the OM SDK integration, this is the same as the "name" parameter of the OMID Partner object
omidpv	string; optional	version of the OM SDK version

JSON Examples

Static Bid Request

{
  "app": {
    "bundle": "foo_bundle",
    "cat": [
      "IAB1"
    ],
    "domain": "https://www.foo_app.com",
    "name": "foo_app",
    "paid": 0,
    "privacypolicy": 1,
    "publisher": {
      "cat": [
        "IAB1",
        "IAB17",
        "IAB12",
        "IAB14",
        "IAB9",
        "IAB20",
        "IAB16",
        "IAB18"
      ],
      "domain": "https://foo_app.com",
      "name": "foo_app"
    },
    "storeurl": "https://apps.apple.com/app/foo_bundle",
    "ver": "0.0.1"
  },
  "badv": [
    "foobar.com"
  ],
  "bapp": [
    "com.foo.bar"
  ],
  "bcat": [
    "IAB_FOOBAR"
  ],
  "device": {
    "carrier": "O2",
    "connectiontype": 6,
    "devicetype": 1,
    "dnt": 1,
    "geo": {
      "country": "GBR",
      "ipservice": 3,
      "lat": 51.4964,
      "lon": -0.1224,
      "metro": "0",
      "type": 2
    },
    "ifa": "cf3af75c-a938-4326-8697-d1a629cda086",
    "ip": "1.0.0.0",
    "language": "en",
    "lmt": 1,
    "make": "Apple",
    "model": "iPhone13,4",
    "os": "ios",
    "osv": "14.7.1",
    "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 14_7_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148"
  },
  "ext": {
    "session_id": "4a74616f-7f0e-4b03-8c4a-2035f12f6178"
  },
  "imp": [
    {
      "banner": {
        "api": [
          3,
          5
        ],
        "battr": [
          0
        ],
        "bidfloor": 3,
        "format": [
          {
            "h": 480,
            "w": 320
          },
          {
            "h": 250,
            "w": 300
          },
          {
            "h": 1920,
            "w": 1080
          }
        ],
        "h": 480,
        "pos": 7,
        "w": 320
      },
      "clickbrowser": 0,
      "displaymanagerver": "1.10.3",
      "ext": {
        "position": "5",
        "skadn": {
          "skadnetids": [
            "foobar.skadnetwork"
          ],
          "sourceapp": "foo_app_bundle",
          "version": "2.0"
        }
      },
      "instl": 1,
      "secure": 1
    }
  ],
  "regs": {
    "coppa": 0,
    "ext": {
      "gdpr": 1,
      "us_privacy": "1---"
    }
  },
  "user": {
    "age": 27,
    "gender": "female",
    "yob": 1993
  }
}

Video Bid Request

{
  "app": {
    "bundle": "foo_bundle",
    "cat": [
      "IAB1"
    ],
    "domain": "https://www.foo_app.com",
    "name": "foo_app",
    "paid": 0,
    "privacypolicy": 1,
    "publisher": {
      "cat": [
        "IAB1",
        "IAB17",
        "IAB12",
        "IAB14",
        "IAB9",
        "IAB20",
        "IAB16",
        "IAB18"
      ],
      "domain": "https://foo_app.com",
      "name": "foo_app"
    },
    "storeurl": "https://apps.apple.com/app/foo_bundle",
    "ver": "0.0.1"
  },
  "badv": [
    "foobar.com"
  ],
  "bapp": [
    "com.foo.bar"
  ],
  "bcat": [
    "IAB_FOOBAR"
  ],
  "device": {
    "carrier": "O2",
    "connectiontype": 6,
    "devicetype": 1,
    "dnt": 1,
    "geo": {
      "country": "GBR",
      "ipservice": 3,
      "lat": 51.4964,
      "lon": -0.1224,
      "metro": "0",
      "type": 2
    },
    "ifa": "cf3af75c-a938-4326-8697-d1a629cda086",
    "ip": "1.0.0.0",
    "language": "en",
    "lmt": 1,
    "make": "Apple",
    "model": "iPhone13,4",
    "os": "ios",
    "osv": "14.7.1",
    "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 14_7_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148"
  },
  "ext": {
    "session_id": "4a74616f-7f0e-4b03-8c4a-2035f12f6178"
  },
  "imp": [
    {
      "clickbrowser": 0,
      "displaymanagerver": "1.10.3",
      "ext": {
        "position": "5",
        "skadn": {
          "skadnetids": [
            "foobar.skadnetwork"
          ],
          "sourceapp": "foo_app_bundle",
          "version": "2.0"
        }
      },
      "instl": 1,
      "secure": 1,
      "video": {
        "bidfloor": 3,
        "companionad": [
          {
            "h": 50,
            "w": 320
          }
        ],
        "h": 926,
        "linearity": 1,
        "maxbitrate": 20000,
        "maxduration": 60,
        "mimes": [
          "application/x-mpegurl",
          "video/3gpp",
          "video/mp4"
        ],
        "minbitrate": 1,
        "minduration": 0,
        "playbackmethod": [
          2
        ],
        "protocols": [
          2,
          3,
          5,
          6,
          7,
          8
        ],
        "skip": 0,
        "startdelay": 0,
        "w": 428
      }
    }
  ],
  "regs": {
    "coppa": 0,
    "ext": {
      "gdpr": 1,
      "us_privacy": "1---"
    }
  },
  "user": {
    "age": 27,
    "gender": "female",
    "yob": 1993
  }
}

Hybrid Auction Example

Dual Static/Video Bid Request

This is a Nimbus specific example. ORTB does not allow for more than one creative object to be present in the Imp object. However, this would mean as a publisher that you would have to construct two separate request, which would yield two very different auction. To static allow inventory and video inventory to compete in a fair auction, we allow for one than one creative object to be submitted for a single impression. In this case we currently allow for both the Banner object and Video Object to coexist in the Imp Object

{
  "app": {
    "bundle": "foo_bundle",
    "cat": [
      "IAB1"
    ],
    "domain": "https://www.foo_app.com",
    "name": "foo_app",
    "paid": 0,
    "privacypolicy": 1,
    "publisher": {
      "cat": [
        "IAB1",
        "IAB17",
        "IAB12",
        "IAB14",
        "IAB9",
        "IAB20",
        "IAB16",
        "IAB18"
      ],
      "domain": "https://foo_app.com",
      "name": "foo_app"
    },
    "storeurl": "https://apps.apple.com/app/foo_bundle",
    "ver": "0.0.1"
  },
  "badv": [
    "foobar.com"
  ],
  "bapp": [
    "com.foo.bar"
  ],
  "bcat": [
    "IAB_FOOBAR"
  ],
  "device": {
    "carrier": "O2",
    "connectiontype": 6,
    "devicetype": 1,
    "dnt": 1,
    "geo": {
      "country": "GBR",
      "ipservice": 3,
      "lat": 51.4964,
      "lon": -0.1224,
      "metro": "0",
      "type": 2
    },
    "ifa": "cf3af75c-a938-4326-8697-d1a629cda086",
    "ip": "1.0.0.0",
    "language": "en",
    "lmt": 1,
    "make": "Apple",
    "model": "iPhone13,4",
    "os": "ios",
    "osv": "14.7.1",
    "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 14_7_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148"
  },
  "ext": {
    "session_id": "4a74616f-7f0e-4b03-8c4a-2035f12f6178"
  },
  "imp": [
    {
      "banner": {
        "api": [
          3,
          5
        ],
        "battr": [
          0
        ],
        "bidfloor": 2,
        "format": [
          {
            "h": 480,
            "w": 320
          },
          {
            "h": 250,
            "w": 300
          },
          {
            "h": 1920,
            "w": 1080
          }
        ],
        "h": 480,
        "pos": 7,
        "w": 320
      },
      "clickbrowser": 0,
      "displaymanagerver": "1.10.3",
      "ext": {
        "position": "5",
        "skadn": {
          "skadnetids": [
            "foobar.skadnetwork"
          ],
          "sourceapp": "foo_app_bundle",
          "version": "2.0"
        }
      },
      "instl": 1,
      "secure": 1,
      "video": {
        "bidfloor": 3,
        "companionad": [
          {
            "h": 480,
            "w": 320
          }
        ],
        "h": 926,
        "linearity": 1,
        "maxbitrate": 20000,
        "maxduration": 60,
        "mimes": [
          "application/x-mpegurl",
          "video/3gpp",
          "video/mp4"
        ],
        "minbitrate": 1,
        "minduration": 0,
        "playbackmethod": [
          2
        ],
        "protocols": [
          2,
          3,
          5,
          6,
          7,
          8
        ],
        "skip": 0,
        "startdelay": 0,
        "w": 428
      }
    }
  ],
  "regs": {
    "coppa": 0,
    "ext": {
      "gdpr": 1,
      "us_privacy": "1---"
    }
  },
  "user": {
    "age": 27,
    "gender": "female",
    "yob": 1993
  }
}

Bid Response

Mobile

Bid Response Object

Atribute	Type	Description
type	string; required	description of ad returned, e.g static, video, native
auction_id	string; required	nimbus trace id
adomain	string array; optional	list of domains the the ad relates to as defined by the buying DSP or SSP
bid_in_cents	int; required	the winning bid value in cents to avoid float math loss
bid_raw	float; required	the winning bid value as a received from the buyer
content_type	string; optional	http content-type of markup
crid	string; optional	creative id reported by the buyer
height	int; optional	height in px of the ad
width	int; optional	width in px of the ad
is_interstitial	int; required	either 0 or 1 and determines if the ad size is 320x480 (interstitial)
is_mraid	int; required	either 0 or 1 and indicates is mraid.js was found in the HTML markup
markup	string; required	markup containing the asset to render
network	string; required	winning demand source
trackers	Trackers (object); optional	provides additional trackers that must be handled by the Nimbus SDK
placement_id	string; required	placement id as defined by the buyer
duration	int; optional	returns the duration in seconds of the ad if the asset is video
ext	ext object; optional	Additional metadata

Bid Trackers Object

Atribute	Type	Description
impression_trackers	string array; optional	provides a list of trackers that the Nimbus Render SDK has to fire as a callback event to rendering the ad successfully, manually firing the tracker will fail
click_trackers	string array; optional	provides a list of click trackers that the Nimbus Render SDK has to fire as a response to a user click event, manually firing the tracker will fail

Object: Ext (Bid Response extension object)

Atribute	Type	Description
skadn	skadn object; optional	See IAB Spec for more details

CTV

Bid Trackers Object

Atribute	Type	Description
auction_id	string; required	nimbus trace id
content_type	string; required	http content-type of markup
cumulative_bid_in_pod	float; required	total value of VAST pod
highest_bid_in_pod	float; required	the value of the first VAST video in the returned pod
markup	string; required	VAST content for video rendering
pod_count	int; required	number of video ads stitched in the pod
pod_duration_in_seconds	int; required	total duration of the video pod
type	string; required	description of ad returned