Data dictionary

a_domain

Dimension, string

Yes

No

No

Advertiser domain Advertiser domain (adomain). An identifier for a brand or advertiser, as provided in an OpenRTB bid response. passed to Index from DSPs.

Note: The data in this field may be anonymized in some bid event log types, in which case the value will be XXXXX.

ad_server_win_rate

Measure, decimal

No

Yes

Yes

Rate of impressions served from the number of bids that were sent to the ad server A platform that manages, stores, and delivers advertisements to a publisher's site..

Calculation: impressions / bid_chosen

ad_spend

Measure, decimal

No

Yes

Yes

Gross revenue for the publisher The owner of a website or app where advertisements are served. before share.

advertiser

Dimension, string

No

Yes

Yes

The deal A private auction that allows publishers to offer specific inventory directly to selected buyers identified by a deal ID. Terms are negotiated and are agreed upon before the auction occurs. reporting label containing the name of the advertiser associated with the deal. The possible values are:

• A string with a 255-character limit.

• no_label = This deal reporting label contains no data, but at least one other deal reporting label contains data.

• Empty field = This field is empty because there is no data available for any deal reporting label.

Note: This field is only available for Marketplace Partners .

agency

Dimension, string

No

Yes

Yes

The deal reporting label containing the name of the agency associated with the deal. The possible values are:

• A string with a 255-character limit.

• no_label = This deal reporting label contains no data, but at least one other deal reporting label contains data.

• Empty field = This field is empty because there is no data available for any deal reporting label.

Note: This field is only available for Marketplace Partners .

app_bundle

Dimension, string

Yes

Yes

Yes

A platform-specific mobile application ID. Applicable when the inventory_channel is In-App.

Note: This field is only available for Marketplace Partners, DSPs and publishers.

auction_id

String

Yes

No

No

Unique identifier of the associated auction.

Note: The data in this field may be anonymized in some bid event log types, in which case the value will be XXXXX.

auction_type

Dimension, string

No

Yes

No

The type of auction that was conducted. Either first price An auction where the highest bid wins, and the winner pays the highest bid amount in full. or fixed price For specific deals, a fixed price can be negotiated between a publisher and a buyer. If the advertisers bid at this fixed price or above, their bid responses are eligible to compete in the auction, and, if they win the auction, they only pay the fixed price regardless of what their bid amount was. auction.

average_competing_bid_price

Measure, decimal

No

Yes

Yes

The average price of all competing bids received. Competing bids include both bid_chosen and bid_eligible bids.

Note: This field is only available for buyers.

average_measured_viewability

Measure, decimal

No

Yes

Yes

The average measured viewability A measure of how often an impression is actually seen by a user. For example, an ad that is served at the bottom of a page that requires a user to scroll to see it will likely have a lower viewability score than an ad that loads at the top of a page.. For dimensions selected, average_measured_viewability = total_viewable_impressions / total_measured_impressions.

Note: This metric is only available for publishers and Marketplace Owners Also known as a Marketplace Partner. This term is used in reporting metrics to represent the owner of an Index Marketplace that curates their media solutions within the Index Marketplace and packages these offerings to bring incremental demand to publishers. For example, a media agency, a data provider, or retail media network., and only on or after July 1, 2022.

For more information about what viewability is and how we measure it, see What is viewability?

bid_below_floor

Measure, long

No

Yes

Yes

Count of bid responses received that were below the floor A pricing control used by publishers and exchanges to set a minimum sale price on inventory. price set for the auction.

bid_below_floor_opportunity

Measure, decimal

No

Yes

Yes

Sum of bid prices from bid_below_floor events.

bid_below_floor_seconds

Measure, long

No

Yes

Yes

The total ad pod duration from bid_below_floor events, in seconds.

Note: This field is only available for Marketplace Partners and publishers.

bid_blocked

Measure, long

No

Yes

Yes

Count of bid requests that were blocked because of the publisher's creative A digital ad made available in various creative types, defined by their size in pixels such as 300x250px. settings.

bid_blocked_opportunity

Measure, decimal

No

Yes

Yes

Sum of bid prices from bid_blocked events.

bid_blocked_seconds

Measure, long

No

Yes

Yes

The total ad pod duration from bid_blocked events, in seconds.

Note: This field is only available for Marketplace Partners and publishers.

bid_chosen

Measure, long

No

Yes

Yes

Count of bids in a given auction that were submitted to the ad server as candidates to potentially win an impression.

The bid_chosen and bid_eligible responses are mutually exclusive.

bid_chosen_opportunity

Measure, decimal

No

Yes

Yes

Sum of CPM Cost Per Thousand (CPM). A pricing structure for buying impressions and is the cost of serving an advertisement 1,000 times. Also known as Cost Per Mille (where M represents 1,000 in Roman numerals) or Cents Per Mille. bid prices from bid_chosen events.

bid_chosen_seconds

Measure, long

No

Yes

Yes

The total ad pod duration in dynamic ad pod bid responses that were submitted to the ad server as candidates to potentially win one or more impressions, in seconds.

Note: This field is only available for Marketplace Partners and publishers.

bid_eligible

Measure, long

No

Yes

Yes

Count of bid responses that had no blocks and were eligible to compete in the auction. Unlike bid_chosen responses, eligible bids were not the highest bid of a given auction, and were therefore not sent to the ad server.

bid_eligible_opportunity

Measure, decimal

No

Yes

Yes

Sum of bid prices from bid_eligible events.

bid_eligible_seconds

Measure, long

No

Yes

Yes

The total ad pod duration in dynamic ad pod bid responses that had no blocks and were eligible to compete in the auction, in seconds.

Note: This field is only available for Marketplace Partners and publishers.

bid_error

Measure, long

No

Yes

Yes

Count of times Index received a response containing an error from the bidder.

Note: This field is only available for Marketplace Partners, publishers and DSPs.

bid_in_review

Measure, long

No

Yes

Yes

Count of times a bid response An OpenRTB response that is sent by the DSP in response to the SSP's or ad exchange's bid request. It is an event directed back to the seller expressing a valuation for the request and conditions of sale. was received that contained a campaign A collection of multiple ads in different formats. that is currently waiting to be reviewed or audited.

bid_in_review_opportunity

Measure, decimal

No

Yes

Yes

Sum of bid prices from bid_in_review events.

bid_in_review_seconds

Measure, long

No

Yes

Yes

The total ad pod duration from bid_in_review events, in seconds.

Note: This field is only available for Marketplace Partners and publishers.

bid_pass

Measure, long

No

Yes

Yes

Count of times a bidder passed on a bid request An OpenRTB request that is sent from a supply-side platform (SSP) or ad exchange to the DSP requesting a bid response for potential impressions. A bid request contains information about the impression that allows the DSP to decide whether to bid on the impression.. It's populated when there is a "no bid" response from a downstream partner.

