ℹ️Integration Document RTB

Specification for Integration with SSP’s/DSP’s

Overview

DTXplatform is a modern real-time bidding system that allows buyers to make purchases automatically when searching for advertising resources.

Its interface is implemented as per the IAB’s OpenRTB Specification Version 2.5 and uses JSON as its message format [Content-Type: application/json; charset=UTF-8].

Open RTB Version HTTP Header

We support Open RTB 2.5 by default, but we can also support 2.4, 2.3, 2.0, and 1.0 versions for specific integrations.

Default header is [x-openrtb-version: 2.5].

Transport

By default, all calls should return HTTP code 200 with body containing bid response in JSON format. For “no bid” response, the call should return HTTP code 204 with empty body.

We can also support other options for specific integrations, like HTTP code 200 with empty body, or with body containing “nobid” message.

Data format

By default, JSON (JavaScript Object Notation) supported for bid request and bid response data payloads. We can support other data format for specific integrations. Default header: Content-Type: application/JSON header.

Accordance with IAB Specifications and Guidelines

We work in accordance with IAB Specifications available here:

https://www.iab.com/wp-content/uploads/2016/01/OpenRTB-API-Specification-Version-2-4-DRA FT.pdf https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf

Bid Request

DTXplatform sends a Bid Request when an image becomes visible within the browser. The following table describes the fields and objects in the BidRequest message.

Attribute

Type

Description

id

string; required

Unique ID of the bid request, provided by the exchange.

imp

object array;

required

Array with 1 Imp object.

site

object; required

Details via a Site object about the publisher’s website. Only applicable and required for websites.

app

object; required

Details via an App object about the publisher’s app (i.e., non-browser applications). Only applicable and required for apps.

device

object; required

Details via a Device object about the user’s device to which the impression will be delivered.

user

object; recommended

Details via a User object about the human user of the device; the advertising audience.

test

integer; default 0

Indicator of test mode in which auctions are not billable,

where 0 = live mode, 1 = test mode.

at

integer; default 2

Auction type, where 1 = First Price, 2 = Second Price Plus.

Exchange-specific auction types can be defined using values greater than 500.

tmax

integer

Maximum time in milliseconds to submit a bid to avoid timeout. This value is commonly communicated offline.

wseat

string array

Whitelist of buyer seats (e.g., advertisers, agencies) allowed to bid on this impression. IDs of seats and knowledge of the buyer’s customers to which they refer must be coordinated between bidders and the exchange a priori.

Omission implies no seat restrictions.

allimps

integer; default 0

Flag to indicate if Exchange can verify that the impressions offered represent all of the impressions available in context (e.g., all on the web page, all video spots such as pre/mid/post roll) to support road-blocking. 0 = no or unknown, 1 =

yes, the impressions offered represent all that are available.

cur

string array

Array of allowed currencies for bids on this bid request using ISO-4217 alpha codes. Recommended only if the exchange accepts multiple currencies.

bcat

string array

Blocked advertiser categories using the IAB content categories.

badv

string array

