List of supported OpenRTB bid request fields

id

String; required

The Index unique ID for the request. The ID is a 36-character alphanumeric string.

imp

Object; required

The Impression Object; contains at least one Banner Object or Video Object.

device

Object; required

The Device Object.

tmax

Object; required

Maximum time in milliseconds that Index allows to receive bids. To avoid timeouts, the tmax field does not subtract internet latency between Index and the DSP.

Note: If required, we can subtract latency when passing tmax. For more information, contact your Index Representative.

cur

String array; optional

The currencies that publishers will accept in bid responses. Currencies must be specified in the ISO-4217 standard and must be supported by Index. For more information, see List of supported currencies.

ext

Required

A custom Index Request Extension Object that contains additional information about the bid request.

app

Object; optional

The App Object; included if the impression originates from an application.

bcat

Array of Strings; optional

An array of blocked advertiser categories, based on standard IAB content categories. The full list is available in section 5.1 of the OpenRTB Specification (version 2.5).

badv

Array of strings; optional

A list of advertiser domains that have been blocked by the publisher from serving on their properties, for example “ford.com”.
Note: This field is temporarily unavailable while we make some optimization improvements.

regs

Object; optional

The Regulations Object.

site

Object; optional

The Site Object; included if the impression originates from a website.

user

Object; optional

The User Object.

edepth

Integer; optional

The number of ad requests since a session was started with the user (max 255).

placement

Object; optional

The Placement Object.

sdepth

Integer; optional

The number of ad requests since a session was started with the user for the domain (max 255).

tz

Integer; optional

The user time zone derived from the JavaScript getTimezoneOffset() function.

name

String; optional

A name that describes why the impression is private (for example, "Homepage").

private

Boolean; optional

The scope of DSP bidding eligibility for this impression, where:

• 1 = private and eligible bids are restricted to the deals specified

pchain

String; optional

The Payment ID chain string provides visibility into an impression's supply path. For bid requests sourced directly from Index, the pchain field will display:

• Index's TAG ID of 50b1c356f2c5c8fc

• Publisher ID, such as 2167

For example, 50b1c356f2c5c8fc:2167.

For bid requests sourced from a supplier, the pchain field will display the TAG ID and publisher ID for both the supplier and Index. For example, <Supplier ID>:<Publisher ID>-50b1c356f2c5c8fc:2167. For more information or to get a list of supplier IDs for pchain, contact TAG at info@tagtoday.net.

ext

String; optional

sourceType

Integer; required

The header bidding type used in the auction, where:

• 1 = the request is not from a header bidding auction

• 2 = the request is from a client-side header bidding auction

• 3 = the request is from a server-side header bidding auction

sourceOrigin

Integer; required

The source of the impression opportunity which specifies where it originated from, where:

• 1 = direct (tag-based)

• 2 = other SSP

• 3 = Amazon TAM

• 4 = Google Open Bidding

• 5 = Prebid

• 6 = IX Wrapper Library

• 7 = other header bidding solution

schain

Object; optional

Like pchain, schain also provides buyers visibility into all parties who are involved in the selling or reselling of a bid request.

To interpret the schain object, you can reference our sellers.json file that contains a list of all our supply partners at www.indexexchange.com/sellers.json.

For more information, see the Supply chain object below.

omidpn

String; optional

An identifier for the OM SDK integration. This is the same as the name parameter of the OMID Partner object.

omidpv

String; optional

A version of the OM SDK integration. This is the same as the versionString parameter of the OMID Partner object.

complete

Integer; required

A flag that specifies whether the chain contains all nodes involved in the transaction leading back to the supply source of the inventory, where:

• 0 = no
• 1 = yes

nodes

Object array; required

An array of SupplyChainNode objects in the order of the chain. Each node represents a different seller or exchange system that has touched the impression. The last node in the array represents the seller sending the bid request. For more information, see Nodes objects below.

ver

String; required

Version of the supply chain specification in use, in the format of “major.minor”. Index is currently using version 1.0 of the sellers.json specification.

asi

String; required

Domain name of the system that the bidder connects to. For example, SSP, exchange.

