Data dictionary

Last Updated: February 18, 2026
Term
Type
Audience
Product
a_domain
DimensionString
DSPs
Reporting APIIndex UICAL

Advertiser domain 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
MeasureDecimal
All
Reporting APIIndex UI

Rate of impressions served from the number of bids that were sent to the ad server.

Calculation: impressions / bid_chosen

ad_spend
MeasureDecimal
All
Reporting APIIndex UI

Gross revenue for the Media Owner before share.

advertiser
DimensionString
All
Reporting APIIndex UI

The deal 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: For more information about the deal reporting labels available when creating a Marketplace Package, see Create a Marketplace Package.

agency
DimensionString
All
Reporting APIIndex UI

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: For more information about the deal reporting labels available when creating a Marketplace Package, see Create a Marketplace Package.

app_bundle
DimensionString
Marketplace PartnersMedia OwnersDSPs
Reporting APIIndex UICAL

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

auction_id
String
All
CAL

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
DimensionString
All
Reporting API

The type of auction that was conducted. Either first price or fixed price auction.

average_competing_bid_price
MeasureDecimal
Buyers
Reporting APIIndex UI

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

average_measured_viewability
MeasureDecimal
Media Owners
Reporting APIIndex UI

The average measured viewability. For dimensions selected, average_measured_viewability = total_viewable_impressions / total_measured_impressions.

Note: This metric is only available for Media Owners and Marketplace Owners, 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
MeasureLong
All
Reporting APIIndex UI

Count of bid responses received that were below the floor price set for the auction.

bid_below_floor_opportunity
MeasureDecimal
All
Reporting APIIndex UI

Sum of bid prices from bid_below_floor events.

bid_below_floor_seconds
MeasureLong
Marketplace PartnersMedia Owners
Reporting APIIndex UI

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

bid_blocked
MeasureLong
All
Reporting APIIndex UI

Count of bid requests that were blocked because of the publisher's creative settings.

bid_blocked_opportunity
MeasureDecimal
All
Reporting APIIndex UI

Sum of bid prices from bid_blocked events.

bid_blocked_seconds
MeasureLong
Marketplace PartnersMedia Owners
Reporting APIIndex UI

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

bid_chosen
MeasureLong
All
Reporting APIIndex UI

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
MeasureDecimal
All
Reporting APIIndex UI

Sum of CPM bid prices from bid_chosen events.

bid_chosen_seconds
MeasureLong
Marketplace PartnersMedia Owners
Reporting APIIndex UI

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.

bid_eligible
MeasureLong
All
Reporting APIIndex UI

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
MeasureDecimal
All
Reporting APIIndex UI

Sum of bid prices from bid_eligible events.

bid_eligible_seconds
MeasureLong
Marketplace PartnersMedia Owners
Reporting APIIndex UI

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.

bid_error
MeasureLong
Marketplace PartnersMedia OwnersDSPs
Reporting APIIndex UI

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

bid_in_review
MeasureLong
All
Reporting APIIndex UI

Count of times a bid response was received that contained a campaign that is currently waiting to be reviewed or audited.

bid_in_review_opportunity
MeasureDecimal
All
Reporting APIIndex UI

Sum of bid prices from bid_in_review events.

bid_in_review_seconds
MeasureLong
Marketplace PartnersMedia Owners
Reporting APIIndex UI

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

bid_pass
MeasureLong
Marketplace PartnersMedia OwnersDSPs
Reporting APIIndex UI

Count of times a bidder passed on a bid request. It's populated when there is a "no bid" response from a downstream partner.

bid_request
MeasureLong
Marketplace PartnersMedia OwnersDSPs
Reporting APIIndex UI

Count of OpenRTB bid requests sent to a downstream partner (DSP or bidder) requesting a response for potential impressions.

bid_request_id
MeasureLong
All
CAL

The unique ID assigned to a bid request by Index. This ID is sent to DSPs in the id field in the BidRequest object of an OpenRTB bid request.

The format combines the auction_id, dsp_id, and a number identifying each impression object within a multi-impression bid request, separated by underscores.