Note: This field is only available for Marketplace Partners, publishers and DSPs.

bid_request

Measure, long

No

Yes

Yes

Count of OpenRTB An open industry standard for communication between buyers and sellers of online advertising in real-time bidding auctions. It's published by the IAB. bid requests sent to a downstream partner (DSP Demand-Side Platform (DSP). A software platform that automates bidding decisions in real-time and efficiently connects buyers and audiences through an ad exchange or SSP. Also known as a buy-side platform. or bidder) requesting a response for potential impressions.

Note: This field is only available for Marketplace Partners, publishers and DSPs.

bid_stage

String

Yes

No

No

Information about why a bid response event did not contain a bid, such as a bid error or blocked bid. The possible values are:

rejected_campaign = The campaign was blocked because it does not meet our ad quality guidelines.

invalid_dealid = The deal ID included in the bid response was either invalid or missing.

blocked_by_publisher = The bid response contained something that was blocked by the publisher.

blocked_brand = The bid response contained a brand that has been blocked by the publisher.

exclusive_brand = The bid response contained a brand that has been excluded by the publisher.

response_validation = The bid response failed our validation checks.

http_error = There was an error with the bid response HTTP headers

bid_below_onecent = The bid was excluded because it was too low (below one cent).

response_too_large = The bid response size exceeded our maximum allowed size.

response_validation_video = The bid response failed our video validation checks.

internal_error = The bid response wasn't processed due to an Index error.

invalid_encryption = The decryption method specified in the bid response was not valid.

Note: This field is only available for log files associated with bid event types.

bid_timeout

Measure, long

No

Yes

Yes

Count of times a bid response was not received during the designated timeout window. It's populated when Index can determine that a partner timed out.

Note: This field is only available for Marketplace Partners, publishers and DSPs.

billing_term_id

Dimension, Integer

Yes

No

No

The unique identifier for the billing_term that was applied on the impression.

Current functionality:

• An ID of 0 indicates that the publisher's standard rate was applied. This may change over time as we build out more transaction features.
• An ID greater than 0 indicates that an Exchange Fee Reduction (XFR) was applied, which you'll see reflected in the pub_rev_share field.

Future functionality may include additional transaction features. In this case, we may add publisher rates or potentially capture all rate types. Please keep this in mind when you are designing your reporting framework.

Note: This field is only available for log files associated with impression event types.

brand_id

Integer, long

Yes

Yes

No

Index identifier for a brand ID that maps to the brand_name.

Note: For CAL, the data in this field may be anonymized in some bid event log types, in which case the value will be -1.

brand_name

Dimension, string

Yes

Yes

Yes

The product or service being advertised.

browser

Dimension, string

Yes

Yes

Yes

The name of the browser associated with this impression. The possible values for reports containing data before March 1, 2022 are:

• CHRM

• EDGE

• FIRE

• IEXP

• OPER

• SAFA 

• IAPP 

• unknown

• NETS

• other

The name of browser associated with this impression. The possible values for reports containing data after March 1, 2022 are:

• Chrome

• Edge

• Firefox

• Internet Explorer

• Opera

• Opera Mobile

• Safari

• unknown

• other

• MIUI Browser

• HeyTap Browser

• Samsung Browser

• Steam

• VivoBrowser

• Amazon Silk

• Yandex.Browser

• webOS Browser

• Android Browser

• Chrome Mobile

• HuaweiBrowser

• LG WebOS

• MacOS

Note: This field is only available for Marketplace Partners, publishers and DSPs.

buyer_name

Dimension, string

No

Yes

Yes

The name of the buyer or agency associated with the bid.

buyer_seat_id

Dimension, string

No

Yes

Yes

The ID of the buyer or agency associated with the bid.

Note: This field is only available for buyers and DSPs.

buyer_total_bid_opportunity

Measure, integer

No

Yes

Yes

Sum of all bid opportunities available.

Calculation: bid_below_floor_opportunity + bid_blocked_opportunity + bid_chosen_opportunity + bid_eligible_opportunity + bid_in_review_opportunity

Note: This field is only available for buyers.

buyer_total_bids

Measure, integer

No

Yes

Yes

The total number of bids, regardless of whether they were candidates to compete in an auction.

Calculation: bid_in_review + bid_blocked + bid_eligible + bid_chosen + bid_below_floor + bid_error

Note: This field is only available for buyers.

buyer_volume_incentives_applied

Dimension, string

Yes

Yes

Yes

Specifies whether the transaction was involved in the Buyer Volume Incentives program. The value is yes if the program was applied to the transaction, and no if it was not applied. To learn more about Buyer Volume Incentives, see Applying discounts for buyers.

Note: This field is only available for publishers and buyers.

buyer_volume_incentives_
savings_amount

Measure, decimal

Yes

Yes

Yes

The savings amount the buyer realizes by participating in the Buyer Volume Incentives program. To learn more about Buyer Volume Incentives, see Applying discounts for buyers.

Note: If the buyer is not participating in the program, or if other discounts are already applied, the value will be 0.000000. This field is only available for publishers and buyers.

buyer_win_rate

Measure, decimal

No

Yes

Yes

The percentage, as a decimal from 0 to 1, of bids placed by the buyer that lead to impressions being served.

Calculation: buyer_win_rate = impressions / buyer_total_bids

Note: This field is only available for buyers.

campaign_id

Integer

Yes

No

No

Index identifier for a campaign.

Note: The data in this field may be anonymized in some bid event log types, in which case the value will be -1.

campaign_name

String

Yes

No

No

The Index name for the campaign.

clicks

Measure, integer

No

Yes

Yes

The estimated total number of click tracking events for the impression as measured by Index.

click_through_rate

Measure, integer

No

Yes

Yes

The estimated percentage of times that an ad was clicked as measured by Index.

Calculation: clicks / measurable_clicks

For more information about how Index calculates the click-through rate (CTR) CTR measures the percentage of times an ad was clicked., see Targeting click-through rate (CTR) in a deal (Alpha) .

company_name

Dimension, string

No

Yes

No

The name of company set up in the Index system.

Note: This field is only available for publishers and DSPs.

cma_label

Dimension, string

Yes

Yes

Yes

Info: Starting in June 2025, Index is pausing support for the Protected Audience API. As a result, this field will no longer generate new Protected Audience API-specific data. Reporting data for Topics API will remain available.

The CMA (Competition and Markets Authority) label associated with the request. A CMA label is used to identify which Chrome-facilitated testing mode the device sending the request is associated with.

If the request does not include the CMA label:

• omitted = The CMA label was not sent in the request but the impression is considered eligible for the Protected Audience API.

The possible labels for Mode A traffic are:

• control_1.1 = This label is applied to 0.25% of stable traffic