Note: You can find the sellers.json file for each node through this domain name. The same domain is also used in ads.txt files for publishers (for example, indexexchange.com).

rid

String; optional

The request's OpenRTB RequestId issued by the seller.

Note: The same information can also be found in bidrequest.id.

String; required

The seller or reseller account ID.

Note: The same information can also be found in site.publisher.id.

hp

Integer; required

Specifies whether this node is involved in the flow of payment for the inventory. The hp field is sent if an upstream chain includes it. Index's node will always include hp=1. For version 1.0 of SupplyChain, this property should always be 1.

coppa

Integer; optional

Specifies whether this request is subject to the United States Children’s Online Privacy Protection Act (COPPA), where:

• 0 = no
• 1 = yes

If this flag is omitted in the request, Index assumes that this information is unavailable.

Note: The following fields are automatically blanked in COPPA-related requests: lat, lon, metro, city and zip (in the Geo Object).

ext

Object; optional

The Regulation Extension Object, which is used to specify requests that are subject to regulations. See the table below.

gdpr

Integer; optional

Specifies whether the request is subject to regulations, where:

• 0 = request is not subject to regulations.
• 1 = request is subject to regulations

us_privacy

Object; optional

Specifies whether US privacy laws (for example, CCPA) apply or don't apply to the user in the bid request. This field contains four characters. For example, 1YYN. The meaning of each character is based on its position in the string as defined below:

• 1st character: The version number for the US privacy string specification used to encode the string.
• 2nd character: Specifies whether the user had explicit notice and the choice to opt-out of the sale of their personal information, where:.
  • N = no
  • Y = yes
  • - = not applicable
• 3rd character: Specifies whether the user has opted-out of the sale of their personal information.
  • N = no
  • Y = yes
  • - = not applicable
• 4th character: Specifies whether the publisher is a signed party to the IAB Limited Service Provider Agreement (LSPA). The publisher specifies whether the transaction is either a Covered Opt Out Transaction or a Non Opt Out Transaction.
  • N = no
  • Y = yes
  • - = not applicable

For example, a string passed as 1--- specifies that a US privacy regulation does not apply to the bid request.

Note: When a consumer chooses to opt-out of the sale of their personal information, the following bid request fields are automatically adjusted:

• ip (device object): The last octet of the user’s IP address is replaced with a zero.
• lat and lon (geo object): Latitude and longitude coordinates are reduced to two decimals which translates to accuracy no less than one third of a mile.
• All unique IDs from the bid request in the device and user objects that indirectly identify a user are removed.
• deals (PMP object): Audience segment targeted deal IDs are no longer added to the bid request.

id

String; required

A unique identifier for this impression.

tagid

String; optional

A unique identifier for the ad placement or ad tag on a publisher's website that was used to initiate the auction. DSPs can use this detailed breakdown of publisher inventory specifying where the ad is located on a web page to optimize and troubleshoot buyer campaigns.

Note: tagid only applies to server-to-server and Google Open Bidding integrations. If the request specifies the tagid, Index will pass the same tagid to DSPs. If no tagid is specified, Index will pass its own site ID instead.

banner

Object; required

The Banner Object.

Note: All requests must include at least one Banner Object or Video Object.

secure

Integer; required

Specifies whether impressions require secure HTTPS URL creative assets and markup, where:

• 0 = secure assets are not required
• 1 = secure assets and markup are required

video

Object; required

The Video object.

Note: All requests must include at least one Video object or Banner object.

Note: The native object is currently in Beta testing. For more information on how Index supports native ads, contact your Index Representative.

bidfloor

Float; optional

The minimum bid for this impression in CPM.

For more information about the bidfloor value that is sent to DSPs, see How Market Price helps you receive more competitive bids from Index.

bidfloorcur

The currency for the bid floor. Currencies must be specified in the ISO-4217 standard and must be supported by Index. For more information, see List of supported currencies.

ext

Object; optional

instl

Integer; optional

Specifies whether an ad is interstitial, where:

• 0 = ad is not interstitial
• 1 = ad is interstitial or full screen

metric

Object; optional

The Metric object that contains more information about any metrics associated with this impression.

rwdd

Integer; optional