Block list of advertisers by their domains (e.g., “http://ford.com ”).

bapp

string array

Block list of applications by their platform-specific exchange independent application identifiers. On Android, these should be bundle or package names (e.g., com.foo.mygame). On iOS, these are numeric IDs.

regs

object

A Regs object that specifies any industry, legal, or governmental regulations in force for this request.

ext

object

Placeholder for exchange-specific extensions to OpenRTB

Impression

Attribute

Type

Description

id

string

A unique identifier for this impression within the context of the bid request (typically, starts with 1 and increments.

banner

object

A Banner object; required if this impression is offered as a banner ad opportunity.

video

object

A Video object; required if this impression is offered as a video ad opportunity.

native

object

A Native object; required if this impression is offered as a native ad opportunity.

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.

Recommended for video and/or apps.

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.

Recommended for video and/or apps.

instl

integer; default 0

1 = the ad is interstitial or full screen, 0 = not interstitial

tagid

string

Identifier for specific ad placement or ad tag that was used to initiate the auction. This can be useful for debugging of any issues, or for optimization by the buyer.

bidfloor

float; default 0

Minimum bid for this impression expressed in CPM.

bidfloorcur

string;

default “USD”

Currency specified using ISO-4217 alpha codes. This may be different from bid currency returned by bidder if this is allowed by the exchange.

clickbrowser

integer

Indicates the type of browser opened upon clicking the creative in an app, where 0 = embedded, 1 = native.

Note that the Safari View Controller in iOS 9.x devices is considered a native browser for purposes of this attribute.

secure

integer

Flag to indicate if the impression requires secure HTTPS URL creative assets and markup, where 0 = non-secure, 1 = secure.

If omitted, the secure state is unknown, but non-secure HTTP support can be assumed.

iframebuster

string array

Array of exchange-specific names of supported iframe busters.

ext

object

Placeholder for exchange-specific extensions to OpenRTB

Banner

Attribute

Type

Description

w

integer; required

Width in device independent pixels (DIPS).

If no format objects are specified, this is an exact width requirement. Otherwise it is a preferred width.

h

integer; required

Height in device independent pixels (DIPS).

If no format objects are specified, this is an exact height requirement. Otherwise it is a preferred height.

format

object array

Array of format objects representing the banner sizes permitted. If none are specified, then use of the h and w attributes is highly recommended.

wmax

integer; DEPRECATED

NOTE: Deprecated in favor of the format array.

Maximum width in device independent pixels (DIPS).

hmax

integer; DEPRECATED

NOTE: Deprecated in favor of the format array.

Maximum height in device independent pixels (DIPS).

wmin

integer; DEPRECATED

NOTE: Deprecated in favor of the format array.

Minimum width in device independent pixels (DIPS).

hmin

integer; DEPRECATED

NOTE: Deprecated in favor of the format array.

Minimum height in device independent pixels (DIPS).

id

string

Unique identifier for this banner object. Recommended when Banner objects are used with a Video object to represent an array of companion ads. Values usually start at 1 and increase with each object; should be unique within an impression.

btype

integer array

Blocked banner ad types.

battr

integer array

Blocked creative attributes.

pos

integer

Ad position on screen.

mimes

string array

Content MIME types supported. Popular MIME types may include

“application/x-shockwave-flash”, “image/jpg”, and “image/gif”.

topframe

integer

Indicates if the banner is in the top frame as opposed to an iframe, where 0 = no, 1

= yes.

expdir

integer array

Directions in which the banner may expand.

api

integer array

List of supported API frameworks for this impression. If an API is not explicitly listed, it is assumed not to be supported.

ext

object

Placeholder for exchange-specific extensions to OpenRTB

Video

Attribute

Type

Description

mimes

string array; required

Content MIME types supported. Popular MIME types may include

“video/x-ms-wmv” for Windows Media and “video/x-flv” for Flash Video.

minduration

integer; recommended

Minimum video ad duration in seconds.

maxduration

integer; recommended

Maximum video ad duration in seconds.

protocols

integer array; recommended

Array of supported video protocols. At least one supported protocol must be specified in either the protocol or protocols attribute.

protocol

integer; DEPRECATED

NOTE: Deprecated in favor of protocols. Supported video protocol. At least one supported protocol must be specified in either the protocol or protocols attribute.

w

integer; recommended

Width of the video player in device independent pixels (DIPS).

h

integer; recommended

Height of the video player in device independent pixels (DIPS).

startdelay

integer; recommended

Indicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placements.

linearity

integer

Indicates if the impression must be linear, nonlinear, etc. If none specified, assume all are allowed.

skip

integer

Indicates if the player will allow the video to be skipped, where 0 = no, 1 = yes.

If a bidder sends markup/creative that is itself skippable, the Bid object should include the attr array with an element of 16 indicating skippable video.

skipmin

integer; default 0

Videos of total duration greater than this number of seconds can be skippable; only applicable if the ad is skippable.

skipafter

integer; default 0

Number of seconds a video must play before skipping is enabled; only applicable if the ad is skippable.

sequence

integer

If multiple ad impressions are offered in the same bid request the sequence number will allow for the coordinated delivery of multiple creatives.

battr

integer array

Blocked creative attributes.

maxextended

integer

Maximum extended ad duration if extension is allowed. If blank or 0, extension is not allowed. If -1, extension is allowed, and there is no time limit imposed. If greater than 0, then the value represents the number of seconds of extended play supported beyond the maxduration value.

minbitrate

integer

Minimum bit rate in Kbps.

maxbitrate

integer

Maximum bit rate in Kbps.

boxingallowed

integer; default 1

Indicates if letter-boxing of 4:3 content into a 16:9 window is allowed, where 0 = no, 1 = yes.

playbackmethod

integer array

Playback methods that may be in use. If none are specified, any method may be used. Only one method is typically used in practice. As a result, this array may be converted to an integer in a future version of the specification.

delivery

integer array

Supported delivery methods (e.g., streaming, progressive). If none specified, assume all are supported.

pos

integer

Ad position on screen.

companionad

object array

Array of Banner objects if companion ads are available.

api

integer array

List of supported API frameworks for this impression. If an API is not explicitly listed, it is assumed not to be supported.

companiontype

integer array

Supported VAST companion ad types. Recommended if companion Banner objects are included via the companionad array.

ext

object

Placeholder for exchange-specific extensions to OpenRTB

Native

Attribute

Type

Description

request

string; required

Request payload complying with the Native Ad Specification.

ver

string; recommended

Version of the Dynamic Native Ads API to which request complies; highly recommended for efficient parsing.

api

integer array

List of supported API frameworks for this impression. Refer to List 5.6. If an API is not explicitly listed, it is assumed not to be supported.

battr

integer array

Blocked creative attributes.

ext

object

Placeholder for exchange-specific extensions to OpenRTB

Audio

Attribute

Type

Description

mimes

string array; required

Content MIME types supported. Popular MIME types may include

“video/x-ms-wmv” for Windows Media and “video/x-flv” for Flash Video.

minduration

integer; recommended

Minimum audio ad duration in seconds.

maxduration

integer; recommended

Maximum audio ad duration in seconds.

protocols

integer; DEPRECATED

Array of supported video protocols. At least one supported protocol must be specified in either the protocol or protocols attribute.

startdelay

integer; recommended

Indicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placements.

minbitrate

integer

Minimum bit rate in Kbps.

maxbitrate

integer

Maximum bit rate in Kbps.

api

integer array

List of supported API frameworks for this impression. If an API is not explicitly listed, it is assumed not to be supported.

Site

Attribute

Type

Description

id

string; recommended

Exchange-specific site ID.

name

string

Site name (may be aliased at the publisher’s request).

domain

string; required

Domain of the site (e.g., “http://mysite.foo.com ”).

cat

string array

Array of IAB content categories of the site.

sectioncat

string array

Array of IAB content categories that describe the current section of the site.

pagecat

string array

Array of IAB content categories that describe the current page or view of the site.

page

string

URL of the page where the impression will be shown.

ref

string

Referrer URL that caused navigation to the current page.

search

string

Search string that caused navigation to the current page.

mobile

integer

Indicates if the site has been programmed to optimize layout when viewed on mobile devices, where 0 = no, 1 = yes.

privacypolicy

integer

Indicates if the site has a privacy policy, where 0 = no, 1 = yes.

publisher

object

Details about the Publisher of the site.

content

object

Details about the Content within the site.

keywords

string

Comma separated list of keywords about the site.

ext

object

Placeholder for exchange-specific extensions to OpenRTB

Device

Attribute

Type

Description

ua

string; required

Browser user agent string.

geo

object; recommended

Location of the device assumed to be the user’s current location defined by a Geo object.

dnt

integer; recommended

Standard “Do Not Track” flag as set in the header by the browser, where 0 = tracking is unrestricted, 1 = do not track.

lmt

integer; recommended

“Limit Ad Tracking” signal commercially endorsed (e.g., iOS, Android), where 0 = tracking is unrestricted, 1 = tracking must be limited per commercial guidelines.

ip

string; required

IPv4 address closest to device.

ipv6

string

IP address closest to device as IPv6.

devicetype

integer

The general type of device.

make

string

Device make (e.g., “Apple”).

model

string

Device model (e.g., “iPhone”).

os

string

Device operating system (e.g., “iOS”).

osv

string

Device operating system version (e.g., “3.1.2”).

hwv

string

Hardware version of the device (e.g., “5S” for iPhone 5S).

h

integer

Physical height of the screen in pixels.

w

integer

Physical width of the screen in pixels.

ppi

integer

Screen size as pixels per linear inch.

pxratio

float

The ratio of physical pixels to device independent pixels.

js

integer

Support for JavaScript, where 0 = no, 1 = yes.

geofetch

integer

Indicates if the geolocation API will be available to JavaScript code running in the banner, where 0 = no, 1 = yes.

flashver

string

Version of Flash supported by the browser.

language

string

Browser language using ISO-639-1-alpha-2.

carrier

string

Carrier or ISP (e.g., “VERIZON”). “WIFI”

is often used in mobile to indicate high bandwidth (e.g., video friendly vs. cellular).

connectiontype

integer

Network connection type.

ifa

string; recommended

ID sanctioned for advertiser use in the clear (i.e., not hashed); required for apps.

ext

object

Placeholder for exchange-specific extensions to OpenRTB

Geo

Attribute

Type

Description

lat

float

Latitude from -90.0 to +90.0, where negative is south.

lon

float

Longitude from -180.0 to +180.0, where negative is west.

type

integer

Source of location data; recommended when passing lat/lon.

accuracy

integer

Estimated location accuracy in meters; recommended when lat/lon are specified and derived from a device’s location services (i.e., type = 1). Note that this is the accuracy as reported from the device. Consult OS specific documentation (e.g., Android, iOS) for exact interpretation.

country

string

Country code using ISO-3166-1-alpha-3.

region

string

Region code using ISO-3166-2; 2-letter state code if USA.

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

User

Attribute

Type

Description

id

string; recommended

Exchange-specific ID for the user. At least one of id or buyeruid is

recommended.

buyeruid

string; recommended

Buyer-specific ID for the user as mapped by the exchange for the buyer. At least one of buyeruid or id is recommended.

yob

integer

Year of birth as a 4-digit integer.

gender

string

Gender, where “M” = male, “F” = female, “O” = known to be other (i.e., omitted is unknown).

keywords

string

Comma separated list of keywords, interests, or intent.

customdata

string

Optional feature to pass bidder data that was set in the exchange’s cookie. The string must be in base85 cookie safe characters and be in any format. Proper JSON encoding must be used to include “escaped” quotation marks.

geo

object

Location of the user’s home base defined by a Geo object. This is not necessarily their current location.

data

object array

Additional user data. Each Data object represents a different data source.

ext

object

Placeholder for exchange-specific extensions to OpenRTB

App

Attribute

Type

Description

id

string; recommended

Exchange-specific app ID.

name

string

App name (may be aliased at the publisher’s request).

bundle

string; required

A platform-specific application identifier intended to be unique to the app and independent of the exchange. On Android, this should be a bundle or package name (e.g., com.foo.mygame). On iOS, it is a numeric ID.

domain

string

Domain of the app (e.g., “http://mygame.foo.com ”).

storeurl

string

App store URL for an installed app; for IQG 2.1 compliance.

cat

string array; recommended

Array of IAB content categories of the app.

sectioncat

string array

Array of IAB content categories that describe the current section of the app.

pagecat

string array

Array of IAB content categories that describe the current page or view of the app.

ver

string

Application version.

privacypolicy

integer

Indicates if the app has a privacy policy, where 0 = no, 1 = yes.

paid

integer

0 = app is free, 1 = the app is a paid version.

publisher

object

Details about the Publisher of the app.

content

object

Details about the Content within the app.

keywords

string

Comma separated list of keywords about the app.

ext

object

Placeholder for exchange-specific extensions to OpenRTB

Bid Response

DTXplatform expects to receive a Bid Response for each BidRequest. The following table describes the fields and objects in the BidResponse message. All calls should return HTTP code 200 except for an empty bid response (no bids) which should return HTTP code 204.

Attribute

Type

Description

id

string; required

ID of the bid request to which this is a response.

seatbid

object array

Array of seatbid objects; 1+ required if a bid is to be made.

bidid

string

Bidder generated response ID to assist with logging/tracking.

cur

string;

default “USD”

Bid currency using ISO-4217 alpha codes.

customdata

string

Optional feature to allow a bidder to set data in the exchange’s cookie. The string must be in base85 cookie safe characters and be in any format. Proper JSON encoding must be used to include “escaped” quotation marks.

nbr

integer

Reason for not bidding.

ext

object

Placeholder for bidder-specific extensions to OpenRTB

Note: we recommend using field “cur”, even if you set USD as default currency, except cases when it is specified in the agreement.

Seat Bid

Attribute

Type

Description

bid

object array;

required

Array with 1 Bid object.

seat

string

ID of the buyer seat (e.g., advertiser, agency) on whose behalf this bid is made.

group

integer; default 0

0 = impressions can be won individually; 1 = impressions must be won or lost as a group.

ext

object

Placeholder for bidder-specific extensions to OpenRTB.

Bid

Attribute

Type

Description

id

string; required

Bidder generated bid ID to assist with logging/tracking.

impid

string; required

ID of the Imp object in the related bid request.

price

float; required

Bid price expressed as CPM although the actual transaction is for a unit impression only. Note that while the type indicates float, integer math is highly recommended when handling currencies (e.g., BigDecimal in Java).

adid

string

ID of a preloaded ad to be served if the bid wins.

nurl

string

Win notice URL called by the exchange if the bid wins (not necessarily indicative of a delivered, viewed, or billable ad); optional means of serving ad markup.

adm

string

Optional means of conveying ad markup in case the bid wins;

supersedes the win notice if markup is included in both.

adomain

string array

Advertiser domain for block list checking (e.g., “http://ford.com ”).

This can be an array of for the case of rotating creatives.

Exchanges can mandate that only one domain is allowed.

bundle

string

A platform-specific application identifier intended to be unique to the app and independent of the exchange. On Android, this should be a bundle or package name (e.g., com.foo.mygame). On iOS, it is a numeric ID.

cid

string

Campaign ID to assist with ad quality checking; the collection of creatives for which iurl should be representative.

crid

string

Creative ID to assist with ad quality checking.

cat

string array

IAB content categories of the creative.

attr

integer array

Set of attributes describing the creative.

api

integer

API required by the markup if applicable.

protocol

integer

Video response protocol of the markup if applicable.

w

integer

Width of the creative in device independent pixels (DIPS).

h

integer

Height of the creative in device independent pixels (DIPS).

ext

object

Placeholder for bidder-specific extensions to OpenRTB

Substitution Macros

Any of the following substitution macros can be included in the Win Notice URL or Ad Markup. If present, they will each be replaced by the appropriate data.

If the suffix: B64 is appended to the macro name, the data will be Base64-encoded prior to the substitution.

For example, ${AUCTION_AD_ID:B64}.

Macro

Description

${AUCTION_ID}

ID of the bid request; from “id” attribute.

${AUCTION_BID_ID}

ID of the bid; from “bidid” attribute.

${AUCTION_IMP_ID}

ID of the impression just won; from “impid” attribute.

${AUCTION_SEAT_ID}

ID of the bidder’s seat for whom the bid was made.

${AUCTION_AD_ID}

ID of the ad markup the bidder wishes to serve; from “adid” attribute.

${AUCTION_PRICE}

Settlement price using the same currency and units as the bid.

${AUCTION_CURRENCY}

The currency used in the bid (explicit or implied); for confirmation only.

{

"id":"6d5a5f43e41f8c3291e55610a2",

"tmax":270,

"cur":[

"USD"

],

"imp":[

{

"id":"21342",

"instl":0,

"secure":0, "bidfloor":0.822, "banner":{

"w":300,

"h":250,

"btype":[ 4

],

"battr":[ 8,

10

]

}

}

],

"device":{

"dnt":0, "devicetype":4, "geo":{

"country":"USA", "type":2,

"lat":37.0154,

"lon":-88.5805,

"city":"Paducah", "accuracy":10

},

"connectiontype":2, "language":"en",

"model":"Z899VL",

"make":"ZTE", "carrier":"Comcast Business",

"dpidsha1":"11423CE1D87419405EBA4032D12820A6C1832014",


"dpidmd5":"A773B99F95ED68CA6BAA54C12C545491",

"ifa":"087bd6ba-63c4-4cbd-bbae-6dddc4712525", "os":"android",

"osv":"7.1.1", "js":1,

"ua":"Mozilla/5.0 (Linux; Android 7.1.1; Z899VL Build/NMF26V; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/67.0.3396.87 Mobile Safari/537.36",

"ip":"74.93.62.129"

}, "at":2,

"bcat":[

"IAB24",

"IAB25", "IAB26"

],

"user":{

},

"regs":{

"ext":{

"gdpr":0

}

},

"app":{

"id":"e6348673bbdb", "name":"DTX Test App", "bundle":"test.DTX", "cat":[

"IAB19-18",

"IAB19-30", "IAB19"

],

"pagecat":[

"IAB19-18",

"IAB19-30", "IAB19"

],

"publisher":{

"id":"72835"

}

}

}

Native Bid Request Example

{

"id":"1f6ee57f713696acda0dff10a3", "tmax":380,

"cur":[

"USD"

],

"imp":[

{

"id":"17502",

"instl":0,

"secure":0,

"native":{




"request":"{\"ver\":\"1.1\",\"plcmtcnt\":1,\"assets\":[{\"id\":1,\"data\":{\"type\":12}},{\"id\":2,\"required\":1,\"title\

":{\"len\":50}},{\"id\":3,\"required\":1,\"img\":{\"type\":1,\"wmin\":80,\"hmin\":80}},{\"id\":4,\"required\":1,\"img\"

:{\"type\":3,\"wmin\":1200,\"hmin\":627}},{\"id\":5,\"data\":{\"type\":3}},{\"id\":6,\"required\":1,\"data\":{\"type\": 2,\"len\":100}}]}",

"ver":"1.1"

},

"bidfloor":0.236, "tagid":"1"

}

],

"device":{

"dnt":0, "devicetype":1, "geo":{

"country":"USA", "type":2,

"lat":39.9524,

"lon":-75.0884,

"region":"NJ",

"city":"Camden",

"zip":"08105"

},

"connectiontype":2, "language":"en",


"model":"android", "carrier":"Comcast Cable",

"dpidsha1":"21748b97f0e829adfb0ee79b84a5b4e9c34e5c87", "dpidmd5":"04c33b085c1f50f9d461ef89eafa8c65", "ifa":"56C40F4C-9EAD-4602-A844-EC85A37B3B60",

"os":"android",

"osv":"8.0.0",

"ua":"Mozilla/5.0 (Linux; Android 8.0.0; SM-G955U Build/R16NW; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/67.0.3396.87 Mobile Safari/537.36",

"ip":"68.83.71.69"

}, "at":2,

"badv":[

"adv_13_dom.com"

],

"user":{

"ext":{

"consent":""

}

},

"regs":{

"ext":{

"gdpr":0

}

},

"app":{

"id":"20828a1253e0",

"name":"DTXtest app", "bundle":"test.DTX", "cat":[

"IAB3"

],

"publisher":{

"id":"1006445"

}

}

}

Video Bid Request Example

{

"id":"8cf436a2a4025181bfde59cc492c4833rt44282", "at":2,

"cur":[

"USD"

],

"tmax":500,

"imp":[

{

"id":"3592",

"instl":0,

"secure":0, "bidfloor":0.8801, "video":{

"w":320,

"h":480,

"mimes":[

"video/mp4", "application/javascript"

],

"protocols":[

2,

5,

3,

6

],

"linearity":1, "minduration":1, "maxduration":120, "boxingallowed":1, "minbitrate":250, "api":[2],

"battr":[8, 10]

},





}],

"bcat":[

 

 

],

"tagid":"f8310c5872b6d7c61ca3ab1d43515ebd"

 

"IAB9-7",

"IAB14-1",

"IAB25-3"


"user":{"id":"3bd4b338a544d1aa4615cb2ace29a3c117096160"}, "regs":{

"coppa":0,

"ext":{


"gdpr":0

}

},


"device":{

"geo":{

 

 

 

 

 

 

},

 




"type":2,

"lat":33.9224,

"lon":-117.2476,

"country":"USA", "city":"Moreno Valley", "metro":"803",

"zip":"92553"


"ip":"47.180.20.79",

"osv":"8.1.0",

"os":"android", "make":"sky_devices", "model":"platinum_e5",

"ua":"Mozilla/5.0 (Linux; Android 8.1.0; Platinum_E5 Build/O11019; wv) AppleWebKit/537.36 (KHTML,

like Gecko) Version/4.0 Chrome/74.0.3729.136 Mobile Safari/537.36", "ifa":"2288AC1D-91F8-4124-865A-96585719A87F",

"carrier":"Frontier Communications", "connectiontype":2,

"language":"en-US", "dnt":0,

"lmt":0, "devicetype":4

},

"app":{

"id":"03adaee12c95482136962e3f4a086841",

"bundle":"com.c125tek.inputsv55.skin.keyboard_theme_neon_blue_heart_keyboard", "name":"ime_skin",




"storeurl":"https://play.google.com/store/apps/details?id=com.c125tek.inputsv55.skin.keyboard_theme_ne on_blue_heart_keyboard",

"publisher":{"id":"79"}, "cat":["IAB1"]

}

}

Site Pop Bid Request Example

{ "id":"16133315580841",

"user":{"id":"0"},

"ext":{"format":"json-web","topic_id":6,"key":""}, "imp":[

{

"id":"866438918186",

"bidfloor":0.35, "bidfloorcur":"USD", "banner":

{


 

 

}

}

],

"site":

{

"ext":{"type":1}, "w":1,

"h":1


"domain":"site.net",

"id":"451708-none_1935_69040000",

"page":"http://site.net",

"keywords":"",

"ref":"", "cat":[

"IAB6","IAB7","IAB8","IAB10","IAB16","IAB17"

],

"ext":{"userid":451708}

},

"device":

{

"ip":"124.36.182.22",

"ua":"Mozilla/5.0 (Windows NT 6.3; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/64.0.3282.31 Safari/537.36",

"geo":{"country":"US","type":2,"ipservice":3,"region":"North Carolina","city":"Winston-Salem"}, "language":"",

"devicetype":3, "ext":{"accept_language":"","remote_addr":"95.111.127.95","x_forwarded_for":""}

}

}

App Push Notification Bid Request Example

{ "cur":["USD"],

"tmax":150,

"imp":[

{

"bidfloor":0.049, "tagid":"5d2316e6ddfe096f9bf233e2ab7f6cb7", "instl":1,

"native":

{

"request":"{ \"adunit\": 2, \"assets\": [ { \"id\": 3, \"img\": { \"h\": 120, \"hmin\": 0, \"type\": 3, \"w\":

180, \"wmin\": 0 }, \"required\": 1 }, { \"id\": 0, \"required\": 1, \"title\": { \"len\": 140 } }, { \"data\": { \"len\": 25,

\"type\": 1 }, \"id\": 4, \"required\": 1 }, { \"data\": { \"len\": 140, \"type\": 2 }, \"id\": 6, \"required\": 1 } ],

\"context\": 1, \"layout\": 1, \"contextsubtype\": 11, \"plcmtcnt\": 1, \"plcmttype\": 2, \"ver\":

\"1.1\",\"ext\":{\"banner\":{\"w\":320,\"h\":480}}}"}, "id":"102",

"secure":0

}

],

"ext":{"location":"inpage"}, "version":"2.3",

"at":2,

"device":

{


"geo":

{

 

 

 

 

 

},

 




"lat":6.335,

"country":"NGA", "lon":5.6274999999999995,

"city":"Benin City", "accuracy":200


"language":"en-US",

"ua":"Mozilla/5.0 (Linux; Android 8.1.0; TECNO LA7 Pro Build/O11019; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/69.0.3497.100 Mobile Safari/537.36",

"make":"TECNO MOBILE LIMITED",

"connectiontype":6, "osv":"8.1.0",

"dpidsha1":"a440dc2544a51bec313c9f4b8af6fd2ce4485d1f", "dnt":0,

"carrier":"Airtel Networks Limited", "devicetype":4,

"ifa":"aab2455a-1051-45ea-94a4-6a96a41f72e6",


 

 

 

 

 

},

"app":

{

"ip":"105.112.96.239",

"model":"TECNO LA7 Pro", "js":1,

"os":"android", "dpidmd5":"19e72f4c14003c3db5041f9b15824c6e"

 

 

"publisher":{"id":"25139"},

"name":"PDScreen - Colorful Flash Themes", "bundle":"com.color.flash.colorpd",


"cat":["IAB1","IAB19","IAB19-29","IAB19-18","IAB3-4","IAB3","IAB14","IAB10-6","IAB10","IAB9","IAB9-7","

IAB9-30","IAB19-23","IAB15-10","IAB15","IAB1-6","IAB7","IAB7-44","IAB17-30","IAB17","IAB23-7","IAB23

","IAB25","IAB22","IAB9-11","IAB9-10","IAB1-1","IAB9-23","IAB9-5","IAB12","IAB8","IAB8-17","IAB17-42",

"IAB19-6","IAB12-3","IAB26-3","IAB13-3","IAB13","IAB5","IAB2","IAB6","IAB19-16","IAB19-5","IAB7-1","IA

B17-4","IAB20","IAB7-32","IAB1-7","IAB5-8","IAB18","IAB16","IAB11-4","IAB11","IAB17-44","IAB4","IAB1 9-17"],

"pagecat":["IAB24"], "id":"fec1575d64e4",

"storeurl":"https://play.google.com/store/apps/details?id=com.color.flash.colorpd"

},

"id":"331-5c8798219b2921-339",

"user":

{

"buyeruid":"", "id":"so0Lj3PGuzW+V9gyQUwgmlkL3D/vcIBgx03RIMqq0fE="

},

"_state":{}, "bundle":"com.color.flash.colorpd"

}

Audio Bid request Example

{

  "id": "5yf48752-548a-45dr-45h5-dut4950647",

  "imp": [

    {

      "id": "46056hf1-0685-69k4-84h3-6lt59659f4eru",

      "audio": {

        "mimes": [

          "audio/ogg",

          "audio/mpeg",

          "audio/mp3",

          "audio/aac",

          "audio/wav",

          "audio/mp2",

          "audio/m4a",

          "audio/wma",

          "audio/flac"

        ],

        "minduration": 1,

        "maxduration": 150,

        "protocols": [

          2,

          3,

          5,

          6,

          9,

          10

        ],

        "startdelay": -1,

        "minbitrate": 30,

        "maxbitrate": 300800,

        "api": [

          6

        ]

      },

      "bidfloor": 3.3407432346,

      "bidfloorcur": "USD",

      "secure": 0,

      "tagid": "2946952_1"

    }

  ],

  "site": {

    "id": "10008756",

    "name": "SAMPLE-SH",

    "domain": "http://sample.com ",

    "cat": [

      "IAB1"

    ],

    "sectioncat": [

      "IAB1"

    ],

    "pagecat": [

      "IAB1"

    ],

    "page": "http://www.sample.com ",

    "ref": "http://www.sample.com ",

    "publisher": {

      "id": "650",

      "name": "SH_Sample",

      "domain": ""

    },

    "content": {

      "genre": "Talk"

    }

  },

  "device": {

    "ua": "AppleCoreMedia/1.0.0.18F72 (iPhone; U; CPU OS 14_6 like Mac OS X; en_us)",

    "geo": {

      "country": "usa"

    },

    "ip": "174.248.121.124",

    "devicetype": 4,

    "os": "iOS",

    "language": "en",

    "ifa": "",

    "dpidsha1": "",

    "dpidmd5": "",

    "js": 0,

    "flashver": "-1"

  },

  "user": {

    "id": "PDY6HD3D1A865AS2"

  },

  "at": 1,

  "bcat": [

    "IAB25",

    "IAB26",

    "IAB2-1"

  ],

  "regs": {

    "ext": {

      "us_privacy": "1---"

    }

  }

}

 

 

 

{

"id":"1604878679620146",

"bidid":"6c528cc37f7cb7b991314d07539ba636", "seatbid":[

{

"bid":[

{

"id":"80a5b9489b88b1fd819ed3ac92ddba1a", "impid":"1",

"price":0.20505,




"nurl":"http://s1e.smarthub.smartyads.com/?win=nurl&sp=${AUCTION_PRICE}&t=banner&uniq=d84cecf8 1051da76a95ef2b89b4b1105",

"adm":"<img src='http://s1e.smarthub.smartyads.com/?win=impr&price=${AUCTION_PRICE}&prt=4_9563cbab5ac513 b0cae7454f06b59fa6&t=banner&uniq=d84cecf81051da76a95ef2b89b4b1105' border='0' width='1' height='1'>",

"w":320,

"h":50,

"adomain":[ "dtx.smartyads.com"

],

"cat":[

"IAB20-3"

],

"attr":[ 4

],

"adid":"dea25016e99c", "cid":"4_79_771_19594",

"crid":"9563cbab5ac513b0cae7454f06b59fa6"

}

],

"seat":"4"

}

],

"cur":"USD"

}

Native Bid Response Example

{

"id":"-6546523267599067373",

"bidid":"5413cb366a2560cd74344af4c94bae99", "seatbid":[

{