• control_1.2 = This label is applied to 0.25% of stable traffic

• control_1.3 = This label is applied to 0.25% of stable traffic

• control_1.4 = This label is applied to 0.25% of stable traffic

• label_only_1 = This label is applied to 1.5% of stable traffic

• label_only_2 = This label is applied to 1.5% of stable traffic

• label_only_3 = This label is applied to 1.5% of stable traffic

• label_only_4 = This label is applied to 1.5% of stable traffic

• label_only_5 = This label is applied to 1.5% of stable traffic

The possible labels for Mode B traffic are:

• treatment_1.1 = This label is applied to 0.25% of stable traffic

• treatment_1.2 = This label is applied to 0.25% of stable traffic

• treatment_1.3 = This label is applied to 0.25% of stable traffic

• control_2 = This label is applied to 0.25% of stable traffic

For a CSV file that contains the CMA label to Mode mappings, see: CMA label mapping.

For more information on Chrome testing modes, see Google's documentation on Chrome-facilitated testing.

For more information on Index and Privacy Sandbox, see Use Google's Privacy Sandbox APIs with Index.

competing_bids

Measure, decimal

No

Yes

Yes

Total number of bids that were candidates to compete in the auction.

Calculation: bid_eligible + bid_chosen

configured_take_rate

Measure, string

No

Yes

Yes

The Index percentage as a decimal from 0-1 of the transaction amount before accounting for any XFR savings.

Note: This field is only available for buyers when the publisher has opted to share revenue, otherwise the value is omitted.

content_channel

Dimension, string

Yes

Yes

Yes

The TV channel that displayed the video content. For example, MTV , HGTV, and CNN.

Note: This field is only available for publishers.

content_genre

Dimension, string

Yes

No

No

The genre that best describes the video content, as provided by the publisher in the content.genre field of an OpenRTB request. For example, comedy or drama.

Note: This field is only available for publishers.

content_language

Dimension, string

Yes

Yes

Yes

The ISO 639-2 language of the content. For example, en, ss, fy.

Note: This field is only available for publishers.

content_livestream

Dimension, integer

Yes

Yes

Yes

Specifies whether the video ad is livestream. Possible values are: 

• 0 = Video content is not being streamed live

• 1 = Video content is being streamed live

Note: This field is only available for publishers.

content_network

Dimension, string

Yes

Yes

Yes

The network that displayed the video content. For example, Viacom , Discovery, CBS.

Note: This field is only available for publishers.

content_rating

Dimension, integer

Yes

Yes

Yes

The content rating of the video content where the ad was played, as provided by the publisher. The content rating provides guidance about the appropriate audience for the impression.

Note: This field is only available for publishers.

cookie_match_status

String

Yes

No

No

Cookie match status. Possible values are:

• matched = Index has a buyeruid An Index-specific ID for the user that appears in the user object in a bid. Each DSP has a unique buyeruid for each user that allows Index to match DSPs to users. for the corresponding DSP.
• unmatched = Index has no buyeruid for the corresponding DSP.
• attempted = Index has attempted to reach out to the DSP for a buyeruid, but no response has been received.
• expired = the buyeruid has exceeded its expiration time and needs to be re-matched.
• skipped = the DSP has explicitly indicated that Index should not try to obtain a match for this user.

country

Dimension, string

Yes

Yes

Yes

2-character ISO country code of the location of the device.

unknown = unrecognized country.

cpm

Measure, decimal

No

Yes

Yes

The cost per 1000 impressions.

Calculation: (ad_spend) / sum (impressions) * 1000

creative_id

Integer

Yes

No

No

Identifier for the creative.

creative_type

Dimension, string

Yes

Yes

Yes

The type of ad being requested. The possible values for reports containing data before March 1, 2022 are:

• banner
• video
• native
• other

The possible values for reports containing data after March 1, 2022 are:

• banner
• video
• native

custom

Dimension, string

No

Yes

Yes

The deal reporting label containing custom metadata associated with the deal. The possible values are:

• A string with a 255-character limit.

• no_label = This deal reporting label contains no data, but at least one other deal reporting label contains data.

• Empty field = This field is empty because there is no data available for any deal reporting label.

Note: This field is only available for Marketplace Partners .

day

Dimension, timestamp

No

Yes

Yes

Timestamp in UTC (Coordinated Universal Time), rounded to the day.

Note: Publishers can create reports in their local time zone. For more information, see Create a custom report.

dc_location

Dimension, string

No

Yes

No

The location of the data center where the request originated. For example, "Hong Kong".

Note: This field is only available for DSPs.

dc_region

Dimension, string

No

Yes

No

The region of the data center where the request originated. For example, "APAC".

Note: This field is only available for DSPs.

deal_ad_spend

Measure, decimal

No

Yes

Yes

Gross revenue associated with private marketplace activity, transacted on deal_id.

deal_media_spend

Dimension, decimal

No

Yes

Yes

The amount a buyer owes to Index for private market (deal) ad inventory purchased through the exchange.

Note: For publishers, Marketplace data is only available if the Marketplace Owner has opted to share this data.

deal_cpm

Measure, decimal

No

Yes

Yes

The cost per 1000 impressions, specific to a deal.

Calculation: (deal_ad_spend) / (deal_impressions) * 1000

deal_ecpm

Measure, decimal

No

Yes

Yes

The net cost per 1000 impressions, specific to a deal.

Calculation: (deal_publisher_payment) / (deal_impressions) * 1000

Note: This field is only available for publishers.

deal_id

Dimension, string

Yes

Yes

Yes

A unique deal ID string that was created for this deal. Corresponds to the OpenRTB deal_id.

deal_impressions

Measure, long

No

Yes

Yes

Total impressions rendered that transacted on a deal_id.

deal_name

Dimension, string

No

Yes

Yes

The name given to the deal.

deal_publisher_payment

Measure, decimal

No

Yes

Yes

Net revenue in associated with private marketplace activity, transacted on deal_id.

demand_channel

Dimension, string

Yes

Yes

Yes

Specifies the channel that exchange traffic occurred on. The possible values are:

• open = transactions that transacted in the open market.

• deal = deals that transacted as 1:1 deals.

• inventory_package = deals that transacted using Inventory Packages An option that allows buyers to purchase publisher inventory using open auction mechanics, and does not require any negotiation between a buyer and publisher. They offer high quality inventory to buyers at open market rates..

• platform_deal = deals that transacted using Matched Audiences Matched Audiences are IDs where data partners or publishers upload a list of IDs for a particular Universal ID provider and match a deal ID against that audience segment. .

• marketplaces = impressions that transacted in Index Marketplaces

device_type

Dimension, string

Yes

Yes

Yes

The type of device from which the impression originated. The possible values are:

• mobile/tablet = a mobile device or tablet
• personal_computer = a computer or laptop
• connected_tv = a TV that has built in connection to the internet, such as a Smart TV.
• phone = a phone, such as an iPhone
• tablet = a tablet, such as an iPad
• connected_device = a streaming device, or game console, such as a PlayStation
• set_top_box = a type of cable box, such as a Comcast X1 Box

discount_amount

Measure, decimal

Yes

Yes

Yes

The dollar amount that a publisher has discounted the final price of the deal transaction. The percentage discount is set by the publisher on the deal as a spend incentive. Bids with this deal setting compete as normal and the discount set by the publisher is applied upon auction win.

Note: This field is only available for log files associated with impression event types, and is only available when the publisher has opted to share their revenue information.

dma

String

Yes

No

No

The US Designated Market Area (DMA) for the user, in accordance with the DMA regions defined by Nielsen.

domain

Dimension, string

Yes

Yes

Yes

The domain used in the bid request. Returns the top level domain with a public suffix.

For example:

x.adwords.google.co.uk returns google.co.uk, since co.uk is a public suffix.

Similarly, a bid request made from myblog.blogspot.com returns the same domain, myblog.blogspot.com, since blogspot.com is a public suffix.

Note: This dimension does not apply to in-app traffic. n/a = not applicable.

dsp_bid_rate

Measure, decimal

No

Yes

Yes

The rate that Index received responses from the bid requests that Index sent.

Calculation: (bid_in_review + bid_blocked + bid_eligible + bid_chosen + bid_below_floor + bid_error) / bid_requests

Note: This field is only available for Marketplace Partners, publishers and DSPs.

dsp_id

Dimension, integer

Yes

Yes

No

Index DSP identifier.

dsp_id_level_1

Dimension, string

No

Yes

Yes

The deal reporting label containing an identifier returned from a DSP when the deal is synchronized (for example, Order ID).

If an ID is not returned from a DSP when the deal is synchronized, the other possible values are:

• no_label = This deal reporting label contains no data, but at least one other deal reporting label contains data.

• Empty field = This field is empty because there is no data available for any deal reporting label.

Note: This field is only available for Marketplace Partners .

dsp_id_level_2

Dimension, string

No

Yes

Yes

The deal reporting label containing an identifier returned from a DSP when the deal is synchronized (for example, Product ID).

If an ID is not returned from a DSP when the deal is synchronized, the other possible values are:

• no_label = This deal reporting label contains no data, but at least one other deal reporting label contains data.

• Empty field = This field is empty because there is no data available for any deal reporting label.

Note: This field is only available for Marketplace Partners .

dsp_name

Dimension, string

No

Yes

Yes

The DSP that represents multiple trading desks.

dsp_win_rate

Measure, decimal

No

Yes

Yes

Percentage of impressions served from all bids.

Calculation: impressions / total_bids

Note: This field is only available for Marketplace Partners, publishers and DSPs.

dynamic_ad_pod_duration

Dimension, integer

No

Yes

Yes

The available ad pod duration in a single dynamic ad pod impression opportunity.

Note:

• Shown as Ad Pod Duration in Reports in the Index UI .
• This field is only available for Marketplace Partners and publishers.

dynamic_ad_pod_max_sequence

Dimension, integer

No

Yes

Yes

The maximum number of ads that the publisher will choose from those sent by Index for a dynamic ad pod request.

Note:

• Shown as Maximum Ads Chosen in Pod in Reports in the Index UI .
• This field is only available for Marketplace Partners and publishers.

ecpm

Measure, decimal

No

Yes

Yes

The net cost per 1000 impressions.

Calculation: (publisher_payment) / (impressions) * 1000

Note: This field is only available for Marketplace Partners and publishers.

effective_take_rate

Measure, string

No

Yes

Yes

The Index percentage as a decimal from 0-1 of the transaction amount after accounting for any XFR savings.

Note: This field is only available for buyers when the publisher has opted to share revenue, otherwise the value is omitted.

email_address

Dimension, string

No

Yes

No

The email address associated with the account.

Note: This field is only available for publishers.

event_opportunity

Decimal

Yes

No

No

Bid value or opportunity value for the event type (bid value for bids and impressions).

event_type

String

Yes

No

No

Specifies the type of event shared in the log file. An impression event is logged when an auction was won in the ad server and a creative was served on a page. A bid event is logged with the DSP's response to the bid request. Possible values in your client audit logs for impression events and bid events are below:

impression = An auction was won in the ad server and a creative was served on a page.

bid_chosen = The highest bid(s) in a given auction that was submitted to the ad server as a candidate to potentially win an impression. This field and the bid_eligible field are mutually exclusive.

bid_eligible = The bid response has no blocks and is eligible to compete in the auction. Unlike bid_chosen responses, eligible bids are not the highest bid of a given auction, and are therefore not sent to the ad server.

bid_below_floor = The bid is below the floor price set for the auction.

bid_in_review = The bid is associated with a campaign that is currently waiting to be reviewed or audited.

bid_error = The bid is unusable because it is classified as an error, which can be caused by a number of things. For example, the bid falls below the minimum bid of $0.01.

bid_timeout = The bid was returned outside the bidder's designated bid timeout window.

bid_pass = A bidder passed on a bid request. It's populated when there is a "no bid" response from a downstream partner.

external_ad_id

Dimension, string

Yes

No

No

The creative ID (CRID) provided by the DSP.

external_campaign_id

Dimension, string

Yes

No

No

The campaign ID provided by the DSP.

external_reference_id

Dimension, string

No

Yes

Yes

The deal reporting label containing a unique identifier that an external record system uses to link with the deal. The possible values are:

• A string with a 255-character limit.

• no_label = This deal reporting label contains no data, but at least one other deal reporting label contains data.

• Empty field = This field is empty because there is no data available for any deal reporting label.

Note: This field is only available for Marketplace Partners .

global_placement_id

Dimension, string

Yes

Yes

Yes

The Global Placement Identifier (GPID) is the Google Ad Manager ad unit code for the slot request An ad request for a potential impression.. This code is defined by the publisher and passed to DSPs in OpenRTB bid requests. Not available for STV Streaming TV (STV). Video content that is shown across any device with an internet connection, for example a Connected TV (CTV). apps ad units.

Note: This field is available for Marketplace Partners, publishers, and buyers in the Reporting API. This field is available for all customer types in CAL.

gross_revenue

Decimal

Yes

No

No

Gross revenue for the publisher before share.

hour

Dimension, timestamp

No

Yes

Yes

Timestamp in UTC (Coordinated Universal Time), floored to the hour.

Note: Publishers can create reports in their local time zone. For more information, see Create a custom report.

impressions

Measure, long

No

Yes

Yes

Count of impressions, including deal impressions. An impression occurs when an auction is won in the ad server and a creative is served on a page.

inbound_deal_id

Dimension, string

Yes

No