For example, for a bid request with three impression objects, the bid_request_id values would be:

  • 3f9c2e7a-4b1d-4f2a-9c7e-1a6d8b0f3c92_x55_1
  • 3f9c2e7a-4b1d-4f2a-9c7e-1a6d8b0f3c92_x55_2
  • 3f9c2e7a-4b1d-4f2a-9c7e-1a6d8b0f3c92_x55_3
bid_stage
String
Media Owners
CAL

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 Media Owner.
  • blocked_brand = The bid response contained a brand that has been blocked by the Media Owner.
  • exclusive_brand = The bid response contained a brand that has been excluded by the Media Owner.
  • 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
MeasureLong
Marketplace PartnersMedia OwnersDSPs
Reporting APIIndex UI

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.

billing_term_id
DimensionInteger
Media Owners
CAL

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

Current functionality:

  • An ID of 0 indicates that the Media Owner'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 Media Owner 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
All
Reporting APICAL

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
DimensionString
All
Reporting APIIndex UICAL

The product or service being advertised.

browser
DimensionString
Marketplace PartnersMedia OwnersDSPs
Reporting APIIndex UICAL

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
buyer_name
DimensionString
All
Reporting APIIndex UI

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

buyer_seat_id
DimensionString
All
Reporting APIIndex UI

The DSP's ID of the buyer or agency associated with the bid.

buyer_total_bid_opportunity
MeasureInteger
All
Reporting APIIndex UI

Sum of all bid opportunities available.

Calculation: bid_below_floor_opportunity + bid_blocked_opportunity + bid_chosen_opportunity + bid_eligible_opportunity + bid_in_review_opportunity

buyer_total_bids
MeasureInteger
All
Reporting APIIndex UI

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

buyer_volume_incentives_applied
DimensionString
Media OwnersBuyers
Reporting APIIndex UICAL

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.

buyer_volume_incentives_savings_amount
MeasureDecimal
Media OwnersBuyers
Reporting APIIndex UICAL

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.

buyer_win_rate
MeasureDecimal
All
Reporting APIIndex UI

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

campaign_id
Integer
All
CAL

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

The Index name for the campaign.

clicks
MeasureInteger
All
Reporting APIIndex UI

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

click_through_rate
MeasureInteger
All
Reporting APIIndex UI

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), see Targeting click-through rate (CTR) in dealsTargeting click-through rate (CTR) in Marketplace Packages (Beta)Targeting click-through rate (CTR) in Inventory Packages (Alpha).

company_name
DimensionString
Media OwnersDSPs
Reporting API

The name of company set up in the Index system.

cma_label
DimensionString
All
Reporting APIIndex UICAL

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
MeasureDecimal
All
Reporting APIIndex UI

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

Calculation: bid_eligible + bid_chosen

configured_take_rate
MeasureString
Marketplace PartnersBuyers
Reporting APIIndex UI

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 Media Owner has opted to share revenue, otherwise the value is omitted.

connection_type
Integer
All
CAL

The network connection type of the device included in the slot request. The possible values are:

  • 0 = unknown
  • 1 = ethernet
  • 2 = WiFi
  • 3 = cellular network - unknown generation
  • 4 = cellular network - 2G
  • 5 = cellular network - 3G
  • 6 = cellular network - 4G
content_channel
DimensionString
Media OwnersBuyersDSPs
Reporting APIIndex UICAL

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

content_genre
DimensionString
Media OwnersBuyersDSPs
CAL

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

content_language
DimensionString
Media OwnersBuyersDSPs
Reporting APIIndex UICAL

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

content_livestream
DimensionInteger
Media Owners
Reporting APIIndex UICAL

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
content_network
DimensionString
Media OwnersBuyersDSPs
Reporting APIIndex UICAL

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

content_rating
DimensionInteger
Media OwnersBuyersDSPs
Reporting APIIndex UICAL

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

cookie_match_status
String
All
CAL

Cookie match status. Possible values are:

  • matched = Index has a buyeruid 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
DimensionString
All
Reporting APIIndex UICAL

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

unknown = unrecognized country.

cpm
MeasureDecimal
All
Reporting APIIndex UI

The cost per 1000 impressions.

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

creative_duration
Integer
All
CAL