Indicates if this impression is associated with a rewarded placement, where:

• 0 = ad is not a rewarded placement
• 1 = ad is a rewarded placement

pmp

Object; optional

bcrid

Array of Strings; required

DSP Creative IDs that are blocked because they are pending review or have been blocked by Index and are therefore excluded from participating in an auction.

Note:

• The number of Creative IDs that display is configurable per DSP.
• This field is temporarily unavailable while we make some optimization improvements.

floor

Array of Integers; optional

An array of bid floor values, in cents.

Note: The array index identifies the bid floor of a seat with corresponding index in the wseat field of the Bid Request Object.

hb

Integer; optional

Specifies whether to use Header Tag inventory bid requests, where:

• 0 = traditional ad tag request
• 1 = header tag ad request

Note: This is not included by default and DSPs must request it.

wopv

String; optional

The HUMAN, Inc. (Human; formally White Ops) lookupID. The lookupID present in the bid request indicates that MediaGuard has scanned the ad request and determined that it is not fraudulent. For more information about Invalid Traffic (IVT) monitoring, see Supply quality guidelines.

skadn

Object; optional

Specifies publisher support for Apple's SKAdNetwork app install attribution. See SKAdNetwork extension object below.

String; required

The type of metric being presented. Index supports the following metric types: 

• click_through_rate

• session_depth

• video_completion_rate

• viewability

value

Float; required

A number representing the value of the metric. Probabilities must be in the range of 0.0 - 1.0.

vendor

String; optional

The source of the value using exchange curated string names. At the moment, only exchange-generated metrics are supported, so this value will always be "EXCHANGE". We may add support for vendor-specific metrics in the future.

format

Array of Objects; optional

Array of format objects specifying the banner sizes permitted for an impression opportunity.

Note: Not enabled for all partners by default. To enable the format object, contact your Index Representative.

Note: Partners who are enabled to receive the format object must include the w and h values in the bid object of the bid response.

Note: For partners that do not support the format object, Index by default includes the maximum size supported by you in the bid request.

h

Integer; required

The height of this impression, in pixels.

topframe

Boolean; required

Specifies whether the banner ad is delivered in the top frame or in an iFrame, where:

• 0 = ad is displayed in an iframe
• 1 = ad will not be displayed in an iframe

Note: Expandable ads must meet our expansion requirements.

w

Integer; required

The width of this impression, in pixels.

battr

Array; optional

Indicates blocked creative attributes; if blank, it is assumed that all types are allowed. Refer to the OpenRTB API Specification Version 2.5 for a full list of values.

btype

Integer; optional

The list of blocked creative types, where:

• 1 = XHTML text ad
• 2 = XHTML banner ad
• 3 = JavaScript ad
• 4 = iframe

If left blank, Index assumes that all types are allowed.

expdir

Array of Integers; optional

Indicates expandable ad directions, where:

• 1 = left
• 2 = right
• 3 = up
• 4 = down
• 5 = full screen

api

Array of Integers; optional

Specifies the supported API frameworks, where:

• 1 = VPAID 1.0
• 2 = VPAID 2.0
• 3 = MRAID 1.0
• 4 = ORMMA
• 5 = MRAID 2.0
• 6 = MRAID 3.0
• 7 = OMID 1.0

By default, custom APIs are assumed as unsupported.

hmax

String; optional

The maximum height of the impression in pixels. If included, it specifies that a range of sizes is allowed with this maximum height and h is considered to be the recommended size. If it is not included, h is considered an exact requirement.

hmin

String; optional

The minimum height of the impression in pixels. If included, it specifies that a range of sizes is allowed with this minimum height and h is considered as the recommended size. If not included, h is considered an exact requirement.

id

String; optional

A unique identifier for this banner object; especially useful for tracking multiple Banner Objects (for example, in companion banner array). It usually begins with 1 and increases with each object.

mimes

Array of Strings; optional

Whitelist of content MIME types supported. Popular MIME types include, but are not limited toimage/jpg and image/gif.

pos

Integer; optional

Specifies the position of the ad as a relative measure of visibility or prominence where:

• 0 = unknown
• 1 = above the fold (default)
• 2 = deprecated (resolution dependent)
• 3 = below the fold
• 4 = header
• 5 = footer
• 6 = sidebar
• 7 = full-screen

wmax

Integer; optional

The maximum width of the impression in pixels. If included, it specifies that a range of sizes is allowed with this maximum width and w is considered to be the recommended size. If not included, w is considered an exact requirement.

wmin

Integer; optional

The minimum width of the impression in pixels. If included, it specifies that a range of sizes is allowed with this minimum width and w is considered as the recommended size. If not included, w is considered an exact requirement.

maxduration

Integer; required

Maximum video ad duration, in seconds.

minduration

Integer; required

Minimum video ad duration, in seconds.

mimes

Array of Strings; required

A list of supported video content MIME types. Popular MIME types supported by HTML5 players include:

• video/mp4
• video/webm
• video/ogg

For VPAID support, make sure to specify application/javascript.

protocols

Array of Integers; required

An array of supported video protocols. At least one supported protocol must be specified, where:

• 2 = VAST 2.0
• 3 = VAST 3.0
• 5 = VAST 2.0 Wrapper
• 6 = Vast 3.0 Wrapper

api

Array of Integers; optional

A list of supported API frameworks, where:

• 1 = VPAID 1.0
• 2 = VPAID 2.0
• 3 = MRAID 1.0
• 4 = ORMMA
• 5 = MRAID 2.0
• 6 = MRAID 3.0
• 7 = OMID 1.0

By default, custom APIs are assumed to be unsupported.

boxingallowed

Integer; optional

Specifies whether letter-boxing of 4:3 content into a 16:9 window is allowed, where:

• 0 = boxing is not allowed
• 1 = boxing is allowed (default setting)

battr

Array; optional

Specifies blocked creative attributes. If blank, it is assumed that all types are allowed.

companionad

Array of Objects; optional

Available companion ads are listed as an array of Banner Objects.

companiontype

Array of Integers; optional

A list of supported VAST companion ad types, where:

• 1 = static resource
• 2 = HTML resource
• 3 = iframe resource

delivery

Array of Integers; optional

A list of supported delivery methods. If blank, it is assumed that all are supported, where:

• 1 = streaming
• 2 = progressive

ext

Object; optional

A custom Index Video Extension Object that contains additional information about this impression.

h

Integer; optional

The height of the player, in pixels.

linearity

Integer; optional

Specifies whether the ad impression is linear or non-linear. If the field is blank, the ad impression can be of any type, where:

• 1 = linear/in stream
• 2 = non-linear/overlay

maxextended

The maximum extended ad duration if extension is allowed, where:

• If blank or 0 = extension is not allowed
• -1 = an extension is allowed and there is no time limit imposed
• If greater than 0 = the value represents the number of seconds of extended play supported beyond the maxduration value.

maxbitrate

Integer; optional

The maximum bit rate in Kbps.

minbitrate

Integer; optional

The minimum bit rate in Kbps.

placement

Integer; optional

The video's placement type, where:

• 1 = in stream
• 2 = in-banner
• 3 = in-article
• 4 = in-feed
• 5 = interstitial/slider/sloating

For more information, see Table 5.9 in the OpenRTB API Specification Version 2.5.

skip

Integer; optional

Specifies whether the player allows the video to be skipped, where:

• 0 = no
• 1 = yes

skipmin

Integer; optional

Videos of total duration greater than this number of seconds

can be skippable; only applicable if the ad is skippable.

skipafter

Integer; optional

Number of seconds a video must play before skipping is

enabled; only applicable if the ad is skippable.

playbackmethod

A list of allowed playback methods, where:

• 1 = auto-play sound on
• 2 = auto-play sound off
• 3 = click-to-play
• 4 = mouse-over

If blank, Index assumes that all methods are allowed.

pos

Integer; optional

Specifies the position of the ad as a relative measure of visibility or prominence, where:

• 0 = unknown
• 1 = above the fold (default)
• 2 = deprecated (resolution dependent)
• 3 = below the fold
• 4 = header
• 5 = footer
• 6 is sidebar
• 7 is full-screen

sequence

Integer; optional

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

startdelay