No

The original deal ID provided by the publisher's ad server. The publisher's inbound_deal_id is mapped to the new deal IDs sent to buyers from deals created within Index.

inbound_max_ad_duration

Dimension, integer

No

Yes

Yes

The maximum ad pod duration that the publisher will allow in a dynamic ad pod request, in seconds.

Note:

• Shown as Maximum Ad Duration in Pod in Reports in the Index UI .
• This field is only available for Marketplace Partners and publishers.

inbound_min_ad_duration

Dimension, integer

No

Yes

Yes

The minimum ad pod duration that the publisher will allow in a dynamic ad pod request, in seconds.

Note:

• Shown as Minimum Ad Duration in Pod in Reports in the Index UI .
• This field is only available for Marketplace Partners and publishers.

index_fee

Measure, decimal

No

Yes

Yes

Index's fee applied to the transaction.

Note: This field is only available for Marketplace Partners, DSPs and buyers.

index_segment_id

Dimension, integer

No

Yes

Yes

The Index-generated segment ID targeted by a deal on an impression.

Note: This field is only available for Marketplace Partners and publishers.

internal_deal_id

Dimension, long

Yes

Yes

No

Internal Index system-generated deal identifier.

Note: This field is only available for publishers and buyers.

internal_pg_deal_id

Dimension, string

No

Yes

Yes

The Index Programmatic Guaranteed (PG) deal ID, which indicates that the transaction is associated with a PG deal. If this field is blank, the transaction isn't associated with a PG deal.

Note: This field is only available for publishers.

inventory_channel

Dimension, string

Yes

Yes

Yes

The environment through which the ad is shown. The possible values are:

• web (browser)
• amp (Accelerated Mobile Pages)
• in-app

• protected web: A browser ad that is associated with the Protected Audience API.

  Info: Starting in June 2025, Index is pausing support for the Protected Audience API. As a result, this field will no longer generate new data.

• other

is_billed_segment

Dimension, integer

No

Yes

Yes

Specifies whether the segment was activated and was billed on an impression. The possible values are:

• billed = This segment was activated and billed on an impression.

• not billed = This segment was not activated, and as a result, not billed on an impression.

Note: This field is only available for Marketplace Partners.

is_included_targeting_segment

Dimension, integer

No

Yes

Yes

Specifies whether the segment was used for inclusion or exclusion targeting on an impression. The possible values are:

• 0 = This segment was used for exclusion targeting on a deal.

• 1 = This segment was used for inclusion targeting on a deal.

Note: This field is only available for Marketplace Partners and publishers.

marketplace_cpm

Measure, decimal

No

Yes

Yes

The marketplace_media_spend per 1000 Marketplace impressions.

Calculation: (1000 x marketplace_media_spend) / marketplace_impressions

Note: This metric only exists for impressions transacted through a Marketplace and is only available if the Marketplace Owner has opted to share this data.

marketplace_index_fee

Measure, decimal

No

No

No

Index's portion of the marketplace_total_fee.

Note: As of April 24, 2025, the marketplace_index_fee field has been deprecated. The feature to apply the Index fee at the Marketplace level instead of the publisher level has never been used. We have deprecated this functionality while maintaining the fields in existing reports for backwards compatibility.

marketplace_index_fee_percent

Measure, decimal

No

No

No

Index's portion of the marketplace_total_fee as a percent (as a decimal from 0 to 1) of marketplace_media_spend.

Calculation: marketplace_index_fee / marketplace_media_spend.

Note: As of April 24, 2025, the marketplace_index_fee_percent field has been deprecated. The feature to apply the Index fee at the Marketplace level instead of the publisher level has never been used. We have deprecated this functionality while maintaining the fields in existing reports for backwards compatibility.

marketplace_publisher_spend

Measure, decimal

Yes

Yes

Yes

The portion of the marketplace_media_spend designated for the seller A supply partner that sells their own inventory or on behalf of a publisher. prior to the deduction of any additional fees approved by sellers.

Note: This metric only exists for impressions transacted through a Marketplace and is only available if the Marketplace Owner has opted to share this data.

marketplace_media_spend

Measure, decimal

Yes

Yes

Yes

The portion of the media_spend a buyer transacts through a Marketplace on the exchange.

Note: This metric only exists for impressions transacted through a Marketplace and is only available if the Marketplace Owner has opted to share this data.

marketplace_owner_fee

Measure, decimal

Yes

Yes

Yes

Marketplace Owner's portion of the marketplace_total_fee.

Note: This metric only exists for impressions transacted through a Marketplace and is only available if the Marketplace Owner has opted to share this data.

marketplace_owner_id

Dimension, string

Yes

Yes

Yes

Unique ID of the Marketplace Owner account.

Note: This field is only available for publishers and buyers.

marketplace_owner_name

Dimension, string

No

Yes

Yes

The Marketplace Owner account name.

Note: This field is only available for publishers and buyers.

marketplace_owner_fee_percent

Measure, decimal

No

Yes

Yes

The Marketplace Owner's portion of the marketplace_total_fee as a percent (as a decimal from 0 to 1) of marketplace_media_spend. The calculation is:

marketplace_owner_fee / marketplace_media_spend

Note: This metric only exists for impressions transacted through a Marketplace and is only available if the Marketplace Owner has opted to share this data.

marketplace_targeted_deal_id

Dimension, integer

No

Yes

Yes

The internal Index deal ID targeted by a Marketplace Package on an impression.

Note:

• This dimension only exists for impressions transacted through a Marketplace and is only available if the Marketplace Owner has opted to share this data.

• This field is only available for Marketplace Partners and publishers.

marketplace_targeted_deal_name

Dimension, string

No

Yes

Yes

The name of the deal targeted by a Marketplace Package on an impression.

Note:

• This dimension only exists for impressions transacted through a Marketplace and is only available if the Marketplace Owner has opted to share this data.

• This field is only available for Marketplace Partners and publishers.

marketplace_total_fee

Dimension, decimal

Yes

Yes

Yes

The total fees taken within the Marketplace.

Note: This metric only exists for impressions transacted through a Marketplace and is only available if the Marketplace Owner has opted to share this data.

marketplace_total_fee_percent

Measure, decimal

No

Yes

Yes

The total monetary fees taken within the Marketplace as a percent (as a decimal from 0 to 1) of marketplace_media_spend. The calculation is: marketplace_total_fee / marketplace_media_spend.

Note: This metric only exists for impressions transacted through a Marketplace and is only available if the Marketplace Owner has opted to share this data.

marketplace_vendor_fee

Measure, decimal

Yes

Yes

Yes

The Marketplace Vendor's portion of the Marketplace Total Fee.

Note: This metric only exists for impressions transacted through a Marketplace and is only available if the Marketplace Owner has opted to share this data.

measurable_click_impressions