The total duration of a creative for streaming video content, in seconds.

creative_id
Integer
All
CAL

Identifier for the creative.

creative_type
DimensionString
All
Reporting APIIndex UICAL

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
DimensionString
All
Reporting APIIndex UI

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: For more information about the deal reporting labels available when creating a Marketplace Package, see Create a Marketplace Package.

day
DimensionTimestamp
All
Reporting APIIndex UI

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
DimensionString
All
Reporting API

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

dc_region
DimensionString
All
Reporting API

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

deal_ad_spend
MeasureDecimal
All
Reporting APIIndex UI

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

deal_media_spend
DimensionDecimal
Media OwnersBuyers
Reporting APIIndex UI

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

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

deal_cpm
MeasureDecimal
All
Reporting APIIndex UI

The cost per 1000 impressions, specific to a deal.

Calculation: (deal_ad_spend) / (deal_impressions) * 1000

deal_ecpm
MeasureDecimal
Media Owners
Reporting APIIndex UI

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

Calculation: (deal_publisher_payment) / (deal_impressions) * 1000

deal_id
DimensionString
All
Reporting APIIndex UICAL

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

deal_impressions
MeasureLong
All
Reporting APIIndex UI

Total impressions rendered that transacted on a deal_id.

deal_name
DimensionString
All
Reporting APIIndex UI

The name given to the deal.

deal_publisher_payment
MeasureDecimal
All
Reporting APIIndex UI

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

demand_channel
DimensionString
All
Reporting APIIndex UICAL

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.
  • platform_deal = deals that transacted using Matched Audiences.
  • marketplaces = impressions that transacted in Index Marketplaces
device_type
DimensionString
All
Reporting APIIndex UICAL

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
MeasureDecimal
Media Owners
Reporting APIIndex UICAL

The dollar amount that a Media Owner has discounted the final price of the deal transaction. The percentage discount is set by the Media Owner on the deal as a spend incentive. Bids with this deal setting compete as normal and the discount set by the Media Owner 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 Media Owner has opted to share their revenue information.

dma
String
All
CAL

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

domain
DimensionString
All
Reporting APIIndex UICAL

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
MeasureDecimal
Marketplace PartnersMedia OwnersDSPs
Reporting APIIndex UI

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

dsp_id
DimensionInteger
All
Reporting APICAL

Index DSP identifier.

dsp_id_level_1
DimensionString
Marketplace Partners
Reporting APIIndex UI

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.

For a full list of deal reporting labels, see Available fields.

Note: For more information about deal synchronization, see Deal synchronization options.

dsp_id_level_2
DimensionString
Marketplace Partners
Reporting APIIndex UI

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.

For a full list of deal reporting labels, see Available fields.

Note: For more information about deal synchronization, see Deal synchronization options.

dsp_name
DimensionString
All
Reporting APIIndex UI

The DSP that represents multiple trading desks.

dsp_win_rate
MeasureDecimal
Marketplace PartnersMedia OwnersDSPs
Reporting APIIndex UI

Percentage of impressions served from all bids.

Calculation: impressions / total_bids

dynamic_ad_pod_duration
DimensionInteger
Marketplace PartnersMedia Owners
Reporting APIIndex UI

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.

dynamic_ad_pod_max_sequence
DimensionInteger
Marketplace PartnersMedia Owners
Reporting APIIndex UI

The maximum number of ads that the Media Owner 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.

ecpm
MeasureDecimal
Marketplace PartnersMedia Owners
Reporting APIIndex UI

The net cost per 1000 impressions.

Calculation: (publisher_payment) / (impressions) * 1000

effective_take_rate
MeasureString
Buyers
Reporting APIIndex UI

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 Media Owner has opted to share revenue, otherwise the value is omitted.

email_address
DimensionString
Media Owners
Reporting API

The email address associated with the account.

event_opportunity
Decimal
All
CAL

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

event_type
String
All
CAL

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
DimensionString
All
CAL

The creative ID (CRID) provided by the DSP.

external_campaign_id
DimensionString
All
CAL

The campaign ID provided by the DSP.

external_reference_id
DimensionString
All
Reporting APIIndex UI

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.