Integer; optional

Specifies the start delay in seconds for pre-roll, mid-roll, or post-roll ad placement, where:

• >0 = mid-roll (value indicates start delay in second)
• 0 = pre-roll
• -1 = generic mid-roll
• -2 = generic post-roll

w

Integer; optional

The width of the player, in pixels.

playertype

Integer; optional

Specifies the player type associated with this out-stream video impression, where:

• 1 = in news feed
• 2 = in article

If blank, the player is assumed to be a conventional in-steam type.

rewarded

Integer; optional

Specifies whether the ad is being rendered as a part of a rewarded video ad experience, where:

• 0 = false
• 1 = true

request

String; required

The request payload complying with the OpenRTB Dynamic Native Ads API Specification Version 1.2. For more information about the native.request object, see List of supported OpenRTB bid request fields for native ads for DSPs (Beta) .

ver

String; optional

The version of the native markup in use.

api

Integer array; optional

The list of supported API frameworks for the impression. If an API is not listed, assume it is not supported.

battr

Integer array; optional

The blocked creative attributes. To learn more, see the List of creative attributes.

h

integer; optional

The height in device-independent pixels.

w

integer; optional

The width in device-independent pixels.

private_auction

Integer; optional

The scope of DSP bidding eligibility for this impression, where:

1 is Private (eligible bids are restricted to the deals specified).

deals

Array of Objects; optional

A collection of Direct Deals Objects containing any direct deals eligible for this impression.

ext

Object; optional

A custom Index PMP Extension Object that contains additional information about this deal.

id

String; required

A unique identifier for this direct deal.

at

Integer; optional

The auction type for this direct deal, where:

• 1 = first price auction
• 3 = fixed price auction

Note: The second price auction type is deprecated and no longer supported.

bidfloor

Integer (if sent as cents, like 134) or Float (if sent as dollars, like 1.34); optional

Designated floor price for this direct deal, in US (sent in cents, by default).

For more information about the bidfloor value that is sent to DSPs, see How Market Price helps you receive more competitive bids from Index.

Note: It can be sent in dollars if requested, but the price in the response Bid Object must also be sent in dollars.

bidfloorcur

The currency for the bid floor. Currencies must be specified in the ISO-4217 standard and must be supported by Index. For more information, see List of supported currencies.

wseat

String; optional

A whitelist of buyer seats (for example, advertisers, agencies) that are allowed to bid on a deal.

name

String; optional

Placement name for all impressions operating in the private market. Example: "The Daily Times".

disc

Float

A number between 0.01 - 1.0 representing the discount negotiated between a publisher and buyer. This value is applied to the ${AUCTION_PRICE} win notification macro for winning impressions. Index supports one value past the decimal point on discounts (for example, 15.5%).

Example: A 25% discount is sent as disc = 0.25. For a $10.00 winning bid, the 25% discount is applied and passed as $7.50 in the ${AUCTION_PRICE} macro.

To learn more about discounts for deals, see Negotiating discounts on deals.

version

String; optional

The version of skadnetwork supported. This field is always "2.0" or higher and is dependent on both the OS version and the SDK version.

Note: With the release of SKAdNetwork 2.1, this field is deprecated in favor of the versions field to support an array of version numbers.

versions

String array; optional

An array of strings containing the supported skadnetwork versions. This field is always "2.0" or higher and is dependent on both the OS version and the SDK version.

Example: "versions": ["2.0", "2.1", "2.2"]

sourceapp

String; optional

The ID of the publisher app in Apple’s app store. It should match the app.bundle in OpenRTB 2.x and app.storeid in AdCOM 1.x.

Example: "sourceapp": "880047117"

skadnetids

String array; optional

max

Integer; optional

A list containing the max entry ID of SKAdNetwork ID.
Example: "max":306.

excl

Integer array; optional

A comma separated list of IAB registration IDs that are to be excluded from the IAB shared list.

Example: "excl": [44,14,18]

addl

String array; optional

A comma separated list of string SKAdNetwork IDs, expressed as lowercase strings, not included in the IAB shared list. It is recommended that this list should not exceed 10 IDs.
Example: "addl": ["cdkw7geqsh.skadnetwork", "qyjfv329m4.skadnetwork"]

