Bid Request

id

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

Always provided.

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

at

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

Always provided.

Always sends: 2

test

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

Always provided.

Always sends: 0

tmax

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

Always provided.

Example: 500

cur

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

Currently USD is the only supported currency.

Always provided.

Always sends: [“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.

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

badv

Block list of advertisers by their domains.

This is based on SSP rules.

Example: ["example.com","blork.example"]

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.

Always provided.

imp[].id

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

Always provided.

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

imp[].bidfloor

Minimum bid for this impression expressed in CPM.

Only provided when Open Auction is allowed.

Example: 0

imp[].bidfloorcur

Currency specified using ISO-4217 alpha codes.

Only provided when Open Auction is allowed.

Always sends: "USD"

imp[].secure

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

Example: 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.

Always provided.

Example: 1800

imp[].ext.tid

Transaction ID that must be common across all participants in this bid request, which potentially includes multiple exchanges.
Always provided.

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

imp[].ext.gpid

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

Example: "123456"

imp[].rwdd

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

Always sends: 0

imp[].audio

An Audio object.

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

Always provided.

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.

Always provided.

Always sends: ["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.

Always provided.

Example: 15

imp[].audio.maxduration

Maximum audio ad duration in seconds.

This is based on publisher rules.

Always provided.

Example: 60

imp[].audio.maxextended

Maximum extended ad duration if extension is allowed.

Always provided.

Always sends: 5

imp[].audio.maxseq

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

Always provided.

Always sends: 1

imp[].audio.protocols

Array of supported audio protocols.

Always provided.

Always sends: [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.

Always provided.

Example: -1

imp[].audio.minbitrate

Minimum bit rate in Kbps.

Always provided.

Always sends: 0

imp[].audio.maxbitrate

Maximum bit rate in Kbps.

Always provided.

Always sends: 576

imp[].audio.delivery

Supported delivery methods.  

Example: 3

imp[].audio.feed

Type of audio feed.

Example: 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.

Always provided.

Always sends: 0

imp[].pmp.deals

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

Always provided.

imp[].pmp.deals[].id

A unique identifier for the direct deal.

Always provided.

Example: "82751"

imp[].pmp.deals[].bidfloor

Minimum bid for this impression expressed in CPM.

Always provided.

Example: 5

imp[].pmp.deals[].bidfloorcur

Currency specified using ISO-4217 alpha codes.

Always provided.

Always sends: "USD"

imp[].pmp.deals[].at

Override of the overall auction type of the bid request.

Always provided.

Example: 3

imp[].pmp.deals[].wseat

Allow-list of buyer seat IDs, such as advertisers,  or agencies, allowed to bid on this deal.

Example: ["1765"]

imp[].pmp.deals[].wadomain

Array of advertiser domains. Omission implies no advertiser restrictions.

Example: ["example.com"]

imp[].pmp.deals[].ext

Exchange-specific extensions to OpenRTB.

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

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

Example: 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.

Always provided.

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.

Always provided.

Example: 4200.0

imp[].qty.sourcetype

The source type of the quantity measurement.

1 = Measurement Vendor Provided, 2  = Publisher Provided.

Always provided.

Example: 1

imp[].qty.vendor

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

Always provided.

Example: "blork.example"

site

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

Only one of site or app or ota is always provided.

app

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

Only one of site or app or ota is always provided.

ota

Only one of site or app or ota is always provided.

site|app|ota.id

Placement ID.

Always provided.

Example: "123456"

site|app|ota.name

Placement name.

Always provided.

Example: "BLORKFM"

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.

Example: ["342", "341"]

site|app|ota.domain

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

Example: "www.example.com"

site|app|ota.page

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

Example: "http://www.example.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.

Example: "123456"

site|app|ota.publisher.name

Publisher name. May be aliased at the publisher’s request.

Publisher name.

Example: "Blork Media"

site|app|ota.content

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

Always provided.

site|app|ota.content.context

Type of content, such as game, video, text, and so on.

3 = Music.

Always provided.

Always sends: 3

site|app|ota.content.genre

Genre that best describes the content.
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..

Examples: "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.

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

site|app|ota.content.language

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

Example: "en"

site|app|ota.content.prodq

Production quality.

Always 1 for “professionally produced”.

Always provided.

Always sends: 1

site|app.content.series

Content series.

Example: "Ecocentric"

site|app.content.season

Season number.

Example: 3

site|app.content.episode

Episode number.

Example: 5

site|app.content.title

Episode title.

Example: "La vie est belle"

site|app.content.url

Episode origin URL. For buy-side contextualization or review.

Example: "http://example.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.

Triton only sends inventory as app when Triton gets this attribute.

Always provided.

Example: "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.

Example: 0

device.ip

IPv4 address closest to device.

Only one of ip or ipv6 is always provided, not both.

Example: "198.51.100.13"

device.ipv6

IP address closest to device as IPv6.

Only one of ip or ipv6 is provided, not both.

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

device.ua

Browser user agent string. 

Always provided.

Example: "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.

Example: 2

device.ext.ifa_type

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

Always provided.

Example: "idfa"

device.model

Device model.

Example: "ios-generic"

device.os

Device operating system.

Example: "ios"

device.language

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

Example: "en"

device.connectiontype

Network connection type.

Example: 2

device.ifa

ID sanctioned for advertiser use in the clear, not hashed.

Example: "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.

Always provided.

Example: 2

device.geo.ipservice

Service or provider used to determine geolocation from IP address if applicable. Triton Digital uses MaxMind (3).

Always provided.

Always sends: 3

device.geo.lat

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

Example: +46.5

device.geo.lon

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

Example: -81.2

device.geo.country

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

Example: "CAN"

device.geo.region

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

Example: "NY"

device.geo.metro

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

Example: 530

device.geo.zip

Zip or postal code.

Example: "10001"

user

Human user of the device, or audience for advertising.

user.id

Triton Digital's internal ID.

Always provided.

Example: "cookie:8c41257f-b963-44a0-be46-8169f14431c5"

user.buyeruid

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

Example: "3300756426816551293"

user.yob

Year of birth as a 4-digit integer.

Example: 1986

user.gender

Gender, where “M” = male, “F” = female, “O” = known to be other. Omitted is unknown.

Example: "M"

user.ext.consent

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

source

 Always provided.

source.ext

Placeholder for exchange-specific extensions to OpenRTB.

Always provided.

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.

Always provided.

source.ext.schain.ver

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

Always provided.

Always sends: "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.

Always provided.

Always sends: 1

source.ext.schain.nodes

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

Always provided.

source.ext.schain.nodes.asi

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

Always provided.

Example: "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, the same as site|app.publisher.id.

Always provided.

Example: "123456"

source.ext.schain.nodes.rid

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

Always provided.

Example: "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.

Always provided.

Always sends: 1

regs

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

Always provided.

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 sections 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.

Always provided.

regs.ext.coppa

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

Always provided.

regs.ext.gdpr

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

Always provided.

regs.ext.us_privacy

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