Open RTB 2.3 Bid Request Specifications
Chartboost bid requests are built to the Open RTB 2.3 standard. The following fields are sent by Chartboost in the bid request. Bidders must ensure that they adhere to the requirements listed. DSPs should refer to the sample bid requests provided in the Example Request section for a comparison of different placement types and creative types.
BidRequest π
The BidRequest parent object contains the following fields:
| Field | Type | Description |
|---|---|---|
| id | String | A Chartboost-defined unique identifier for this bid request. |
| imp | Object array | Impression object. Always only one per bid request. |
| app | Object | App object. Details about the publisher app requesting an impression. |
| device | Object | Device object. Contains information on device such as make, model, os, etc. |
| user | Object | User object. |
| test | Integer | Indicator of test mode in which auctions are not billable, where 0 = live mode, 1 = test mode. |
| at | Integer | Auction type. Default value is 1, representing first-price auctions. |
| tmax | Integer | Maximum time in milliseconds to submit a bid to avoid timeout. Default value is 400 and is the same for all auction participants. |
| cur | String array | Currency. Always set to [ "USD" ]. |
| bcat | String array | IAB categories that are blocked. There are categories we block exchange-wide listed in Blocked Categories on Chartboost Exchange. Note that individual publishers may block additional categories in bcat. |
| badv | String array | Block list of advertisers by their domains (e.g., βford.comβ). Omitted if no blocked domains exist. |
| bapp | String array | Block list of applications by their app store IDs. Omitted if no blocked bundles exist. |
| source | Object | Source object. Provides data about the inventory source and which entity makes the final decision. |
| regs | Object | Regs object. Specifies any industry, legal, or governmental regulations in force for this request. |
| ext | Object | Placeholder for exchange-specific extensions to OpenRTB. |
BidRequest.imp π
| Field | Type | Description |
|---|---|---|
| id | String | A Chartboost-defined unique identifier for this impression. |
| banner | Object | Object indicating that a banner format creative is expected in the response. |
| video | Object | High-level object indicating that a video format creative following the defined VAST standard(s) is expected in the response. |
| pmp | Object | Pmp object. Collection of private marketplace (PMP) deals applicable to this impression. |
| displaymanager | String | Name of ad mediation partner, SDK technology, or player responsible for rendering ad (typically video or mobile). Used by some ad servers to customize ad code by partner. |
| displaymanagerver | String | Version of ad mediation partner, SDK technology, or player responsible for rendering ad (typically video or mobile). Used by some ad servers to customize ad code by partner. |
| instl | Integer | Default 0. 1 for Interstitial and Rewarded placement types, 0 for Banner placements. |
| tagid | String | A Chartboost-defined string indicating the in-game location where an ad is being requested (String). |
| bidfloor | Float | Minimum expected bid value for this request. |
| bidfloorcur | String | Always set to 'USD'. |
| clickbrowser | Integer | Indicates the type of browser opened upon clicking the creative, where 0 = embedded, 1 = native. Always set to 1. |
| secure | Integer | Always set to 1, indicating that all asset URLs must be https. |
| exp | Integer | Advisory as to the number of seconds that may elapse between the auction and the actual impression. |
| ext | Object | Placeholder for exchange-specific extensions to OpenRTB. |
BidRequest.imp[].banner π
| Field | Type | Description |
|---|---|---|
| w | Integer | Default IAB standard size unless otherwise requested during integration, e.g. 320 or 480 for Phones, 1024 or 768 or 728(banner) for Tablets. |
| h | Integer | Default IAB standard size unless otherwise requested during integration, e.g. 320 or 480 or 50(banner) for Phones, 1024 or 768 or 90(banner) for Tablets. |
| btype | Integer array | Blocked banner types for this ad placement. Refer to list 5.2 of the Open RTB 2.6 specifications. Chartboost always sends [4] to block the iframe banner type. |
| battr | Integer array | Blocked IAB creative attributes for this ad placement. There are attributes we block on Chartboost Exchange listed in Blocked Attributes On Chartboost Exchange. Note that individual publishers may block additional attributes in battr. Refer to list 5.3 of the Open RTB 2.6 specifications. |
| pos | Integer | Ad position on the screen. All interstitial and rewarded placements are fullscreen and set to 7. All banner-size placements are set to 1. |
| topframe | Integer | Always set to 1. The use of iFrames in the payload is not supported or allowed. |
| api | Integer array | Indicates supported MRAID versions (Array of integers). Typically [3,5,7]. Chartboost SDK supports MRAID-1, MRAID-2 and OMID-1 methods. Please see the Creatives & Ad Formats section below for more details. |
| ext | Object | Placeholder for exchange-specific extensions to OpenRTB. |
BidRequest.imp[].banner.ext π
| Field | Type | Description |
|---|---|---|
| placementtype | String | Type of ad being placed. Possible values are banner, interstitial, or rewarded. |
| playableonly | Boolean | Indicates if banner ad format must be a playable ad. If true, the value of BidResponse.seatbid.bid.ext.crtype in your bid response must be "MRAID playable". |
BidRequest.imp[].video π
| Field | Type | Description |
|---|---|---|
| mimes | String array | Content MIME types supported. Chartboost only supports video/mp4. |
| minduration | Integer | Minimum video ad duration in seconds. Current default is 6. |
| maxduration | Integer | Maximum video ad duration in seconds. Chartboost default is 45; ranges between 30-120 seconds, configurable by the publisher. |
| protocols | Integer array | Supported video bid response protocols. Default includes 2 (VAST 2.0), 3 (VAST 3.0), 5 (VAST 2.0 Wrapper), 6 (VAST 3.0 Wrapper), 7 (VAST 4.0), 8 (VAST 4.0 Wrapper), 11 (VAST 4.1), 12 (VAST 4.1 Wrapper), 13 (VAST 4.2), 14 (VAST 4.2 Wrapper), 15 (VAST 4.3), 16 (VAST 4.3 Wrapper). |
| w | Integer | Default IAB standard size, unless otherwise requested during integration. |
| h | Integer | Default IAB standard size, unless otherwise requested during integration. |
| placement | Integer | Placement type for the impression. Chartboost currently supports only 5 (Interstitial/Sliding/Floater). |
| linearity | Integer | Indicates if the impression is linear, nonlinear, etc.. Chartboost currently supports only linear/in-stream (1) impressions. |
| skip | Integer | Indicates whether the user can skip the video ad after 5 seconds of playback. 0: no, 1: yes. |
| battr | Integer array | Blocked IAB creative attributes for this ad placement. There are attributes we block on Chartboost Exchange listed in Exchange Wide Blocks. Note that individual publishers may block additional attributes in battr. Refer to list 5.3 of the Open RTB 2.6 specifications. |
| maxbitrate | Integer | Maximum bit rate in Kbps. Chartboost will always send 6000. |
| playbackmethod | Integer array | Allowed playback methods. Current default is 1 (Auto-Play Sound On) but 2 (Auto-Play Sound Off) could be sent depending on publisher preference for muted ads. |
| delivery | Integer array | Indicates the supported delivery method. Chartboost strongly recommends using progressive video content delivery (2). |
| pos | Integer | Ad position on the screen. Chartboost currently supports only 7 (Full Screen) for interstitial/rewarded placements. |
| companionad | Object array | Defines companion ad (VAST end card) specs. Please refer to the CompanionAd object. |
| companiontype | Integer array | Indicates that only Static or HTMLResource companion ad types are allowed. Chartboost currently supports both. New: mraid.js is supported in HTMLResource companion ads as of December 2019. |
| ext | Object | Placeholder for exchange-specific extensions to OpenRTB. |
BidRequest.imp[].video.companionad π
| Field | Type | Description |
|---|---|---|
| w | Integer | Default IAB standard size, e.g. 320 or 480 for Phones, 1024 or 768 for Tablets. |
| h | Integer | Default IAB standard size, e.g. 320 or 480 for Phones, 1024 or 768 for Tablets. |
| btype | Integer array | Blocked banner types for this ad placement. Refer to list 5.2 of the Open RTB 2.6 specifications., Chartboost always sends [4] to block the iframe banner type. |
| battr | Integer array | Blocked IAB creative attributes for this ad placement. There are attributes we block on Chartboost Exchange listed in Exchange Wide Blocks. Note that individual publishers may block additional attributes in battr. Refer to list 5.3 of the Open RTB 2.6 specifications. |
| pos | Integer | Ad position on the screen. Always be set to 7, since all Chartboost end cards are shown in full-screen format. |
| api | Integer array | Indicates supported MRAID versions (Array of integers). Typically [3,5,7]. Chartboost SDK supports MRAID-1, MRAID-2 and OMID-1 methods. Please see the Creatives & Ad Formats section below for more details. |
| id | String | Unique identifier for this companion ad object. Will always be set to 1 |
| ext | Object | Placeholder for exchange-specific extensions to OpenRTB. |
BidRequest.imp[].video.ext π
| Field | Type | Description |
|---|---|---|
| placementtype | String | Type of ad being placed. Will be either rewarded or interstitial. |
BidRequest.imp[].pmp π
| Field | Type | Description |
|---|---|---|
| private_auction | Integer | Default 0. Indicator of auction eligibility to seats named in the Direct Deals object, where 0 = all bids are accepted, 1 = bids are restricted to the deals specified and the terms thereof. |
| deals | Object array | Array of Deal objects that convey the specific deals applicable to this impression. |
| ext | Object | Placeholder for exchange-specific extensions to OpenRTB. |
BidRequest.imp[].pmp[].deals π
| Field | Type | Description |
|---|---|---|
| id | String | A unique identifier for the direct deal. |
| bidfloor | Float | Minimum bid for this impression expressed in CPM. |
| at | Integer | Optional override of the overall auction type of the bid request, where 1 = First Price, 2 = Second Price Plus, 3 = the value passed in bidfloor is the agreed upon deal price. Additional auction types can be defined by the exchange. |
| ext | Object | Placeholder for exchange-specific extensions to OpenRTB. |
BidRequest.app π
| Field | Type | Description |
|---|---|---|
| id | String | An internal Chartboost ID for the publishing app. |
| name | String | Name of the publishing app as it appears in the app store. If no name is found, the name designated by the publisher in the Chartboost dashboard. |
| bundle | String | Bundle ID of the app. Chartboost will by default send iTunes Store ID (e.g. 907175713) instead of package id (e.g. com.foo.bar) for iOS apps. |
| storeurl | String | App store URL for the app. |
| cat | String array | IAB category of the app. Chartboost inventory is primarily mobile games and we use 42Matters to enrich this field further in order to provide multiple categories based on the content of the app. 42Matters uses IAB Categories v1.0 standard taxonomy where the full list of categories available can be found here. |
| ver | String | Application version. |
| publisher | Object | Please refer to the Publisher object. |
| ext | Object | Placeholder for exchange-specific extensions to OpenRTB. Please refer to the App Ext object. |
BidRequest.app.publisher π
| Field | Type | Description |
|---|---|---|
| id | String | An internal Chartboost ID for the publisher. |
| name | String | Name of the publisher. |
| ext | Object | Placeholder for exchange-specific extensions to OpenRTB. |
BidRequest.app.ext π
| Field | Type | Description |
|---|---|---|
| package | String | Package id of the app. For Google Play apps, same value as the app.bundle, for iOS apps this will be the appβs package build name, e.g. com.foo.bar. |
| platform | String | Platform of the app. Values are iOS, Google Play and Amazon. |
BidRequest.device π
| Field | Type | Description |
|---|---|---|
| geo | Object | Object containing country, type, region, city, and ZIP code. This information is inferred based on the device IP. Note: Chartboost does not provide latitudinal & longitudinal data. |
| lmt | Integer | Limit Ad Tracking. 1 implies the advertising ID should not be used to track this device. DSPs must adhere to this restriction. When LAT is enabled on iOS, device ids are masked (all zeroes). |
| ua | String | User-Agent, e.g. 'Mozilla/5.0 (iPhone; CPU OS 9_0 like Mac OS X) AppleWebKit/601.1.16 (KHTML, like Gecko) Version/8.0 Mobile/13A171a Safari/600.1.4' |
| ip | String | Device IPv4. |
| ipv6 | String | Device IPv6. Optional, only included when in addition to IPv4. |
| devicetype | Integer | Indicates type of device. Chartboost currently passes 1 (Mobile/Tablet), 4 (Phone), and 5 (Tablet) |
| make | String | Device make, e.g. 'Apple'. |
| model | String | Device model, e.g. 'iPhone8,1'. |
| os | String | Operating system, e.g. 'iOS', 'Android'. |
| osv | String | Version of operating system, e.g. 'iOS 13.2' |
| hwv | String | Hardware version of the device. |
| h | Integer | Height of device as inferred by Chartboost SDK. |
| w | Integer | Width of device as inferred by Chartboost SDK. |
| pxratio | Float | The ratio of physical pixels to device independent pixels. |
| js | Integer | Support for JavaScript, where 0 = no, 1 = yes. |
| language | String | Content language using ISO-639-1-alpha-2. Chartboost will omit the field if itβs unknown. |
| carrier | String | Indicates cellular carrier, if available. Chartboost will pass carrier like VERIZON, WIFI if on a WiFi connection, or omit the field is itβs unknown. |
| connectiontype | Integer | Indicates type of type of device connectivity. See List: Connection Types |
| ifa | String | IDFA or GAID. Identifier for Advertising for iOS devices; Google Advertising ID for Android devices. |
| ext | Object | Placeholder for exchange-specific extensions to OpenRTB. |
BidRequest.device.geo π
| Field | Type | Description |
|---|---|---|
| type | Integer | Source of location data. |
| country | String | Country code using ISO-3166-1-alpha-3. |
| region | String | Region code using ISO-3166-2. |
| metro | String | Google metro code; similar to but not exactly Nielsen DMAs. See Appendix A for a link to the codes. |
| city | String | City using United Nations Code for Trade & Transport Locations. |
| zip | String | Zip or postal code. |
| ext | Object | Placeholder for exchange-specific extensions to OpenRTB. |
BidRequest.device.ext π
| Field | Type | Description |
|---|---|---|
| ifv | String | IDFV (iOS), App Set ID (Android). Vendor-scoped device id. |
| atts | Integer | iOS App Tracking Transparency value. Possible values include 0 (notDetermined), 1 (restricted), 2 (denied), 3 (authorized). |
| appsetidscope | Integer | App Set ID Scope. 1 = App scope, 2 = Developer scope. Refer to Google Android documentation for more info. |
BidRequest.user π
| Field | Type | Description |
|---|---|---|
| id | String | Unique ID for the user. For iOS 14+: same value as device.ifa if the IDFA is non-zeroes. If IDFA is not available but IDFV is available, same value as IDFV. If neither IDFA nor IDFV is available, it is a Chartboost-generated unique ID. Recommended to use for frequency capping. |
| geo | Object | Geo object containing country, type, region, city, zip. Note: This information may be based on the device origin rather than IP address. Chartboost does not provide GPS latitudinal & longitudinal data. |
| consent | String | The TCF (Transparency and Consent Framework) string containing user consent choices. This data is only passed when a Consent Management Platform (CMP) is used. |
| ext | Object | Placeholder for exchange-specific extensions to OpenRTB. |
BidRequest.user.geo π
| Field | Type | Description | Β |
|---|---|---|---|
| type | Integer | Source of location data. | Β |
| country | String | Country code using ISO-3166-1-alpha-3. | Β |
| region | String | Region code using ISO-3166-2. | Β |
| metro | String | Google metro code; similar to but not exactly Nielsen DMAs. See Appendix A for a link to the codes. | Β |
| city | String | City using United Nations Code for Trade & Transport Locations. | Β |
| zip | String | Zip or postal code. | Β |
| ext | Object | Placeholder for exchange-specific extensions to OpenRTB. | Β |
BidRequest.user.ext π
| Field | Type | Description |
|---|---|---|
| consent | Integer | Integer values representing user consent to opt-in (1) or opt-out (0) for GDPR. |
| sessionduration | Integer | The total duration of time a user has been using the app after Chartboost SDK is initialized, measured in seconds |
| impdepth | Integer | The number of ads the device has seen for a specific ad placement type (interstitial/rewarded/banner) within the same session. |
BidRequest.source π
| Field | Type | Description |
|---|---|---|
| ext | Object | Placeholder for exchange-specific extensions to OpenRTB. Please refer to Source Ext object. |
BidRequest.source.ext π
| Field | Type | Description |
|---|---|---|
| omidpn | String | Identifier of the OM SDK integration. This is the same as the βnameβ parameter of the OMID Partner object. |
| omidpv | String | Version of the OM SDK integration. This is the same as the βversionStringβ parameter of the OMID Partner object. Note that CB SDK Versions 9.3.1 and above support OM SDK. |
| fd | Integer | Identifier for whether or not traffic is header bidding based, where 1 = header biding, 0 = waterfall. |
| header_bidding | Integer | Identifier for whether or not traffic is header bidding based. If 1, then header bidding based traffic.If 0, then waterfall based traffic. |
BidRequest.regs π
| Field | Type | Description |
|---|---|---|
| coppa | Integer | Flag indicating if this request is subject to the COPPA regulations established by the USA FTC, where 0 = no, 1 = yes. Refer to Section 7.5 in the OpenRTB 2.6 spec for more information. |
| ext | Object | Placeholder for exchange-specific extensions to OpenRTB. |
BidRequest.regs.ext π
| Field | Type | Description |
|---|---|---|
| gdpr | Integer | Flag that indicates whether or not the request is subject to GDPR regulations 0 = No, 1 = Yes, omission indicates Unknown. Refer to Section 7.5 in OpenRTB 2.6 spec for more information. |
| us_privacy | String | Communicates signals regarding consumer privacy under US privacy regulation. See US Privacy String specification. Refer to Section 7.5 in OpenRTB 2.6 spec for more information. |
BidRequest.ext π
| Field | Type | Description |
|---|---|---|
| schain | Object | This object represents both the links in the supply chain as well as an indicator whether or not the supply chain is complete. |
BidRequest.ext.schain π
| Field | Type | Description |
|---|---|---|
| ver | String | Version of the supply chain specification in use. Always 1.0. |
| complete | Integer | Flag indicating whether the chain contains all nodes involved in the transaction leading back to the owner of the app, where 0 = no, 1 = yes. Chartboost only offers complete (1) supply-chain inventory. |
| nodes | Object array | Array of SupplyChainNode objects in the order of the chain. Refer to OpenRTB SupplyChain object documentation for definitions. |
| ext | Object | Placeholder for exchange-specific extensions to OpenRTB. |
BidRequest.ext.schain.nodes π
| Field | Type | Description |
|---|---|---|
| asi | String | The canonical domain name of the SSP, Exchange, Header Wrapper, etc system that bidders connect to. |
| sid | String | The identifier associated with the seller or reseller account within the advertising system. |
| rid | String | The OpenRTB RequestId of the request as issued by this seller. |
| hp | Integer | Indicates whether this node will be involved in the flow of payment for the inventory. This property should always be 1. |
| ext | Object | Placeholder for exchange-specific extensions to OpenRTB. |
Example Requests π
Banner placement (320x50) π
// Banner placement (320x50)
{
"id": "9d554579-f21a-4f6f-a33e-42c41b09b206",
"imp": [
{
"id": "1",
"banner": {
"api": [
3,
5,
7
],
"w": 320,
"h": 50,
"pos": 1,
"topframe": 1,
"battr": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
],
"btype": [
4
],
"ext": {
"placementtype": "banner",
"playableonly": false
}
},
"instl": 0,
"tagid": "Default",
"displaymanager": "Chartboost-iOS-SDK",
"displaymanagerver": "9.4.1",
"bidfloor": 0.1,
"bidfloorcur": "USD",
"secure": 1,
"clickbrowser": 1,
"ext": {
"skadn": {
"versions": [
"2.0",
"2.2",
"3.0",
"4.0"
],
"sourceapp": "1499118002",
"skadnetids": [
"somedspid.skadnetwork"
]
}
}
}
],
"app": {
"id": "4fa7c657f77659a92b000111",
"name": "Buster's Boost",
"bundle": "907175713",
"storeurl": "https://itunes.apple.com/us/app/busters-boost/id907175713",
"cat": [
"IAB9-30",
"IAB3"
],
"publisher": {
"id": "4dd5173cbb93162407001111",
"name": "Chartboost Sample Company"
},
"ver": "1.0",
"ext": {
"package": "com.chartboost.bustersboost"
}
},
"device": {
"carrier": "WIFI",
"connectiontype": 2,
"devicetype": 1,
"geo": {
"city": "San Francisco",
"country": "USA",
"region": "CA",
"type": 2,
"zip": "94105"
},
"h": 2008,
"w": 1536,
"ifa": "EEEE44E2-EC2C-C266-4A64-AD1CADA1D062",
"ip": "50.174.86.6",
"language": "en",
"lmt": 0,
"make": "Apple",
"model": "iPad4,4",
"os": "iOS",
"osv": "14.5.1",
"ua": "Mozilla/5.0 (iPad; CPU OS 10_0_1 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Mobile/14A403",
"ext": {
"ifv": "AAAA44E3-FC2C-D266-4A64-BD1CADA1D095",
"atts": 3
}
},
"user": {
"id": "20470538-b75f-11e6-a614-6158f10b9151",
"geo": {
"country": "USA",
"type": 2,
"region": "CA",
"city": "San Francisco",
"zip": "94105"
},
"consent": "CQGlhQAQGlhQAAFABBPTBLFsAP_gAAAAAB6YCmwAgCDAFNAAAAAA.YAAAAAAAAAAA",
"ext": {
"consent": 1
}
},
"at": 1,
"cur": [
"USD"
],
"regs": {
"coppa": 0,
"ext": {
"gdpr": 0
}
},
"badv": [
"badapps.com",
"worseapps.com"
],
"bapp": [
"com.badapp",
"com.worseapp"
],
"bcat": [
"IAB2-3"
],
"tmax": 400,
"source": {
"ext": {
"omidpn": "Chartboost",
"omidpv": "9.4.1",
"header_bidding": "1"
}
},
"ext": {
"schain": {
"ver": "1.0",
"complete": 1,
"nodes": [
{
"asi": "chartboost.com",
"sid": "4dd5173cbb93162407001111",
"rid": "9d554579-f21a-4f6f-a33e-42c41b09b206",
"hp": 1
}
]
}
}
}
Interstitial placement: Display only (MRAID) π
// Interstitial placement: Display only (MRAID)
{
"id": "9d554579-f21a-4f6f-a33e-42c41b09b206",
"imp": [
{
"id": "1",
"banner": {
"api": [
3,
5,
7
],
"w": 320,
"h": 480,
"pos": 7,
"topframe": 1,
"battr": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
14,
15
],
"btype": [
4
],
"ext": {
"placementtype": "interstitial",
"playableonly": false
}
},
"instl": 1,
"tagid": "Default",
"displaymanager": "Chartboost-iOS-SDK",
"displaymanagerver": "9.4.1",
"bidfloor": 0.5,
"bidfloorcur": "USD",
"secure": 1,
"clickbrowser": 1
}
],
"app": {
"id": "4fa7c657f77659a92b000111",
"name": "Buster's Boost",
"bundle": "907175713",
"storeurl": "https://itunes.apple.com/us/app/busters-boost/id907175713",
"cat": [
"IAB9-30",
"IAB3"
],
"publisher": {
"id": "4dd5173cbb93162407001111",
"name": "Chartboost Sample Company"
},
"ver": "1.0",
"ext": {
"package": "com.chartboost.bustersboost"
}
},
"device": {
"carrier": "WIFI",
"connectiontype": 2,
"devicetype": 1,
"geo": {
"city": "San Francisco",
"country": "USA",
"region": "CA",
"type": 2,
"zip": "94105"
},
"h": 2008,
"w": 1536,
"ifa": "EEEE44E2-EC2C-C266-4A64-AD1CADA1D062",
"ip": "50.174.86.6",
"language": "en",
"lmt": 0,
"make": "Apple",
"model": "iPad4,4",
"os": "iOS",
"osv": "10.0.1",
"ua": "Mozilla/5.0 (iPad; CPU OS 10_0_1 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Mobile/14A403"
},
"user": {
"id": "20470538-b75f-11e6-a614-6158f10b9151",
"geo": {
"country": "USA",
"type": 2,
"region": "CA",
"city": "San Francisco",
"zip": "94105"
},
"consent": "CQGlhQAQGlhQAAFABBPTBLFsAP_gAAAAAB6YCmwAgCDAFNAAAAAA.YAAAAAAAAAAA",
"ext": {
"consent": 1
}
},
"at": 1,
"cur": [
"USD"
],
"regs": {
"coppa": 0,
"ext": {
"gdpr": 0
}
},
"badv": [
"badapps.com",
"worseapps.com"
],
"bcat": [
"IAB2-3"
],
"tmax": 400,
"source": {
"ext": [
{
"omidpn": "Chartboost",
"omidpv": "9.4.1",
"header_bidding": "1"
},
{
"schain": {
"ver": "1.0",
"complete": 1,
"nodes": [
{
"asi": "chartboost.com",
"sid": "4dd5173cbb93162407001111",
"rid": "9d554579-f21a-4f6f-a33e-42c41b09b206",
"hp": 1
}
]
}
}
]
}
}
Interstitial placement: Video only (VAST) π
// Interstitial placement: Video only (VAST)
{
"id": "9d554579-f21a-4f6f-a33e-42c41b09b206",
"imp": [
{
"id": "1",
"video": {
"mimes": [
"video/mp4"
],
"minduration": 6,
"maxduration": 45,
"maxbitrate": 6000,
"playbackmethod": [
1
],
"protocols": [
2,
3,
5,
6,
7,
8,
11,
12,
13,
14
],
"battr": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
],
"w": 320,
"h": 480,
"placement": 5,
"linearity": 1,
"skip": 1,
"delivery": [
1,
2
],
"pos": 7,
"companiontype": [
1,
2
],
"companionad": [
{
"api": [
3,
5,
7
],
"btype": [
4
],
"battr": [
1,
2,
6,
7
],
"pos": 7,
"h": 320,
"w": 480,
"id": "1"
}
],
"ext": {
"placementtype": "interstitial"
}
},
"instl": 1,
"tagid": "Default",
"displaymanager": "Chartboost-iOS-SDK",
"displaymanagerver": "9.4.1",
"bidfloor": 0.5,
"bidfloorcur": "USD",
"secure": 1,
"clickbrowser": 1
}
],
"app": {
"id": "4fa7c657f77659a92b000111",
"name": "Buster's Boost",
"bundle": "907175713",
"storeurl": "https://itunes.apple.com/us/app/busters-boost/id907175713",
"cat": [
"IAB9-30",
"IAB3"
],
"publisher": {
"id": "4dd5173cbb93162407001111",
"name": "Chartboost Sample Company"
},
"ver": "1.0",
"ext": {
"package": "com.chartboost.bustersboost"
}
},
"device": {
"connectiontype": 2,
"devicetype": 1,
"geo": {
"city": "San Francisco",
"country": "USA",
"ipservice": 2,
"region": "CA",
"type": 2,
"zip": "94105"
},
"h": 2008,
"w": 1536,
"ifa": "EEEE44E2-EC2C-C266-4A64-AD1CADA1D062",
"ip": "50.174.86.6",
"language": "en",
"lmt": 0,
"make": "Apple",
"model": "iPad4,4",
"os": "iOS",
"osv": "10.0.1",
"ua": "Mozilla/5.0 (iPad; CPU OS 10_0_1 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Mobile/14A403"
},
"user": {
"id": "20470538-b75f-11e6-a614-6158f10b9151",
"geo": {
"country": "USA",
"type": 2,
"ipservice": 2,
"region": "CA",
"city": "San Francisco",
"zip": "94105"
},
"consent": "CQGlhQAQGlhQAAFABBPTBLFsAP_gAAAAAB6YCmwAgCDAFNAAAAAA.YAAAAAAAAAAA",
"ext": {
"consent": 1
}
},
"at": 1,
"cur": [
"USD"
],
"regs": {
"coppa": 0,
"ext": {
"gdpr": 0
}
},
"badv": [
"badapps.com",
"worseapps.com"
],
"bcat": [
"IAB2-3"
],
"tmax": 400,
"source": {
"schain": {
"ver": "1.0",
"complete": 1,
"nodes": [
{
"asi": "chartboost.com",
"sid": "4dd5173cbb93162407001111",
"rid": "9d554579-f21a-4f6f-a33e-42c41b09b206",
"hp": 1
}
]
},
"ext": {
"omidpn": "Chartboost",
"omidpv": "9.4.1",
"header_bidding": "1"
}
}
}
Interstitial placement: Video (VAST) OR Display (MRAID) π
// Interstitial placement: Video (VAST) OR Display (MRAID)
{
"id": "9d554579-f21a-4f6f-a33e-42c41b09b206",
"imp": [
{
"id": "1",
"video": {
"mimes": [
"video/mp4"
],
"minduration": 6,
"maxduration": 45,
"maxbitrate": 6000,
"playbackmethod": [
1
],
"protocols": [
2,
3,
5,
6,
7,
8,
11,
12,
13,
14
],
"battr": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
14,
15
],
"w": 320,
"h": 480,
"placement": 5,
"linearity": 1,
"skip": 1,
"delivery": [
1,
2
],
"pos": 7,
"companiontype": [
1,
2
],
"companionad": [
{
"api": [
3,
5,
7
],
"btype": [
4
],
"battr": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
14,
15
],
"pos": 7,
"h": 320,
"w": 480,
"id": "1"
}
],
"ext": {
"placementtype": "interstitial"
}
},
"banner": {
"api": [
3,
5,
7
],
"w": 320,
"h": 480,
"pos": 7,
"topframe": 1,
"battr": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
14,
15
],
"btype": [
4
],
"ext": {
"placementtype": "interstitial",
"playableonly": false
}
},
"instl": 1,
"tagid": "Default",
"displaymanager": "Chartboost-iOS-SDK",
"displaymanagerver": "9.4.1",
"bidfloor": 0.5,
"bidfloorcur": "USD",
"secure": 1,
"clickbrowser": 1
}
],
"app": {
"id": "4fa7c657f77659a92b000111",
"name": "Buster's Boost",
"bundle": "907175713",
"storeurl": "https://itunes.apple.com/us/app/busters-boost/id907175713",
"cat": [
"IAB9-30",
"IAB3"
],
"publisher": {
"id": "4dd5173cbb93162407001111",
"name": "Chartboost Sample Company"
},
"ver": "1.0",
"ext": {
"package": "com.chartboost.bustersboost"
}
},
"device": {
"carrier": "WIFI",
"connectiontype": 2,
"devicetype": 1,
"geo": {
"city": "San Francisco",
"country": "USA",
"region": "CA",
"type": 2,
"zip": "94105"
},
"h": 2008,
"w": 1536,
"ifa": "EEEE44E2-EC2C-C266-4A64-AD1CADA1D062",
"ip": "50.174.86.6",
"language": "en",
"lmt": 0,
"make": "Apple",
"model": "iPad4,4",
"os": "iOS",
"osv": "10.0.1",
"ua": "Mozilla/5.0 (iPad; CPU OS 10_0_1 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Mobile/14A403"
},
"user": {
"id": "20470538-b75f-11e6-a614-6158f10b9151",
"geo": {
"country": "USA",
"type": 2,
"region": "CA",
"city": "San Francisco",
"zip": "94105"
},
"consent": "CQGlhQAQGlhQAAFABBPTBLFsAP_gAAAAAB6YCmwAgCDAFNAAAAAA.YAAAAAAAAAAA",
"ext": {
"consent": 1
}
},
"at": 1,
"cur": [
"USD"
],
"regs": {
"coppa": 0,
"ext": {
"gdpr": 0
}
},
"badv": [
"badapps.com",
"worseapps.com"
],
"bcat": [
"IAB2-3"
],
"tmax": 400,
"source": {
"ext": [
{
"omidpn": "Chartboost",
"omidpv": "9.4.1",
"header_bidding": "1"
},
{
"schain": {
"ver": "1.0",
"complete": 1,
"nodes": [
{
"asi": "chartboost.com",
"sid": "4dd5173cbb93162407001111",
"rid": "9d554579-f21a-4f6f-a33e-42c41b09b206",
"hp": 1
}
]
}
}
]
}
}
Rewarded placement: Video only (VAST) π
// Rewarded placement: Video only (VAST)
{
"id": "9d554579-f21a-4f6f-a33e-42c41b09b206",
"imp": [
{
"id": "1",
"video": {
"mimes": [
"video/mp4"
],
"minduration": 6,
"maxduration": 45,
"maxbitrate": 6000,
"playbackmethod": [
1
],
"protocols": [
2,
3,
5,
6,
7,
8,
11,
12,
13,
14
],
"battr": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
],
"w": 320,
"h": 480,
"placement": 5,
"linearity": 1,
"skip": 0,
"delivery": [
1,
2
],
"pos": 7,
"companiontype": [
1,
2
],
"companionad": [
{
"api": [
3,
5,
7
],
"btype": [
4
],
"battr": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
14,
15
],
"pos": 7,
"h": 320,
"w": 480,
"id": "1"
}
],
"ext": {
"placementtype": "rewarded"
}
},
"instl": 1,
"tagid": "Default",
"displaymanager": "Chartboost-iOS-SDK",
"displaymanagerver": "9.4.1",
"bidfloor": 0.1,
"bidfloorcur": "USD",
"secure": 1,
"clickbrowser": 1
}
],
"app": {
"id": "4fa7c657f77659a92b000111",
"name": "Buster's Boost",
"bundle": "907175713",
"storeurl": "https://itunes.apple.com/us/app/busters-boost/id907175713",
"cat": [
"IAB9-30",
"IAB3"
],
"publisher": {
"id": "4dd5173cbb93162407001111",
"name": "Chartboost Sample Company"
},
"ver": "1.0",
"ext": {
"package": "com.chartboost.bustersboost"
}
},
"device": {
"carrier": "WIFI",
"connectiontype": 2,
"devicetype": 1,
"geo": {
"city": "San Francisco",
"country": "USA",
"region": "CA",
"type": 2,
"zip": "94105"
},
"h": 2008,
"w": 1536,
"ifa": "EEEE44E2-EC2C-C266-4A64-AD1CADA1D062",
"ip": "50.174.86.6",
"language": "en",
"lmt": 0,
"make": "Apple",
"model": "iPad4,4",
"os": "iOS",
"osv": "10.0.1",
"ua": "Mozilla/5.0 (iPad; CPU OS 10_0_1 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Mobile/14A403"
},
"user": {
"id": "20470538-b75f-11e6-a614-6158f10b9151",
"geo": {
"country": "USA",
"type": 2,
"region": "CA",
"city": "San Francisco",
"zip": "94105"
},
"consent": "CQGlhQAQGlhQAAFABBPTBLFsAP_gAAAAAB6YCmwAgCDAFNAAAAAA.YAAAAAAAAAAA",
"ext": {
"consent": 1
}
},
"at": 1,
"cur": [
"USD"
],
"regs": {
"coppa": 0,
"ext": {
"gdpr": 0
}
},
"badv": [
"badapps.com",
"worseapps.com"
],
"bcat": [
"IAB2-3"
],
"tmax": 400,
"source": {
"ext": [
{
"omidpn": "Chartboost",
"omidpv": "9.4.1",
"header_bidding": "1"
},
{
"schain": {
"ver": "1.0",
"complete": 1,
"nodes": [
{
"asi": "chartboost.com",
"sid": "4dd5173cbb93162407001111",
"rid": "9d554579-f21a-4f6f-a33e-42c41b09b206",
"hp": 1
}
]
}
}
]
}
}
Rewarded placement: Video (VAST) OR Display User-interactive (MRAID playable only) π
// Rewarded placement: Video (VAST) OR Display User-interactive (MRAID playable only)
{
"id": "9d554579-f21a-4f6f-a33e-42c41b09b206",
"imp": [
{
"id": "1",
"banner": {
"api": [
3,
5,
7
],
"w": 320,
"h": 480,
"pos": 7,
"topframe": 1,
"battr": [
1,
2,
6,
7
],
"btype": [
4
],
"ext": {
"placementtype": "rewarded",
"playableonly": true
}
},
"video": {
"mimes": [
"video/mp4"
],
"minduration": 6,
"maxduration": 45,
"maxbitrate": 6000,
"playbackmethod": [
1
],
"protocols": [
2,
3,
5,
6,
7,
8,
11,
12,
13,
14
],
"battr": [
3,
4,
5,
8,
9,
11,
12,
14
],
"w": 320,
"h": 480,
"placement": 5,
"linearity": 1,
"skip": 0,
"delivery": [
1,
2
],
"pos": 7,
"companiontype": [
1,
2
],
"companionad": [
{
"api": [
3,
5,
7
],
"btype": [
4
],
"battr": [
1,
2,
6,
7
],
"pos": 7,
"h": 320,
"w": 480,
"id": "1"
}
],
"ext": {
"placementtype": "rewarded"
}
},
"instl": 1,
"tagid": "Default",
"displaymanager": "Chartboost-iOS-SDK",
"displaymanagerver": "9.4.1",
"bidfloor": 0.5,
"bidfloorcur": "USD",
"secure": 1,
"clickbrowser": 1
}
],
"app": {
"id": "4fa7c657f77659a92b000111",
"name": "Buster's Boost",
"bundle": "907175713",
"storeurl": "https://itunes.apple.com/us/app/busters-boost/id907175713",
"cat": [
"IAB9-30",
"IAB3"
],
"publisher": {
"id": "4dd5173cbb93162407001111",
"name": "Chartboost Sample Company"
},
"ver": "1.0",
"ext": {
"package": "com.chartboost.bustersboost"
}
},
"device": {
"carrier": "WIFI",
"connectiontype": 2,
"devicetype": 1,
"geo": {
"city": "San Francisco",
"country": "USA",
"region": "CA",
"type": 2,
"zip": "94105"
},
"h": 2008,
"w": 1536,
"ifa": "EEEE44E2-EC2C-C266-4A64-AD1CADA1D062",
"ip": "50.174.86.6",
"language": "en",
"lmt": 0,
"make": "Apple",
"model": "iPad4,4",
"os": "iOS",
"osv": "10.0.1",
"ua": "Mozilla/5.0 (iPad; CPU OS 10_0_1 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Mobile/14A403"
},
"user": {
"id": "20470538-b75f-11e6-a614-6158f10b9151",
"geo": {
"country": "USA",
"type": 2,
"region": "CA",
"city": "San Francisco",
"zip": "94105"
},
"consent": "CQGlhQAQGlhQAAFABBPTBLFsAP_gAAAAAB6YCmwAgCDAFNAAAAAA.YAAAAAAAAAAA",
"ext": {
"consent": 1
}
},
"at": 1,
"cur": [
"USD"
],
"regs": {
"coppa": 0,
"ext": {
"gdpr": 0
}
},
"badv": [
"badapps.com",
"worseapps.com"
],
"bcat": [
"IAB2-3"
],
"tmax": 400,
"source": {
"ext": [
{
"omidpn": "Chartboost",
"omidpv": "9.4.1",
"header_bidding": "1"
},
{
"schain": {
"ver": "1.0",
"complete": 1,
"nodes": [
{
"asi": "chartboost.com",
"sid": "4dd5173cbb93162407001111",
"rid": "9d554579-f21a-4f6f-a33e-42c41b09b206",
"hp": 1
}
]
}
}
]
}
}
Interstitial placement: Video only (VAST) with PMP π
//Interstitial placement: Video only (VAST) with PMP
{
"id": "9d554579-f21a-4f6f-a33e-42c41b09b206",
"imp": [
{
"id": "1",
"video": {
"mimes": [
"video/mp4"
],
"minduration": 6,
"maxduration": 45,
"maxbitrate": 6000,
"playbackmethod": [
1
],
"protocols": [
2,
3,
5,
6,
7,
8,
11,
12,
13,
14
],
"battr": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
],
"w": 320,
"h": 480,
"placement": 5,
"linearity": 1,
"skip": 1,
"delivery": [
1,
2
],
"pos": 7,
"companiontype": [
1,
2
],
"companionad": [
{
"api": [
3,
5,
7
],
"btype": [
4
],
"battr": [
1,
2,
6,
7
],
"pos": 7,
"h": 320,
"w": 480,
"id": "1"
}
],
"ext": {
"placementtype": "interstitial"
}
},
"instl": 1,
"tagid": "Default",
"displaymanager": "Chartboost-iOS-SDK",
"displaymanagerver": "9.4.1",
"bidfloor": 0.5,
"bidfloorcur": "USD",
"secure": 1,
"clickbrowser": 1
}
],
"pmp": {
"deals": [
{
"at": 1,
"bidfloor": 1,
"id": "7705b360efcef23d0cde7777"
}
],
"private_auction": 0
},
"app": {
"id": "4fa7c657f77659a92b000111",
"name": "Buster's Boost",
"bundle": "907175713",
"storeurl": "https://itunes.apple.com/us/app/busters-boost/id907175713",
"cat": [
"IAB9-30",
"IAB3"
],
"publisher": {
"id": "4dd5173cbb93162407001111",
"name": "Chartboost Sample Company"
},
"ver": "1.0",
"ext": {
"package": "com.chartboost.bustersboost"
}
},
"device": {
"connectiontype": 2,
"devicetype": 1,
"geo": {
"city": "San Francisco",
"country": "USA",
"region": "CA",
"type": 2,
"zip": "94105"
},
"h": 2008,
"w": 1536,
"ifa": "EEEE44E2-EC2C-C266-4A64-AD1CADA1D062",
"ip": "50.174.86.6",
"language": "en",
"lmt": 0,
"make": "Apple",
"model": "iPad4,4",
"os": "iOS",
"osv": "10.0.1",
"ua": "Mozilla/5.0 (iPad; CPU OS 10_0_1 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Mobile/14A403"
},
"user": {
"id": "20470538-b75f-11e6-a614-6158f10b9151",
"geo": {
"country": "USA",
"type": 2,
"region": "CA",
"city": "San Francisco",
"zip": "94105"
},
"consent": "CQGlhQAQGlhQAAFABBPTBLFsAP_gAAAAAB6YCmwAgCDAFNAAAAAA.YAAAAAAAAAAA",
"ext": {
"consent": 1
}
},
"at": 1,
"cur": [
"USD"
],
"regs": {
"coppa": 0,
"ext": {
"gdpr": 0
}
},
"badv": [
"badapps.com",
"worseapps.com"
],
"bcat": [
"IAB2-3"
],
"tmax": 400,
"source": {
"ext": [
{
"omidpn": "Chartboost",
"omidpv": "9.4.1",
"header_bidding": "1"
},
{
"schain": {
"ver": "1.0",
"complete": 1,
"nodes": [
{
"asi": "chartboost.com",
"sid": "4dd5173cbb93162407001111",
"rid": "9d554579-f21a-4f6f-a33e-42c41b09b206",
"hp": 1
}
]
}
}
]
}
}