Measure, integer

No

Yes

Yes

The estimated total number of impressions where click tracking events could be measured by Index.

measurable_video_playback

Measure, integer

No

Yes

Yes

The estimated total number of impressions where first quartile, midpoint, third quartile, and complete quartile events could be measured by Index.

media_spend

Measure, decimal

Yes

Yes

Yes

The amount a buyer owes to Index for ad inventory purchased through the exchange.

Note: For publishers, this metric is only available if the Marketplace Owner has opted to share this data.

max_ad_duration

Dimension, integer

Yes

Yes

Yes

The maximum video ad slot The location on a publisher's website where an advertisement is served. Also known as inventory. duration allowance in seconds.

Note: This field is only available for publishers.

min_ad_duration

Dimension, integer

Yes

Yes

Yes

The minimum video ad slot duration allowance in seconds.

Note: This field is only available for publishers.

min_bid_to_win

Decimal

Yes

No

No

The bid you would have needed to submit in order to surpass all other bidders and seller-wide floors in the Index auction. This field is only included if your bid lost the auction.

Note: This field is only available for log files associated with bid event types for DSPs and buyers only. Also, this field does not apply to auctions that were won by a deal bid.

measured_impressions

Measure, decimal

No

Yes

Yes

The total number of impressions that Index was able to gather viewability data for.

Note: This metric is only available for publishers and Marketplace Owners, on or after July 1, 2022.

For more information about what viewability is and how we measure it, see What is viewability?

month

Dimension, timestamp

No

Yes

Yes

Timestamp in UTC (Coordinated Universal Time), floored to the month.

Note: Publishers can create reports in their local time zone. For more information, see Create a custom report.

net_revenue

Decimal

Yes

No

No

The publisher's net revenue. We provide net_revenue and pub_rev_share to buyers in cases where the publisher has agreed to share this information. Publishers always receive these values.

Calculation: gross_revenue * pub_rev_share = net_revenue

open_ad_spend

Measure, decimal

No

Yes

Yes

The publisher's gross revenue associated with open marketplace activity.

open_media_spend

Measure, decimal

No

Yes

Yes

The amount a buyer owes to Index for open market ad inventory purchased through the exchange.

open_impressions

Measure, decimal

No

Yes

Yes

The total number of open market impressions that were actually rendered.

open_publisher_payment

Measure, decimal

No

Yes

Yes

The publisher's net revenue associated with open marketplace activity.

Note: This field is only available for publishers.

operating_system

Dimension, string

Yes

Yes

Yes

The name of the operating system associated with this impression. The possible values for reports containing data before March 1, 2022 are:

• ANDR 

• IOSP

• LINX

• MACO

• WINP

• other

• unknown

• WIND 

The name of the operating system associated with this impression. The possible values for reports containing data after March 1, 2022 are:

• Android

• Chrome OS

• iOS

• iPad OS

• tvOS

• Linux

• Linux - Ubuntu

• OS X

• other

• Roku OS

• SmartCast OS

• Tizen

• webOS

• unknown

• Windows 10

• Windows 7

• Windows 8

• Windows 8.1

• Windows Vista

• Windows XP

• MacOS

• LG WebOS Browser

Note: This field is only available for publishers and DSPs.

p_id

String

Yes

No

No

Unique identifier for Universal IDs Universal IDs are IDs that Index can receive from data partners and pass to DSPs in the bid request.. Only available in certain cases.

The format uses key value pairs. The first value is the provider_id, and the second value is the identifier. For example, [1:XYZ12345],[32:ABCDEF],[4:98765432]

Note: This field is only available for log files associated with impression event types.

p_ids

String

Yes

No

No

Unique identifiers for people-based IDs that allow Universal ID providers to attribute impressions to in-store purchases or conversions for brands. To learn more, see List of supported identifier providers. Also allows publishers who enable Universal ID providers to curate people-based audiences.

The format is an array of key value pairs wrapped in a string. For example, "1:XYZ12345;32:ABCDEF;4:98765432"

• The key value pairs are separated by a semicolon (;) delimiter.
• The key represents the provider_id (for example, 3 = LiveRampIDL), and the value is the people-based identifier.
• The keys and values are separated by a colon (:) delimiter.

Note: This field is only available for log files associated with impression event types. This field is not available for publishers.

page_url

String

Yes

No

No

The entire URL of the page where the request originated.

partner_id

Dimension, long

Yes

Yes

Yes

Index publisher identifier.

partner_name

Dimension, string

No

Yes

Yes

The publisher name.

Note: This field is only available for Marketplace Partners, buyers and DSPs.

pod_request

Measure, long

No

Yes

Yes

The total number of dynamic ad pod requests for potential impressions.

Note: This field is only available for Marketplace Partners and publishers.

pod_valid

Measure, long

No

Yes

Yes

The total number of dynamic ad pod requests that returned at least one bid to the publisher.

Note: This field is only available for Marketplace Partners and publishers.

prebidjs_version

Dimension, string

Yes

Yes

Yes

The version of Prebid.js An open-source library for publishers to implement header bidding on their websites and manage multiple header bidding partners. that the publisher is using to send slot requests to Index. The possible versions include:

• 7.x

• 6.x

• 5

• 4

Note: This field is only available in Reports in the Index UI for buyers, and in the Reporting API for buyers and DSPs. It is available for all customer types in CAL.

protected_audience_status

Dimension, integer

No

Yes

Yes

Info: Starting in June 2025, Index is pausing support for the Protected Audience API. As a result, this field will no longer generate new data.

The Protected Audience status specifies how Index responded to an incoming impression opportunity that is considered eligible for an on-device Protected Audience auction. An impression is considered eligible when the publisher sends a flag (ae = 1) in the OpenRTB Imp Extension object. The possible values are:

• 0 = The publisher did not send the ae = 1 flag

• 1 = The publisher sent the ae = 1 flag but we did not return the auction configuration object in the protectedAudienceAuctionConfigs field in the OpenRTB response extension object

• 2 = The publisher sent the ae = 1 flag and we returned an auction configuration object in the protectedAudienceAuctionConfigs field in the OpenRTB response extension object

• -1 = All other cases

For more information on Index and Privacy Sandbox, see Use Google's Privacy Sandbox APIs with Index.

provider_name

Dimension, string

No

Yes

Yes

The name of the data provider or data partner that supplied the segment data.

Note: This field is only available for Marketplace Partners and publishers.

pub_rev_share

Decimal

Yes

No

No

The publisher revenue share, or, the percent of ad spend Index pays out to the publisher. This is a fraction between 0 and 1; when multiplied by 100, you get the percentage value. For example, 0.75 means that 75% of ad spend goes to the publisher.

