Bid Request

id

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

"449a4ec8-fd49-4df9-9c4a-96f731d894d1"

at

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

2

test

Indicator of test mode in which auctions are not billable, where 0 = live mode, 1 = test mode.

A test auction isn't billed but generates extra application logging.

0

tmax

Maximum time in milliseconds to submit a bid to avoid timeout.

500

cur

Array of allowed currencies for bids on this bid request using ISO-4217 alpha codes.

Currently USD is the only supported currency.

[“USD”]

bcat

Blocked advertiser categories using the IAB content categories.

Taxonomy version 1.0 Support for this is required to enforce industry separation (frequency cap) and SSP ad quality rules.

["IAB24", "IAB1-12", "IAB3"]

badv

Block list of advertisers by their domains.

This is based on SSP rules.

["mtv.com","mazda.com"]

wlang

Allow list of languages for creatives using ISO-639-1-alpha-2.

imp

Array of Imp objects representing the impressions offered.

Currently Triton Digital only supports a single element.

imp[].id

A unique identifier for this impression within the context of the bid request.

"e3a72cb4-f5bb-11e5-9ce9-5e5517507c66"

imp[].bidfloor

Minimum bid for this impression expressed in CPM.

Only provided when Open Auction is allowed.

0

imp[].bidfloorcur

Currency specified using ISO-4217 alpha codes.

Only provided when Open Auction is allowed.

"USD"

imp[].secure

Flag to indicate if the impression requires secure HTTPS URL creative assets and markup. This only applies to the banner.

0

imp[].exp

Advisory as to the number of seconds that may elapse between the auction and the actual impression.

When returning a bid, your ad impression URL shouldn't expire before this delay has elapsed.

1800

imp[].ext.tid

Transaction ID that must be common across all participants in this bid request (e.g., potentially multiple exchanges).

"e3a72cb4-f5bb-11e5-9ce9-5e5517507c66"

imp[].ext.gpid

A consistent unique id for each impression placement on a page.

"123456"

imp[].rwdd

Indicates whether the user receives a reward for viewing the ad, where 0 = no, 1 = yes.

0

imp[].audio

An Audio object.

Upon request, demand partners that don't support the Audio object can have the data sent in a imp.video attribute.

imp[].audio.mimes

Content MIME types supported.

List provided in this document is what is always supported by Triton Digital for every bid request (regardless of publisher).

["audio/aac", "audio/mp4", "audio/mpeg", "audio/mpeg3", "audio/mp3", "audio/vnd.wave", "audio/wav", "audio/wave", "audio/ogg", "audio/vorbis"]

imp[].audio.minduration

Minimum audio ad duration in seconds.

This is based on publisher rules.

15

imp[].audio.maxduration

Maximum audio ad duration in seconds.

This is based on publisher rules.

60

imp[].audio.maxextended

Maximum extended ad duration if extension is allowed.

5

imp[].audio.maxseq

The maximum number of ads that can be played in an ad pod.

1

imp[].audio.protocols

Array of supported audio protocols.

[2,3,5,6,9,10]

imp[].audio.startdelay

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

-1

imp[].audio.minbitrate

Minimum bit rate in Kbps.

0

imp[].audio.maxbitrate

Maximum bit rate in Kbps.

576

imp[].audio.delivery

Supported delivery methods.  

3

imp[].audio.feed

Type of audio feed.

3

imp[].pmp

Collection of private marketplace (PMP) deals applicable to this impression.

imp[].pmp.private_auction

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.

0

imp[].pmp.deals

Array of Deal objects that convey the specific deals applicable to this impression.

imp[].pmp.deals[].id

A unique identifier for the direct deal.

"82751"

imp[].pmp.deals[].bidfloor

Minimum bid for this impression expressed in CPM.

5

imp[].pmp.deals[].bidfloorcur

Currency specified using ISO-4217 alpha codes.

"USD"

imp[].pmp.deals[].at

Override of the overall auction type of the bid request.

3

imp[].pmp.deals[].wseat