For a full list of deal reporting labels, see Available fields.

Note: For more information about the deal reporting labels available when creating a Marketplace Package, see Create a Marketplace Package.

floor_price
Decimal
All
CAL

The minimum bid for an impression, in CPM.

global_placement_id
DimensionString
Marketplace PartnersMedia OwnersBuyersDSPs
Reporting APIIndex UICAL

The Global Placement Identifier (GPID) is the Google Ad Manager ad unit code for the slot request. This code is defined by the Media Owner and passed to DSPs in OpenRTB bid requests. Not available for STV apps ad units.

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

goal_impression
DimensionInteger
Marketplace PartnersMedia Owners
Reporting APIIndex UI

The number of impressions that the buyer agreed to purchase for the programmatic guaranteed deal.

Note: Shown as Impression Goal in Reports in the Index UI.

goal_spend
DimensionInteger
Marketplace PartnersMedia Owners
Reporting APIIndex UI

The amount of ad spend that the buyer agreed to purchase for the programmatic guaranteed deal.

Note: Shown as Spend Goal in Reports in the Index UI.

gross_revenue
Decimal
All
CAL

Gross revenue for the Media Owner before share.

hour
DimensionTimestamp
All
Reporting APIIndex UI

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
MeasureLong
All
Reporting APIIndex UI

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
DimensionString
All
CAL

The original deal ID provided by the Media Owner'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
DimensionInteger
Marketplace PartnersMedia Owners
Reporting APIIndex UI

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

Note: Shown as Maximum Ad Duration in Pod in Reports in the Index UI.

inbound_min_ad_duration
DimensionInteger
Marketplace PartnersMedia Owners
Reporting APIIndex UI

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

Note: Shown as Minimum Ad Duration in Pod in Reports in the Index UI.

index_fee
MeasureDecimal
All
Reporting APIIndex UI

Index's fee applied to the transaction.

index_segment_id
DimensionInteger
Media Owners
Reporting APIIndex UI

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

internal_deal_id
DimensionLong
Media OwnersBuyers
Reporting APICAL

Internal Index system-generated deal identifier.

internal_pg_deal_id
DimensionString
Media Owners
Reporting APIIndex UI

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.

inventory_channel
DimensionString
All
Reporting APIIndex UICAL

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
ip_v4
DimensionString
All
CAL

The IPv4 address of the device included in the slot request, truncated to the first three values of the IP address. For example, the IP address 192.0.2.1 will appear as 192.0.2.0.

Note: If the IP address is in IPv6 format, this field will be 0.0.0.0.

ip_v6
DimensionString
All
CAL

The IPv6 address of the device included in the slot request, truncated to the first three hextets of the IP address. For example, the IP address 2001:db8:85a3:8d3:1319:8a2e:370:7348 will appear as 2001:db8:85a3::.

Note: If the IP address is in IPv4 format, this field will be null.

is_billed_segment
DimensionInteger
All
Reporting APIIndex UI

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.
is_included_targeting_segment
DimensionInteger
Marketplace PartnersMedia Owners
Reporting APIIndex UI

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.
marketplace_cpm
MeasureDecimal
All
Reporting APIIndex UI

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_publisher_spend
MeasureDecimal
All
Reporting APIIndex UICAL

The portion of the marketplace_media_spend designated for the seller 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
MeasureDecimal
Buyers
Reporting APIIndex UICAL

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
MeasureDecimal
All
Reporting APIIndex UICAL

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
DimensionString
Media OwnersBuyers
Reporting APIIndex UICAL

Unique ID of the Marketplace Owner account.

marketplace_owner_name
DimensionString
Media OwnersBuyers
Reporting APIIndex UI

The Marketplace Owner account name.

marketplace_owner_fee_percent
MeasureDecimal
All
Reporting APIIndex UI

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

Calculation: 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
DimensionInteger
Marketplace PartnersMedia Owners
Reporting APIIndex UI

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.

marketplace_targeted_deal_name
DimensionString
Marketplace PartnersMedia Owners
Reporting APIIndex UI

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.

marketplace_total_fee
DimensionDecimal
All
Reporting APIIndex UICAL

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
MeasureDecimal
All
Reporting APIIndex UI

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