Note: gross_revenue * pub_rev_share = net_revenue. We provide net_revenue and pub_rev_share to buyers in cases where the publisher has agreed to share this information. Publishers always receive these values. Also, the data in this field may be anonymized in some event logs, in which case the value will be -1 .

Shown as publisher_revenue_share in the Reporting API and Reports in the Index UI .

publisher_payment

Measure, decimal

No

Yes

Yes

The publisher's net revenue. Index provides net_revenue and pub_rev_share to buyers in cases where the publisher has agreed to share this information. Publishers always receive these values.

publisher_revenue_share

Dimension, decimal

No

Yes

Yes

The publisher revenue share, or, the percent of ad spend Index pays out to the publisher. This is a fraction between 0 and 1; when multiplied by 100, you get the percentage value. For example, 0.75 means that 75% of ad spend goes to the publisher. Only available when the publisher has explicitly opted to share this information, otherwise this field is omitted.

Shown as pub_rev_share in CAL.

region

Dimension, string

No

Yes

Yes

Geographical region. The possible values are:

• EMEA
• APAC
• LATAM
• OTHER
• NA
• UNKNOWN

region_market

Dimension, string

No

Yes

No

Geographical regions, along with select key countries in those regions. The possible values are:

• APAC - AU
• APAC - IN
• APAC - JP
• APAC - KR
• APAC - NZ
• APAC - OTHER
• EMEA - DE
• EMEA - ES
• EMEA - FR
• EMEA - IT
• EMEA - NL
• EMEA - OTHER
• EMEA - PL
• EMEA - TR
• EMEA - UK
• LATAM - BR
• LATAM - MX
• LATAM - OTHER
• NA - CA
• NA - US
• OTHER

Note: This field is only available for publishers.

salesperson

Dimension, string

No

Yes

Yes

The deal reporting label containing the name of the salesperson associated with the deal. The possible values are:

• A string with a 255-character limit.

• no_label = This deal reporting label contains no data, but at least one other deal reporting label contains data.

• Empty field = This field is empty because there is no data available for any deal reporting label.

Note: This field is only available for Marketplace Partners .

seconds_filled

Measure, long

No

Yes

Yes

The total amount of time filled in dynamic ad pod impression opportunities, in seconds.

Note:

• Shown as Filled Pod Duration in Reports in the Index UI .
• This field is only available for Marketplace Partners and publishers.

segment_id

Dimension, string

No

Yes

Yes

The external ID of the segment as assigned by the data provider. This is the segment ID used outside of the Index system, while the index_segment_id is the Index-generated segment ID.

Note: This field is only available for Marketplace Partners and publishers.

segment_owner_id

Dimension, integer

No

Yes

Yes

The ID of the account that owns or provides the data for the segment matched on an impression.

Note: This field is only available for Marketplace Partners and publishers.

segment_owner_name

Dimension, string

No

Yes

Yes

The name of the account that owns or provides the data for the segment matched on an impression.

Note: This field is only available for Marketplace Partners and publishers.

segment_name

Dimension, string

No

Yes

Yes

The name of the segment that was targeted by a deal on an impression.

Note: This field is only available for Marketplace Partners and publishers.

site_id

Dimension, integer

Yes

Yes

Yes

Index site identifier.

site_name

Dimension, string

No

Yes

Yes

The name of the site.

size

Dimension, string

Yes

Yes

Yes

The size of the ad, in pixels, being requested.

• If display, the value is the width x height of the creative in pixels.

• If video, the value is the width x height of the video player in pixels.

• n/a = a native ad that doesn't have a corresponding video player size

• other = the size is unknown

Note: This metric should only be used in relation to impressions and ad spend and not for bid or slot cycle metrics.

slot_error

Measure, long

No

Yes

Yes

Count of slot requests that could not be serviced due to an unexpected error.

Note: This field is only available for publishers.

slot_id

String

Yes

No

No

Contains seller integration data. Publishers can use this field to report on custom data sent in the sid field in the Impression extension object of an OpenRTB Bid Request.

Note: This field may also contain slot identifiers received from a header integration.

slot_pass

Measure, long

No

Yes

Yes

Count of slot requests that were evaluated but not passed on to DSPs in the form of bid requests.

Note: This field is only available for publishers.

slot_request

Measure, long

No

Yes

Yes

Count of incoming slot requests for a potential impression. A single slot request is transformed into multiple bid requests ( bid_request in the bid cycle) that are sent to each DSP that would want to bid on this impression.

Note: This field is only available for publishers.

slot_timeout

Measure, long

No

Yes

Yes

Count of slot requests that could not be serviced due to no demand being available when the publisher-configured timeout expired.

Note: This field is only available for publishers.

slot_valid

Measure, long

No

Yes

Yes

Count of slot requests that resulted with at least one bid being returned to the publisher.

Note: This field is only available for publishers.

state

Dimension, string

Yes

No

No

The two character code for the US state.

supply_source

Dimension, string

Yes

Yes

Yes

The integration type of the incoming request. The possible values are:

• direct = publisher is using a direct, tag-based integration option
• adapter = publisher is using Prebid.js or a custom client-side A type of header bidding where the auction takes place on the user's browser. solution
• wrapper = publisher is using the IX Library
• ebda = publisher is using Google Open Bidding
• enterprise = publisher is using a server to server integration
• other

For more information about Index's integration options, see Integrating with Index.

String

Yes

No

No

Timestamp in UTC.

topic_id

Dimension, integer (in Reporting API), array (in CAL)

Yes

Yes

Yes

The ID of the interest group topic associated with the topic_name that was included in the ad request.

For example, if the topic_name = Pets & Animals/Pets/Dogs, the topic_id = 268.

For a full list of topic names and IDs, see Topics - Taxonomy_v2.

Note: In the Reporting API/Reports in the Index UI, this field is only available for publishers.

topic_name

Dimension, string

No

Yes

Yes

The Topics API interest group topic name that was included in the ad request. For example, Pets & Animals/Pets/Dogs.

For a full list of topic names, see Topics - Taxonomy_v2.

Note: This field is only available for publishers.

topic_version_name

Dimension, integer

No

Yes

Yes

The Topics API topic taxonomy version for the topic_id and topic_name that was sent in the ad request. For example, taxonomy_v2.

Note: This field is only available for publishers.

total_available_pod_duration

Measure, long

No

Yes

Yes

The total amount of time available in all dynamic ad pod impression opportunities, in seconds.

Note:

• Shown as Total Available Duration in Pods in Reports in the Index UI .
• This field is only available for Marketplace Partners and publishers.

total_bid_opportunity

Measure, decimal

No

Yes

Yes

Sum of all bid_opportunity responses + ad_spend.

Note: This field is only available for Marketplace Partners, publishers and DSPs.

total_bids

Measure, integer

No

Yes

Yes

Total number of bids, regardless of whether they were ever candidates to compete in an auction.