id

String; required

The Index-assigned unique identifier for the website.

cat

Array of Strings; optional

A single-element array representing the standard IAB content category for the overall site. For example, ["IAB3-7"] See section 6.1 of the OpenRTB Specification (version 2.2) for a full list.

content

Object; optional

The Content Object. For more information about the content object, see the content object below.

domain

String; optional

A static value that represents the site’s domain.

mobile

Integer; optional

Specifies whether the site has been programmed to optimize layout when viewed on mobile devices, where:

• 0 = no
• 1 = yes

page

String; optional

The URL of the page where this impression will be shown.

producer

Object; optional

Provides details about the producer of the content. For more information about the producer object, see the producer object below.

publisher

Object; optional

The Publisher Object.

ref

String; optional

The referring URL that caused navigation to the page hosting this impression. Anything above 512 characters is truncated.

id

String; required

The Index-assigned unique numeric identifier for this app.

bundle

String; optional

The App name or bundle (for example, "com.foo.mygame"), used as a unique identifier across exchanges.

cat

Array of Strings; optional

The standard IAB content category for the overall site (for example, ["IAB3-7"]). Refer to the OpenRTB Specification (version 2.5) for a complete list.

content

Object; optional

Details about content within the app. For more information about the content object, see the content object below.

domain

Optional

A static value representing the domain of the app.

keywords

String; optional

A comma-separated list of keywords related to the app. Maximum of 255 characters.

name

String; optional

The name of the app. It may be masked if requested by the publisher.

paid

Integer; optional

Specifies whether the app is a paid or free version, where:

• 0 = app is free
• 1 = app is a paid version

privacypolicy

Integer; optional

Specifies whether the app has a privacy policy, where:

• 0 = no
• 1 = yes

producer

Object; optional

Provides details about the producer of the content. For more information about the producer object, see the producer object below.

publisher

Object; optional

The Publisher Object.

storeurl

String; optional

The App store URL for an installed app for QAG 1.5 compliance.

ver

String; optional

The application version.

ext

object; optional

The App extension object, which is used to provide more information about the app impression opportunity.

inventorypartnerdomain

A pointer to the domain of a partner that is explicitly authorized to monetize ads within this application's content. The partner's corresponding appads.txt or ads.txt file will be hosted at this domain and can be used for supply chain validation.

For more information about how to implement this field, see the IAB's ads.txt Specification.

album

String; optional

The album to which the content belongs, typically for audio.

artist

String; optional

The artist who is credited with the content.

cat

String array; optional

A single-element array representing the standard IAB content category for the overall site. For example, ["IAB3-7"]. The full list is available in section 5.1 of the OpenRTB 2.5 Specification.

contentrating

String; optional

The content's rating (for example, MPAA).

context

Integer; optional

Refers to the type of content, where:

• 1 = video (video file or internet TV broadcast)

• 2 = game (interactive software game)

• 3 = music (audio file or internet radio broadcast)

• 4 = application (interactive software application)

• 5 = text (web page, eBook, news article)

• 6 = other

• 7 = unknown

data

Object array; optional

Provides additional content data.

embeddable

Integer; optional

Indicator of whether or not the content is embeddable, where:

• 0 = no

• 1 = yes

episode

String; optional

Episode number that applies to video content.

ext

Object; optional

A placeholder for Index-specific extensions to the content object. See the Content extension object table below.

genre

String; optional

The genre that best describes the content. For example, rock, pop, etc.

id

String; optional

ID that uniquely identifies the content.

isrc

String; optional

International Standard Recording Code conforming to ISO-3901.

keywords

String; optional

A comma separated list of keywords describing the content.

language

String; optional

The first two characters of the language, in uppercase, as per ISO-639-1-alpha-2. For example, "EN".

len

Integer; optional

Used for video and audio, and specifies the length of the content in seconds.

livestream

Integer; optional

Specifies if the content is live (for example, a stream or live blog), where:

• 0 = not live

• 1 = content is live

prodq

Integer; optional

Refers to the production quality, where:

• 0 = unknown

• 1 = professionally produced