Calculation: 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
MeasureDecimal
All
Reporting APIIndex UICAL

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
MeasureInteger
All
Reporting APIIndex UI

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

measurable_video_playback
MeasureInteger
All
Reporting APIIndex UI

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

media_spend
MeasureDecimal
Media OwnersBuyers
Reporting APIIndex UICAL

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

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

max_ad_duration
DimensionInteger
Media Owners
Reporting APIIndex UICAL

The maximum video ad slot duration allowance in seconds.

min_ad_duration
DimensionInteger
Media Owners
Reporting APIIndex UICAL

The minimum video ad slot duration allowance in seconds.

min_bid_to_win
Decimal
BuyersDSPs
CAL

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
MeasureDecimal
Media Owners
Reporting APIIndex UI

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

Note: This metric is only available for Media Owners 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
DimensionTimestamp
All
Reporting APIIndex UI

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

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

Calculation: gross_revenue * pub_rev_share = net_revenue

open_ad_spend
MeasureDecimal
All
Reporting APIIndex UI

The Media Owner's gross revenue associated with open marketplace activity.

open_media_spend
MeasureDecimal
All
Reporting APIIndex UI

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

open_impressions
MeasureDecimal
All
Reporting APIIndex UI

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

open_publisher_payment
MeasureDecimal
Media Owners
Reporting APIIndex UI

The Media Owner's net revenue associated with open marketplace activity.

operating_system
DimensionString
Media OwnersDSPs
Reporting APIIndex UICAL

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
p_id
String
All
CAL

Unique identifier for Universal IDs. 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
Media Owners
CAL

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:

Also allows Media Owners 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 Media Owners.

page_url
String
All
CAL

The entire URL of the page where the request originated.

partner_id
DimensionLong
All
Reporting APIIndex UICAL

Index Media Owner identifier.

partner_name
DimensionString
Marketplace PartnersBuyersDSPs
Reporting APIIndex UI

the Media Owner name.

pod_request
MeasureLong
Marketplace PartnersMedia Owners
Reporting APIIndex UI

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

pod_valid
MeasureLong
Marketplace PartnersMedia Owners
Reporting APIIndex UI

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

prebidjs_version
DimensionString
Media OwnersBuyersDSPs
Reporting APIIndex UICAL

The version of Prebid.js that the Media Owner 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
DimensionInteger
All
Reporting APIIndex UI

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 Media Owner sends a flag (ae = 1) in the OpenRTB Imp Extension object. The possible values are:

  • 0 = the Media Owner did not send the ae = 1 flag
  • 1 = the Media Owner 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 Media Owner 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
DimensionString
Marketplace PartnersMedia Owners
Reporting APIIndex UI

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

pub_rev_share
Decimal
Media OwnersBuyers
CAL

The Media Owner revenue share, or, the percent of ad spend Index pays out to the Media Owner. 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 Media Owner.

Note:

  • gross_revenue * pub_rev_share = net_revenue. We provide net_revenue and pub_rev_share to buyers in cases where the Media Owner has agreed to share this information. Media Owners 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
MeasureDecimal
All
Reporting APIIndex UI

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

publisher_revenue_share
DimensionDecimal
All
Reporting APIIndex UI

The Media Owner revenue share, or, the percent of ad spend Index pays out to the Media Owner. 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 Media Owner. Only available when the Media Owner has explicitly opted to share this information, otherwise this field is omitted.

Note: Shown as pub_rev_share in CAL.

region
DimensionString
All
Reporting APIIndex UI

Geographical region. The possible values are:

  • EMEA
  • APAC
  • LATAM
  • OTHER
  • NA
  • UNKNOWN
region_market
DimensionString
Media Owners
Reporting API

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
salesperson
DimensionString
All
Reporting APIIndex UI

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: For more information about the deal reporting labels available when creating a Marketplace Package, see Create a Marketplace Package.

seconds_filled
MeasureLong
Marketplace PartnersMedia Owners
Reporting APIIndex UI

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.

segment_id
DimensionString
Marketplace PartnersMedia Owners
Reporting APIIndex UI

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.