Calculation: bid_in_review + bid_blocked + bid_eligible + bid_chosen + bid_below_floor + bid_error

Note: This field is only available for Marketplace Partners, publishers and DSPs.

trading_desk_id

Integer, long

Yes

Yes

No

The Index identifier for a trading desk A buyer in the RTB exchange. Trading desks integrate with DSPs to participate in the auctions that occur each time an impression is served. A single trading desk may be connected to one or more DSPs. The pairing of a single trading desk with a single DSP represents an advertiser user in our system. that maps to a buyer_name.

vendor_id

Dimension, integer

No

Yes

Yes

The Index identifier for the Marketplace Vendor participating in Index Marketplaces.

Note: This field is only available for Marketplace Partners.

vendor_name

Dimension, string

No

Yes

Yes

The name of the Marketplace Vendor who earned a fee for the data or services provided.

Note: This field is only available for Marketplace Partners.

video_completion_rate

Measure, integer

No

Yes

Yes

The estimated percentage of video impressions that played to completion as measured by Index.

Calculation: video_complete / measurable_video_playback

For more information about how Index calculates the video completion rate The percentage of video advertisements that play to completion. Also known as view through rate and video completion rate. (VCR), see Targeting video completion rate (VCR) in a deal (Alpha).

video_first_quartile

Measure, integer

No

Yes

Yes

The estimated total number of video impressions that played for at least 25% of the total duration as measured by Index.

video_midpoint

Measure, integer

No

Yes

Yes

The estimated total number of video impressions that played for at least 50% of the total duration as measured by Index.

Note: The values include previous events. For example, when 25% of the video is viewed, it gets logged under video_first_quartile, and when it reaches 50%, it gets logged under video_first_quartile and video_midpoint.

video_third_quartile

Measure, integer

No

Yes

Yes

The estimated total number of video impressions that played for at least 75% of the total duration as measured by Index.

Note: The values include previous events. For example, when 75% of the video is viewed, it gets logged under video_first_quartile, video_midpoint, and video_third_quartile .

video_complete

Measure, integer

No

Yes

Yes

The estimated total number of video impressions that played to completion as measured by Index.

Note: The values include previous events. For example, a video that is played to completion gets logged under video_first_quartile, video_midpoint, video_third_quartile, and video_complete.

viewable_impressions

Measure, integer

No

Yes

Yes

The total number of impressions measured that were viewable as defined by the IAB Interactive Advertising Bureau (IAB). An advertising business organization that develops industry standards, conducts research, and provides legal support for the online advertising industry. Viewability Standard.

Note: This metric is only available for publishers and Marketplace Owners, on or after July 1, 2022.

For more information about what viewability is and how we measure it, see What is viewability?

video_placement_type

Dimension, string

Yes

Yes

Yes

The type of placement associated with a video impression. This information comes from the video.placement field in an OpenRTB bid request. The possible values for reports containing data before June 20, 2023 are:

• In-stream = A video ad that displays before (pre-roll), during (mid-roll), or after (post-roll) video content that the user is consuming. The video ad plays within video content, similar to watching TV with commercials.

• In-article = A video that loads and plays dynamically between paragraphs of editorial content, and exists as a standalone Video ads that are played without streaming video content. This can be in placements like slideshows, native feeds, in-content or sticky/floating. branded message.

• In-feed = A video that displays in content, social, or product feeds.

• Floating Placement = A video that covers the entire or a portion of the screen area, and is always visible even when the user is scrolling on the screen.

• In-banner = A video that exists within a web banner that uses the banner space to deliver a video experience.

• Unknown = The video placement is unknown.

• Other = The video placement is something other than the above options.

The type of placement associated with a video impression, in accordance with the updated IAB Digital Video Guidelines. This information may come from the video.placement field or the video.plcmt field in an OpenRTB bid request. The possible values for reports containing data after June 20, 2023 are:

• In-stream = A video ad that displays before (pre-roll), during (mid-roll), or after (post-roll) video content that the user is consuming. The video ad plays within video content, similar to watching TV with commercials.

• In-article = A video that loads and plays dynamically between paragraphs of editorial content, and exists as a standalone branded message.

• In-feed = A video that displays in content, social, or product feeds.

• Floating Placement = A video that covers the entire or a portion of the screen area, and is always visible even when the user is scrolling on the screen.

• In-banner = A video that exists within a web banner that uses the banner space to deliver a video experience.

• Accompanying content = Pre-roll, mid-roll, and post-roll ads that are played before, during, or after streaming video content. The video player loads and plays before, between, or after paragraphs of text or graphical content, and starts playing only when it enters the viewport.

• Interstitial = An ad that covers the entire screen of the device/host app.

• No content/standalone = Video ads that are played without streaming video content. This can be in placements like slideshows, native feeds, in-content or sticky/floating.

• Unknown = The video placement is unknown.

• Other = The video placement is something other than the above options.

Note: This field is only available in Reports in the Index UI for publishers, and in the Reporting API for publishers and DSPs. It is available for all customer types in CAL.

video_playback_method

Dimension, integer

No

Yes

Yes

Specifies how and when the video ad begins playing. Possible values are: 

• 1 = Loads on the page with the sound on

• 2 = Loads on the page with the sound off

• 3 = Loads with the sound on upon on user click

• 4 = Loads with the sound on upon user mouse over

• 5 = Loads with the sound on upon entering the user's viewport

• 6 = Loads with the sound off upon entering the user's viewport

Note: This field is only available for publishers.

video_skippable

Dimension, string

No

Yes

Yes

Specifies whether the user can skip the video. Possible values are:

• True = Video is skippable

• False = Video is not skippable

Note: This field is only available for publishers.

winning_bid_price

Measure, decimal

No

Yes

Yes

The winning bid price, before accounting for Index fees and eligible incentive programs, for example XFR .

Note: This field is only available for buyers and DSPs, and is expressed as the total dollar value, not as eCPM Effective Cost Per Mille (eCPM). A publisher metric used as an estimate of the revenue publishers receive for every thousand ad impressions. It allows publishers to compare the effectiveness of different types of advertising and optimize to increase revenue. eCPM is calculated as (Total Earnings / Impressions) x 1000. eCPM is essentially the same as revenue per mille (RPM)..

xfr_applied

Dimension, boolean

No

Yes

Yes

Species whether an XFR rate was applied on the transaction.

• True = XFR was applied.

• False = XFR was not applied

Note: This field is only available for buyers.

xfr_savings_amount

Measure, decimal

No

Yes

Yes

The savings captured by publishers as a result of the XFR program. XFR savings increase the net bid The bid price after Index fee or, if applicable, Marketplace fees. in an auction, and increases a buyer's working media by reducing the Index fee. This can result in higher overall win rates.

Note: This field is only available for buyers.

zip_postal

String

Yes

No

No

Zip or postal code.