Bid Request

id

Always provided.

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

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

at

Always provided.

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

Always sends: 2

test

Always provided.

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

Always sends: 0

tmax

Always provided.

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

Example: 500

cur

Always provided.

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

Currently USD is the only supported currency.

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

Always provided.

Array of Imp objects representing the impressions offered.

Currently Triton Digital only supports a single element.

imp[].id

Always provided.

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

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

imp[].bidfloor

Only provided when Open Auction is allowed.

Minimum bid for this impression expressed in CPM.

Example: 0

imp[].bidfloorcur

Only provided when Open Auction is allowed.

Currency specified using ISO-4217 alpha codes.

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

Always provided.

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.

Example: 1800

imp[].ext.tid

Always provided.

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

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

imp[].ext.gpid

Always provided.

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

Example: "123456"

imp[].rwdd

Always provided.

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

Always sends: 0

imp[].audio

Always provided.

An Audio object.

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

imp[].audio.mimes

Always provided.

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

Always provided.

Minimum audio ad duration in seconds.

This is based on publisher rules.

Example: 15

imp[].audio.maxduration

Always provided.

Maximum audio ad duration in seconds.

This is based on publisher rules.

Example: 60

imp[].audio.maxextended

Always provided.

Maximum extended ad duration if extension is allowed.

Always sends: 5

imp[].audio.maxseq

Always provided.

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

Always sends: 1

imp[].audio.protocols

Always provided.

Array of supported audio protocols.

Always sends: [2,3,5,6,9,10]

imp[].audio.startdelay

Always provided.

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

Example: -1

imp[].audio.minbitrate

Always provided.

Minimum bit rate in Kbps.

Always sends: 0

imp[].audio.maxbitrate

Always provided.

Maximum bit rate in Kbps.

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

Always provided.

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 sends: 0

imp[].pmp.deals

Always provided.

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

imp[].pmp.deals[].id

Always provided.

A unique identifier for the direct deal.

Example: "82751"

imp[].pmp.deals[].bidfloor

Always provided.

Minimum bid for this impression expressed in CPM.

Example: 5

imp[].pmp.deals[].bidfloorcur

Always provided.

Currency specified using ISO-4217 alpha codes.

Always sends: "USD"

imp[].pmp.deals[].at

Always provided.

Override of the overall auction type of the bid request.

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

Always provided.

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

Always provided.

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.

Example: 4200.0

imp[].qty.sourcetype

Always provided.

The source type of the quantity measurement.

1 = Measurement Vendor Provided, 2  = Publisher Provided.

Example: 1

imp[].qty.vendor

Always provided.

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

Example: "blork.example"

site

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

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

app

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

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

ota

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

site|app|ota.id

Always provided.

Placement ID.

Example: "123456"

site|app|ota.name

Always provided.

Placement name.

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 is 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

Always provided.

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

site|app|ota.content.context

Always provided.

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

3 = Music.

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

Always provided.

Production quality.

Always 1 for “professionally produced”.

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

Always provided.

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.

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

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

IPv4 address closest to device.

Example: "198.51.100.13"

device.ipv6

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

IP address closest to device as IPv6.

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

device.ua

Always provided.

Browser user agent string. 

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

Always provided.

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

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

Always provided.

Source of location data.

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

Example: 2

device.geo.ipservice

Always provided.

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

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

Always provided.

Triton Digital’s internal ID.

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

Always provided.

Placeholder for exchange-specific extensions to OpenRTB.

source.ext.schain

Always provided.

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

Always provided.

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

Always sends: "1.0"

source.ext.schain.complete

Always provided.

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 sends: 1

source.ext.schain.nodes

Always provided.

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

Always provided.

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

Example: "tritondigital.com"

source.ext.schain.nodes.sid

Always provided.

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

Triton provides the publisher's numerical identifier, the same as site|app.publisher.id.

Example: "123456"

source.ext.schain.nodes.rid

Always provided.

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

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

source.ext.schain.nodes.hp

Always provided.

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

Always sends: 1

regs

Always provided.

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

Always provided.

Placeholder for exchange-specific extensions to OpenRTB.

regs.ext.coppa

Always provided.

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

regs.ext.gdpr

Always provided.

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.