Allowlist of buyer seats (e.g., advertisers, agencies) allowed to bid on this deal.

["1765"]

imp[].pmp.deals[].wadomain

Array of advertiser domains (e.g., advertiser.com) allowed to bid on this deal. Omission implies no advertiser restrictions.

["nike.com"]

imp[].pmp.deals[].ext

Exchange-specific extensions to OpenRTB.

imp[].pmp.deals[].ext.guaranteed

N/A

Flag indicating the deal is for guaranteed inventory when the value is 1.

1

imp[].qty

This object includes the impression multiplier, and describes the source of the multiplier value.

This object is identical to the one in the DOOH proposal that is currently under review by IAB Tech Lab.

imp[].qty.multiplier

The quantity of billable events which will be deemed to have occurred if this item is purchased.

This is formatted as a float but Triton Digital will only send full integers.

4,200.0

imp[].qty.sourcetype

The source type of the quantity measurement.

1 means: Measurement Vendor Provided

2 means: Publisher Provided

1

imp[].qty.vendor

The top level business domain name of the measurement vendor providing the quantity measurement.

"blork.org"

site

Details via a Site object about the publisher’s website.

Only one of site or app or ota is sent.

app

Details via an App object about the publisher’s app.

Only one of site or app or ota is sent.

ota

N/A

Only one of site or app or ota is sent.

site|app|ota.id

Exchange-specific site ID.

Placement ID.

"123456"

site|app|ota.name

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

Placement name.

"KROQFM"

site|app|ota.cat

Array of IAB content categories of the site.

Category of the content as defined by the IAB Tech Lab Content Taxonomy Version 2.0.

["342", "341"]

site|app|ota.domain

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

Domain portion of the URL sent in site/app.page

"www.mystation.com"

site|app|ota.page

URL of the page where the impression will be shown.

Official URL where the content is published. In some cases inventory be from a third party "distributor" site/app where the content is accessed yet the official URL is still provided (not the third-party one).

"http://www.mystation.com/player/mystation-hits"

site|app|ota.publisher

Entity that controls the content of and distributes the site or app.

site|app|ota.publisher.id

Exchange-specific publisher ID.

Publisher ID.

"123456"

site|app|ota.publisher.name

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

Publisher name.

"CBS"

site|app|ota.content

Details about the published content itself, within which the ad will be shown.

site|app|ota.content.context

Type of content (game, video, text, etc.).

Always 3 (= Music)

3

site|app|ota.content.genre

Genre that best describes the content (e.g., rock, pop, etc). 
For Podcast this will be the ITunes Podcast Category.

For On-Demand and Live content this will be the IABv2 category name for the station..

"True Crime"

"Adult Contemporary Music"

"Adult Album Alternative"

site|app|ota.content.id

ID uniquely identifying the content. For Podcasts.
For Podcast inventory, this is the GUID of the episode provided in the RSS feed.

"07a66697-0400-4903-b3da-67a61d2b7058"

site|app|ota.content.language

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

"en"

site|app|ota.content.prodq

Production quality.

Always 1 (= professionally produced)

1

site|app.content.series

Content series.

"Ecocentric"

site|app.content.season

Content season (e.g., “Season 3”).

Season number.

3

site|app.content.episode

Episode number.

Episode number.

5

site|app.content.title

Content title.

Episode title.

"La vie est belle"

site|app.content.url

URL of the content, for buy-side contextualization or review.

Episode origin URL.

"http://mediapodcast.com/media/audio/multimedia/20200211/3/5fhdfghdfgh_1542275535.mp3"

app.bundle

A platform-specific application identifier intended to be unique to the app and independent of the exchange.

We only send inventory as "app" when we get this attribute.

"com.tritondigital.tritonradio"

device

Details of the device on which the content and impressions are displayed.

device.dnt

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

0

device.ip

IPv4 address closest to device.

Only one of ip or ipv6 is provided (not both).

"38.108.249.106"

device.ipv6

IP address closest to device as IPv6.