• 2 = prosumer

• 3 = user generated content (UGC)

producer

Object; optional

Details about the content producer. For more information, see producer object table below.

qagmediarating

Integer; optional

The media rating as per Quality Assurance Guidelines (QAG), where:

• 1 = all audiences

• 2 = everyone over 12

• 3 = mature audiences

season

String; optional

The season of the content (for example, "Season 3").

series

String; optional

Content series.

sourcerelationship

Integer; optional

Specifies the relationship to the source, where:

• 0 = indirect

• 1 = direct

title

String; optional

The title of the content.

url

String; optional

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

userrating

String; optional

How users have rated the content. For example, number of stars, number of likes.

videoquality

Integer; optional

Refers to the video quality.

channel

The specific channel that the content is playing on.

content_channel

The specific channel that the content is playing on.

network

String; optional

The parent content network that contains several channels.

content_network

String; optional

The parent content network that contains several channels.

distrib_name

String; optional

The alternate name under which the publisher distributes the content.

cat

String array; optional

A single-element array representing the standard IAB content category for the overall site. For example, ["IAB3-7"]. The full list is available in section 5.1 of the OpenRTB 2.5 Specification.

domain

String; optional

The highest level domain of the content producer. For example, "producer.com".

ext

Object; optional

A placeholder for Index-specific extensions to the producer object.

id

String; optional

An ID that represents the content producer or originator. This field is useful if the content is syndicated and posted on a site using embed tags.

name

String; optional

The name of the content producer or originator. For example, "Warner Bros".

id

String; required

The Index-specific publisher ID.

name

String; optional

A name that represents the publisher that can be masked if requested.

Note: This field is always present when a deal exists.

carrier

String; optional

The carrier or ISP. For example, “VERIZON”.“WIFI” is often used in mobile to indicate high bandwidth (for example, video friendly vs. cellular).

devicetype

Integer; optional

The device type in use for this impression, if available, where:

• 1 = mobile or tablet
• 2 = personal computer
• 3 = connected TV
• 4 = phone
• 5 = tablet
• 6 is connected device
• 7 is set-top box

didmd5

String; optional

didsha1

String; optional

dpidmd5

String; optional

dpidsha1

String; optional

geo

Object; optional

h

The physical height of the device screen, in pixels.

Note: Only supported in OpenRTB 2.3.

hwv

String; optional

Represents the hardware version of the device. For example, "5S" represents an iPhone 5S.

Note: Only supported in OpenRTB 2.3.

connectiontype

Integer; optional

The network connection type that the device uses, where:

• 0 = unknown

• 1 = ethernet

• 2 = WiFi

• 3 = cellular network - unknown generation

• 4 = cellular network - 2G

• 5 = cellular network - 3G

• 6 = cellular network - 4G

ifa

String; optional

ip

String; optional

A dotted-octet representation of the IPv4 address of the user.

Note: This field is required if the bid request does not contain the ipv6 field. See the ipv6 field below.

ipv6

String; optional

The IP address closest to the device, specified in IPv6 format (for example, "fe80:0:0:0:200:f8ff:fe21:67cf"). Index only sends bid requests for IPv6 traffic if you're able to support it. Contact your Index Representative if you want to start receiving IPv6 requests.

Note: Index always sends one of either device.ip or device.ipv6 in all bid requests.

language

String; optional

lmt

Integer; optional

Specifies the scope of tracking related to this impression. This signal represents a commercially adopted version (endorsed by iOS and Android) of standard do-not-track functionality, where:

• 0 = tracking is unrestricted
• 1 = tracking must be limited per commercial guidelines

Note: Only supported in OpenRTB 2.3.

macmd5

String; optional

macsha1

String; optional

make

String; optional

model

String; optional

os

String; optional

osv

String; optional

ppi

Integer; optional

The pixels per linear inch.

Note: Only supported in OpenRTB 2.3.

pxratio

Float; optional

The ratio of physical pixels to device-independent pixel.

Note: Only supported in OpenRTB 2.3.

ua

String; optional

The content of the HTTP_USER_AGENT header for this user. Anything above 512 characters is truncated.

w

Integer; optional