segment_owner_id
DimensionInteger
Marketplace PartnersMedia Owners
Reporting APIIndex UI

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

segment_owner_name
DimensionString
Marketplace PartnersMedia Owners
Reporting APIIndex UI

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

segment_name
DimensionString
Marketplace PartnersMedia Owners
Reporting APIIndex UI

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

site_id
DimensionInteger
All
Reporting APIIndex UICAL

Index site identifier.

site_name
DimensionString
All
Reporting APIIndex UI

The name of the site.

size
DimensionString
All
Reporting APIIndex UICAL

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
MeasureLong
Media Owners
Reporting APIIndex UI

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

slot_id
String
All
CAL

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
MeasureLong
Media Owners
Reporting APIIndex UI

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

slot_request
MeasureLong
Media Owners
Reporting APIIndex UI

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.

slot_timeout
MeasureLong
Media Owners
Reporting APIIndex UI

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

slot_valid
MeasureLong
Media Owners
Reporting APIIndex UI

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

state
DimensionString
All
CAL

The two character code for the US state.

supply_source
DimensionString
All
Reporting APIIndex UICAL

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

  • direct = Media Owner is using a direct, tag-based integration option
  • adapter = Media Owner is using Prebid.js or a custom client-side solution
  • wrapper = Media Owner is using the IX Library
  • ebda = Media Owner is using Google Open Bidding
  • enterprise = Media Owner is using a server to server integration
  • other

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

timestamp
String
All
CAL

Timestamp in UTC.

topic_id
DimensionInteger (in reporting api)
Media Owners
Reporting APIIndex UICAL

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 Media Owners.

topic_name
DimensionString
Media Owners
Reporting APIIndex UI

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.

topic_version_name
DimensionInteger
Media Owners
Reporting APIIndex UI

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

total_available_pod_duration
MeasureLong
Marketplace PartnersMedia Owners
Reporting APIIndex UI

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.

total_bid_opportunity
MeasureDecimal
Marketplace PartnersMedia OwnersDSPs
Reporting APIIndex UI

Sum of all bid_opportunity responses + ad_spend.

total_bids
MeasureInteger
Marketplace PartnersMedia OwnersDSPs
Reporting APIIndex UI

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

trading_desk_id
Integer
Media Owners
Reporting APIIndex UICAL

The Index identifier for a trading desk that maps to a buyer_name.

vendor_id
DimensionInteger
Marketplace Partners
Reporting APIIndex UI

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

vendor_name
DimensionString
Marketplace Partners
Reporting APIIndex UI

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

video_completion_rate
MeasureInteger
All
Reporting APIIndex UI

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 (VCR):

video_first_quartile
MeasureInteger
All
Reporting APIIndex UI

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

video_midpoint
MeasureInteger
All
Reporting APIIndex UI

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
MeasureInteger
All
Reporting APIIndex UI

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
MeasureInteger
All
Reporting APIIndex UI

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
MeasureInteger
Media Owners
Reporting APIIndex UI

The total number of impressions measured that were viewable as defined by the IAB Viewability Standard.

Note: This metric is only available for Media Owners 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
DimensionString
Media OwnersDSPs
Reporting APIIndex UICAL

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 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 Media Owners, and in the Reporting API for Media Owners and DSPs. It is available for all customer types in CAL.

video_playback_method
DimensionInteger
Media Owners
Reporting APIIndex UICAL

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
video_skippable
DimensionString
Media Owners
Reporting APIIndex UI

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

  • True = Video is skippable
  • False = Video is not skippable
winning_bid_price
MeasureDecimal
BuyersDSPs
Reporting APIIndex UI

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

Note: This field is expressed as the total dollar value, not as eCPM.

xfr_applied
DimensionBoolean
Buyers
Reporting APIIndex UI

Species whether an XFR rate was applied on the transaction.

  • True = XFR was applied.
  • False = XFR was not applied
xfr_savings_amount
MeasureDecimal
Buyers
Reporting APIIndex UI

The savings captured by Media Owners as a result of the XFR program. XFR savings increase the net bid in an auction, and increases a buyer's working media by reducing the Index fee. This can result in higher overall win rates.

zip_postal
String
All
CAL

Zip or postal code.