Only one of ip or ipv6 is provided (not both).

"2001:0db8:85a3:0000:0000:8a2e:0370:7334" 

device.ua

Browser user agent string. 

"Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.6; en-US; rv:1.9.2.10) Gecko/20100914 Firefox/3.6.10"

device.devicetype

The general type of device.

2

device.ext.ifa_type

Declared source of the device.ifa provided in the bid request.

"idfa"

device.model

Device model.

"ios-generic"

device.os

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

"ios"

device.language

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

"en"

device.connectiontype

Network connection type.

2

device.ifa

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

"70022383-d877-410b-bab2-e9c51c3854c1"

device.geo

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

device.geo.type

Source of location data.

Only IP or GPS. For registration-based geo, see user object.

2

device.geo.ipservice

Service or provider used to determine geolocation from IP address if applicable (i.e., type = 2).

Triton Digital uses MaxMind (3).

3

device.geo.lat

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

+45.5

device.geo.lon

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

-73.566667

device.geo.country

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

"USA"

device.geo.region

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

"NY"

device.geo.metro

Google metro code; similar to but not exactly Nielsen DMAs.

530

device.geo.zip

Zip or postal code.

"10001"

user

Human user of the device; audience for advertising.

user.id

Exchange-specific ID for the user.

Triton Digital's internal ID.

"cookie:"

user.buyeruid

Buyer-specific ID for the user as mapped by the exchange for the buyer.

"3300756426816551293"

user.yob

Year of birth as a 4-digit integer.

1986

user.gender

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

"M"

user.ext.consent

GDPR Consent String from user based on the Transparency and Consent Framework format.

source

source.ext

Placeholder for exchange-specific extensions to OpenRTB.

source.ext.schain

This object represents both the links in the supply chain as well as an indicator whether or not the supply chain is complete.

source.ext.schain.ver

Version of the supply chain specification in use, in the format of “major.minor”.

1.0

source.ext.schain.complete

Flag indicating whether the chain contains all nodes involved in the transaction leading back to the owner of the site, app or other medium of the inventory, where 0 = no, 1 = yes.

1

source.ext.schain.nodes

N/A

Triton usually inserts only one node, but could add more if the publisher calls Triton Digital via a third-party advertising system.

source.ext.schain.nodes.asi

The canonical domain name of the SSP, Exchange, Header Wrapper, etc system that bidders connect to.

tritondigital.com

source.ext.schain.nodes.sid

The identifier associated with the seller or reseller account within the advertising system.

We provide the publisher's numerical identifier (same as site/app.publisher.id)

"123456"

source.ext.schain.nodes.rid

The OpenRTB RequestId of the request as issued by this seller.

"449a4ec8-fd49-4df9-9c4a-96f731d894d1"

source.ext.schain.nodes.hp

Indicates whether this node will be involved in the flow of payment for the inventory.

1

regs

This object contains any legal, governmental, or industry regulations that apply to the request.

regs.gpp

Contains the Global Privacy Platform's consent string. See the Global Privacy Platform specification for more details.
GPP string allowing the transmission of privacy, consent, and consumer choice signals. The string must comply with the IAB Tech Lab Global Privacy Platform specification.

regs.gpp_sid

Array of the section(s) of the string which should be applied for this transaction. Generally will contain one and only one value, but there are edge cases where more than one may apply. GPP Section 3 (Header) and 4 (Signal Integrity) do not need to be included. See the GPP Section Information for more details.
Section ID to indicates which legislation (i.e., section of the GPP string) is considered “in force”.

regs.ext

Placeholder for exchange-specific extensions to OpenRTB.

regs.ext.coppa

Extension attribute “coppa” which is an optional integer that indicates: 0 = No, 1 = Yes.

regs.ext.gdpr

Extension attribute “gdpr” which is an optional integer that indicates: 0 = No, 1 = Yes.

regs.ext.us_privacy

Extension attribute “us_privacy” which is an optional integer that indicates: 0 = No, 1 = Yes.