The physical width of the device screen, in pixels.

Note: Only supported in OpenRTB 2.3.

ext

Integer; optional

A placeholder for Index specific extensions to the device object. See Device extension object below.

ifv

String; optional

The IDFV of the device with the publisher.

atts

Integer; optional

An iOS only field that is passed to represent the app's app tracking authorization status, where:

• 0 = not determined

• 1 = restricted

• 2 = denied

• 3 = authorized

ifa_type

A value indicating the source of the IFA value, whether it is device-generated, provided by the publisher, or is a temporary session IFA. The supported values are:

• dpid = The generic device provided ID.

• rida = The Roku ID.

• aaid = The Android ID.

• idfa = The Apple ID.

• afai = The Amazon Fire ID.

• msai = The Microsoft ID.

• tifa = The Samsung Tizen ID.

• vida = The Vizio ID.

• ppid = The publisher provided ID.

• sspid = The SSP provided ID.

• sessionid = A temporary IFA ID. For example, publishers or SSPs might generate a temporary IFA in the absence of an IFA from the publisher or device, so that tasks like frequency capping can be supported. This value is also used in place of the device's IFA if the user has opted out of ad tracking (device.lmt=1).

For more information about ifa_type, see IAB Tech Lab's Guidelines for Identifier for Advertising (IFA) on CTV/OTT platforms.

city

String; optional

The city, as per United Nations Code for Trade & Transport Locations. See UN/LOCODE Code List.

country

String; optional

The country code, using ISO-3166-1-alpha-3.

lat

Float; optional

The latitude from -90.0 to +90.0, where negative is south.

lon

Float; optional

The longitude from -180.0 to +180.0, where negative is west.

metro

String; optional

The Google metro code; similar to but not exactly Nielsen DMAs. See List of Google Metro Codes.

region

String; optional

regionfips104

String; optional

The region of a country using FIPS 10-4 notation. While OpenRTB supports this field, it has been withdrawn by NIST in 2008.

type

Integer; optional

The source of location data; recommended when passing lat and lon. See List of location types.

zip

String; optional

The zip code or postal code.

utcoffset

Integer; optional

The local time as the number +/- of minutes from UTC.

Note: Only supported in OpenRTB 2.3.

buyeruid

String; optional

A DSP's UID for this user (see user matching for format).

Note: This field is always present in default user match configuration.

data

Array of objects; optional

This object is used by publishers to pass additional attributes about the user or content. See the Data object.

ext

Object; optional

The User extension object, which is used to indicate requests that contain certain user identifiers and are subject to GDPR regulations.

id

String; optional

The Index static identifier for this user (contains only alphanumeric or the following characters: @ - . _ ).

Note: This field is always present in default user match configuration.

consent

String; optional

Specifies user consent when GDPR regulations are in effect. When present, it contains the data structure developed by the GDPR Consent Working Group. For more information, refer to the OpenRTB GDPR Advisory, published by the IAB.

eids

Array of objects; optional

An array of EIDs Objects, used to communicate email IDs for this user.

gdpr

Integer; optional

Specifies whether the request is subject to regulations, where:

• 1 = request is subject to regulations
• 0 = request is not subject to regulations

If this field is omitted, Index assumes that the request's status is unknown. For more information, refer to the OpenRTB GDPR Advisory, published by the IAB.

source

String; optional

The source of the IDs. For example, "adserver.org".

uids

Array of objects; optional

An array of UID object.

id

String; optional

The user ID received in the request.

ext

Object; optional

The EID extension Object.

rtipartner

String; optional

The name of the Universal ID provider. For example, "tradedesk".

id

String; optional

The user ID. For example, "uid123".

ext

Object; optional

The UID extension object.

rtipartner

String; optional

The name of the Universal ID provider. For example, "appnexus".

ext

Object; optional

The data extension object that contains community extensions. See the Data extension object.

segment

Array of objects; optional

Contains additional information about the related objrct that is specified, such as the user, site, or app object. See the Segment object.

segtax

Integer; optional

The ID associated with a taxonomy that is registered centrally with the IAB Tech Lab.

id

String; optional

The ID that is associated with this data segment and is specific to the data provider.