Xandr: Most-used fields

Xandr: Most-used fields#

The table below gives information about most-used fields that you can import from Xandr. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

API name

Adverity UI name

Description

Use in Adverity

ad_serving_fees_buying_currency

ad_serving_fees_buying_currency

Total ad serving fees, expressed in the currency used by the buyer for the impression.

metric

advertiser_code

advertiser_code

The custom code assigned to the advertiser.

dimension

advertiser_currency

advertiser_currency

The currency used by the advertiser.

dimension

advertiser_id

advertiser_id

The unique identification number for each advertiser. If the value is 0, either the impression was purchased by an external buyer, or a default or PSA was shown.

dimension

advertiser_name

advertiser_name

The name of the advertiser.

dimension

age_bucket

age_bucket

The bucket for the age of the user.

dimension

age_bucket_id

age_bucket_id

The ID of the age bucket.

dimension

approx_users_count

approx_users_count

The estimated number of unique individuals or devices that have been exposed to advertisements.

metric

ask_price

ask_price

The minimum price that a seller will accept for a given impression or deal.

metric

attributed_pc_revenue

attributed_pc_revenue

Revenue attributed to conversions that occurred after a user interacted with an advertisement, commonly referred to as post-click revenue. This metric is available in reports related to advertiser attributed conversions.

metric

attributed_pv_revenue

attributed_pv_revenue

Revenue attributed to conversions that occurred after a user viewed an advertisement, commonly referred to as post-view revenue. This metric is available in reports related to advertiser attributed conversions.

metric

attributed_revenue

attributed_revenue

The total amount of post-view and post-click attributed revenue.

metric

auction_service_fees_buying_currency

auction_service_fees_buying_currency

Total fees charged for impressions purchased from third parties, expressed in the currency used by the buyer for the transaction.

metric

average_impression_frequency

average_impression_frequency

The average number of times each unique user or device was exposed to advertisements.

metric

bid_rate

bid_rate

The percentage of auctions in which a buyer submitted a bid, representing their participation rate in a deal.

metric

bid_requests

bid_requests

The total number of requests sent to potential buyers (bidders) for an impression opportunity.

metric

bid_sent_no_responses

bid_sent_no_responses

The count of bid responses returned by Xandr where the creative ultimately did not render, often due to an external system selecting a different bid, a user leaving the page, lazy loading, or a video not playing.

metric

bid_type

bid_type

The optimization phase of the bid for an impression.

dimension

bid_type_id

bid_type_id

The unique identifier for the type or optimization phase of a bid, indicating how the bid was placed or optimized for an impression.

dimension

bidder_id

bidder_id

The unique identifier for a Bidder object, which typically represents a Demand-Side Platform (DSP) in the Xandr ecosystem.

dimension

bids

bids

The total number of bids submitted by buyers in response to bid requests for impression opportunities.

metric

billing_currency

billing_currency

The currency used for billing purposes. This can be the buyer’s or seller’s transaction currency.

dimension

billing_period.end_date

billing_period.end_date

The last date of the insertion order’s billing period.

dimension

billing_period.start_date

billing_period.start_date

The earliest date of the insertion order’s billing period.

dimension

billing_period_end_date

billing_period_end_date

The last date of the insertion order’s billing period.

dimension

billing_period_id

billing_period_id

The unique identifier for a specific billing period.

dimension

billing_period_start_date

billing_period_start_date

The earliest date of the insertion order’s billing period.

dimension

booked_revenue

booked_revenue

The net revenue applied on the Line Item that won the impression.

metric

booked_revenue_adv_curr

booked_revenue_adv_curr

The total revenue booked through a direct advertiser, expressed in the currency of that advertiser.

metric

booked_revenue_buying_currency

booked_revenue_buying_currency

The revenue booked by the buyer to purchase this impression, in the buying currency.

metric

booked_revenue_ecpc_buying_currency

booked_revenue_ecpc_buying_currency

The effective cost per click (ECPC) of booked revenue, calculated in the buyer’s currency. Booked revenue refers to the total revenue booked through direct advertisers. The buying currency is the transaction currency used by the buyer.

metric

booked_revenue_ecpm

booked_revenue_ecpm

The effective cost per mille (eCPM) of booked revenue. Booked revenue refers to the total revenue booked through direct advertisers.

dimension

booked_revenue_ecpm_buying_currency

booked_revenue_ecpm_buying_currency

The effective cost per mille (eCPM) of booked revenue, calculated in the buyer’s currency. Booked revenue refers to the total revenue booked through direct advertisers. The buying currency is the transaction currency used by the buyer.

metric

booked_revenue_selling_currency

booked_revenue_selling_currency

The total revenue booked through direct advertisers, calculated in the seller’s currency. The selling currency is the transaction currency used by the seller.

metric

brand_id

brand_id

The unique identifier for a specific brand. This is used in reports like ‘Seller Brand Review Report’ and ‘Publisher Brand Review Report’.

dimension

brand_name

brand_name

The name of the brand. This is used in reports like ‘Seller Brand Review Report’ and ‘Publisher Brand Review Report’.

dimension

buyer_cost_ecpm

buyer_cost_ecpm

The effective cost per mille (eCPM) from the buyer’s perspective.

metric

buyer_cost_per_video_complete

buyer_cost_per_video_complete

The cost incurred by the buyer for each completed video view. This is relevant for ‘Video Analytics’ reports.

metric

buyer_cpc

buyer_cpc

The cost per click (CPC) from the buyer’s perspective, calculated as the total cost divided by the number of clicks.

metric

buyer_cpm

buyer_cpm

The cost per mille (CPM) from the buyer’s perspective, representing the cost per 1000 impressions.

metric

buyer_media_cost

buyer_media_cost

The total media cost incurred by the buyer.

metric

buyer_media_cost_buying_currency

buyer_media_cost_buying_currency

The media cost for the buyer in the buyer’s preferred currency.

metric

buyer_member_id

buyer_member_id

The ID of the buying member.

dimension

buyer_member_name

buyer_member_name

The name of the buying member (e.g., advertiser or DSP) on the Xandr platform.

dimension

buyer_seat_id

buyer_seat_id

The unique identifier for a buyer’s seat, often corresponding to an advertiser ID from their Demand-Side Platform (DSP), used when bidding on impressions.

dimension

buying_currency

buying_currency

The transaction currency used by the buyer to purchase the impression.

dimension

call_type

call_type

dimension

campaign_code

campaign_code

The custom code assigned to the campaign.

dimension

campaign_id

campaign_id

The unique identification number of the campaign.

dimension

campaign_name

campaign_name

The name of the campaign.

dimension

click_conv_rate

click_conv_rate

The rate of conversions to clicks.

metric

click_convs_rate

click_convs_rate

The rate of conversions to clicks.

metric

click_thru_pct

click_thru_pct

The rate of clicks to impressions, expressed as a percentage.

metric

clicks

clicks

The total number of clicks across all impressions. Clicks are deduplicated by auction (maximum 1 click per unique auction) and have a 6-hour TTL.

metric

commissions

commissions

Fees charged for services, typically deducted from revenue or added to costs in a transaction.

metric

commissions_buying_currency

commissions_buying_currency

Commissions incurred, expressed in the currency used by the buyer for the transaction.

metric

completion_rate

completion_rate

The percentage of ad impressions or views that are completed from start to finish. This metric is commonly used to evaluate the effectiveness and engagement level of video advertising campaigns.

metric

conv_rate

conv_rate

The ratio of conversions to impressions.

metric

convs_rate

convs_rate

The rate of conversions to impressions.

metric

cost

cost

The total cost to purchase third-party inventory via a Line Item.

metric

cost_buying_currency

cost_buying_currency

The total media cost for direct publisher and purchased real-time inventory in the currency the buyer used to purchase the inventory.

metric

cost_ecpa

cost_ecpa

The effective cost per acquisition.

metric

cost_ecpa_buying_currency

cost_ecpa_buying_currency

The effective cost per acquisition in the buyer’s currency.

metric

cost_ecpc

cost_ecpc

The effective cost per click.

metric

cost_ecpc_buying_currency

cost_ecpc_buying_currency

The effective cost per click in the buyer’s currency.

metric

cost_per_video_complete

cost_per_video_complete

The cost per video completion.

metric

cost_type

cost_type

dimension

cpa

cpa

The advertiser spend per conversion/acquisition. Calculated as Media cost / Conversions.

metric

cpc

cpc

Cost per click. Calculated as Cost / Clicks.

metric

cpm

cpm

Cost per 1000 impressions. Calculated as Cost / Impressions * 1000.

metric

cpm_buying_currency

cpm_buying_currency

The cost per 1000 impressions (CPM) in the buyer’s currency.

metric

creative_code

creative_code

A custom alphanumeric code assigned to a creative for identification and organization within the Xandr platform.

dimension

creative_id

creative_id

The unique identifier for the creative.

dimension

creative_name

creative_name

The display name of the creative.

dimension

ctr

ctr

Click-through rate. Calculated as Clicks / Impressions.

metric

curated_deal

curated_deal

Indicates if the deal is a curated deal, which provides specialized inventory and targeting options.

dimension

curated_deal_advertiser_id

curated_deal_advertiser_id

The unique identifier for the advertiser associated with a curated deal.

dimension

curated_deal_advertiser_name

curated_deal_advertiser_name

The name of the advertiser associated with a curated deal.

dimension

curated_deal_id

curated_deal_id

The unique identifier for a specific curated deal. This is relevant for ‘Curator Analytics Report’.

dimension

curated_deal_insertion_order_id

curated_deal_insertion_order_id

The unique identifier for the insertion order associated with a curated deal.

dimension

curated_deal_insertion_order_name

curated_deal_insertion_order_name

The name of the insertion order associated with a curated deal.

dimension

curated_deal_line_item_id

curated_deal_line_item_id

The unique identifier for the line item associated with a curated deal.

dimension

curated_deal_line_item_name

curated_deal_line_item_name

The name of the line item associated with a curated deal.

dimension

curated_deal_name

curated_deal_name

The name of the curated deal. This is relevant for ‘Curator Analytics Report’.

dimension

curator_margin

curator_margin

The margin earned by the curator in a curated marketplace. This is relevant for ‘Curator Analytics Report’.

metric

curator_margin_type

curator_margin_type

The specified method or type of margin applied by a curator to profit from curated deals within the marketplace.

dimension

curator_margin_type_filterable

curator_margin_type_filterable

Indicates whether the curator margin type can be used as a filter in reporting or data queries.

metric

curator_member

curator_member

The member acting as a curator in a curated marketplace. This is relevant for ‘Curator Analytics Report’.

dimension

curator_member_id

curator_member_id

The unique identifier for the curator member. This is relevant for ‘Curator Analytics Report’.

dimension

curator_net_media_cost

curator_net_media_cost

The net media cost incurred by the curator, after accounting for various adjustments. This is relevant for ‘Curator Analytics Report’.

metric

curator_revenue

curator_revenue

The revenue generated by the curator in a curated marketplace. This is relevant for ‘Curator Analytics Report’.

metric

curator_tech_fees

curator_tech_fees

Technical fees incurred by the curator. This is relevant for ‘Curator Analytics Report’.

metric

curator_total_cost

curator_total_cost

The total cost incurred by the curator in a curated marketplace. This is relevant for ‘Curator Analytics Report’.

metric

data_costs

data_costs

The costs associated with using third-party data. This is detailed in reports such as the ‘Buyer Data Usage Report’.

metric

data_costs_buying_currency

data_costs_buying_currency

Costs related to usage of data, in the buying currency. This is applicable when specific segments are applied in line items and associated pricing is displayed in the platform.

metric

data_provider_id

data_provider_id

The unique identifier for the data provider. This is relevant for the ‘Buyer Data Usage Report’.

dimension

data_provider_name

data_provider_name

The name of the data provider. This is relevant for the ‘Buyer Data Usage Report’.

dimension

data_type

data_type

The classification of data being reported or processed, such as ‘Segment’ or ‘Cross Device’, particularly relevant in data usage reports.

dimension

day

day

The day of the auction.

dimension

deal_auction_type_name

deal_auction_type_name

The name of the auction type for a specific deal, such as ‘First Price’ or ‘Second Price’. This is relevant for ‘Buyer Deal Metrics’ and ‘Seller Deal Metrics’ reports.

dimension

deal_code

deal_code

A custom code or internal ID used to identify a deal.

dimension

deal_id

deal_id

The ID of the deal.

dimension

deal_name

deal_name

The name of the deal.

dimension

deal_type

deal_type

The type of deal under which an impression was transacted, such as Open Auction, Private Auction, Curated, First Look, or Programmatic Guaranteed.

dimension

deal_type_id

deal_type_id

The unique identifier for the type of deal, which categorizes how an impression was transacted (e.g., Open Auction, Private Auction).

metric

deal_type_name

deal_type_name

The name of the deal type, such as ‘Programmatic Guaranteed’ or ‘Private Auction’. This is relevant for ‘Buyer Deal Metrics’ and ‘Seller Deal Metrics’ reports.

dimension

default_no_responses

default_no_responses

Ad requests where a default creative was sent but no response was received from the end ad server.

metric

device_type

device_type

The type of device on which the impression was served, e.g., ‘mobile’, ‘tablet’, ‘desktop’. This is relevant for ‘Network Device Analytics’ reports.

dimension

ecpa

ecpa

The effective cost per acquisition (conversion).

metric

ecpa_adv_curr

ecpa_adv_curr

The effective cost per acquisition (eCPA) in the advertiser’s currency.

metric

ecpc

ecpc

The effective cost per click.

metric

ecpc_adv_curr

ecpc_adv_curr

The effective cost per click (eCPC) in the advertiser’s currency.

metric

ecpm

ecpm

The effective cost per thousand impressions (eCPM).

metric

ecpm_adv_curr

ecpm_adv_curr

The effective cost per thousand impressions (eCPM) in the advertiser’s currency.

metric

end_date

end_date

The non-inclusive end date for the report data. For hourly data, format is ‘YYYY-MM-DD HH:MM:SS’; for daily, monthly, or yearly data, format is ‘YYYY-MM-DD’.

dimension

external_clicks

external_clicks

Clicks recorded by an external click tracker.

metric

external_imps

external_imps

Impressions recorded by an external impression tracker.

metric

filtered_requests

filtered_requests

Ad requests filtered pre-bid by Xandr for inventory quality.

metric

gender

gender

The gender of the user.

dimension

geo_city_id

geo_city_id

The ID of the user’s city location.

dimension

geo_city_name

geo_city_name

The name of the user’s city location.

dimension

geo_country

geo_country

The geographic country/region code in which the impression took place.

dimension

geo_country_code

geo_country_code

The country code of the user’s location.

dimension

geo_country_id

geo_country_id

The country ID of the user’s location. 250 is shown when the country is unknown or doesn’t map correctly.

dimension

geo_country_name

geo_country_name

The name of the geographic country/region.

dimension

geo_dma

geo_dma

The Designated Market Area (DMA) associated with the impression’s user, based on IP geolocation.

dimension

geo_dma_id

geo_dma_id

The ID of the user’s Designated Market Area (DMA) location.

dimension

geo_dma_name

geo_dma_name

The name of the user’s Designated Market Area (DMA) location.

dimension

geo_postal_code

geo_postal_code

The postal code of the user’s geographical location.

dimension

geo_region

geo_region

The region of the user’s location.

dimension

geo_region_code

geo_region_code

The region code of the user’s location.

dimension

geo_region_id

geo_region_id

The region ID of the user’s location. 4291 is shown when the region is unknown or doesn’t map correctly.

dimension

geo_region_name

geo_region_name

The name of the region of the user’s location.

dimension

gross_win_rate

gross_win_rate

The ratio of impressions won to the total number of impressions that matched targeting settings, expressed as a percentage.

metric

hour

hour

The hour of the auction. For impressions older than 100 days, the day will be returned instead of the hour.

dimension

imp_type

imp_type

The type of impression (e.g., Blank, PSA, Default Error, Kept, Resold, RTB).

dimension

imp_type_id

imp_type_id

The ID for the type of impression.

dimension

imps

imps

The total number of impressions recorded (served and resold).

metric

imps_matched

imps_matched

The total count of available impressions that successfully matched the deal’s targeting settings and buyer’s acceptance status.

metric

imps_resold

imps_resold

The number of impressions that were resold through direct publishers.

metric

imps_viewed

imps_viewed

The number of measured impressions that were viewable according to the IAB Viewability definition.

metric

imps_won

imps_won

The total number of impressions for which a bid successfully won the auction.

metric

ineligible_bid_rate

ineligible_bid_rate

The percentage of bids that were rejected or deemed ineligible for a deal, calculated as the count of rejected bids divided by the total bids.

metric

insertion_order_code

insertion_order_code

The custom code associated with the insertion order.

dimension

insertion_order_id

insertion_order_id

The unique identification number of the insertion order.

dimension

insertion_order_name

insertion_order_name

The name of the insertion order.

dimension

inventory_source

inventory_source

The source or type of inventory where ads are displayed (e.g., web, mobile web, mobile app).

dimension

inventory_source_id

inventory_source_id

The ID of the external inventory source defined by the publisher.

dimension

inventory_source_name

inventory_source_name

The name of the external inventory source defined by the publisher.

dimension

line_item.type

line_item.type

The type of the line item, which defines how ads are delivered and priced within a campaign.

dimension

line_item_code

line_item_code

The custom code for the line item.

dimension

line_item_id

line_item_id

The unique identification number of the line item.

dimension

line_item_name

line_item_name

The name of the line item.

dimension

media_cost

media_cost

The media cost for the buyer.

metric

media_cost_advertiser_currency

media_cost_advertiser_currency

The media cost for the buyer in the advertiser’s preferred currency.

metric

media_cost_buying_currency

media_cost_buying_currency

This field represents the currency used by the buyer (advertiser) for media costs within the Xandr platform.

metric

media_type

media_type

The general display style of the creative (e.g., Banner, Pop, Interstitial, Video, Text).

dimension

media_type_id

media_type_id

The ID of the media type.

metric

mediatype

mediatype

The general display style of the creative.

dimension

mediatype_id

mediatype_id

The ID of the media type to which the subtype belongs.

dimension

member_currency

member_currency

The currency symbol representing one of the currencies used by a member’s active publishers.

dimension

member_id

member_id

The unique identification number of the member.

dimension

metric_type

metric_type

The classification of a metric used to measure the performance of campaigns or deals.

metric

mobile_application_id

mobile_application_id

The unique identifier for a mobile application to which an ad request’s bundle was mapped.

dimension

mobile_application_name

mobile_application_name

The name of the mobile application to which an ad request’s bundle was mapped.

dimension

month

month

The month of the auction.

dimension

net_win_rate

net_win_rate

The rate of impressions won compared to the total number of bids made by the buyer for a deal.

metric

network_profit_buying_currency

network_profit_buying_currency

The profit generated across the network, calculated in the buyer’s currency. This is available in ‘Network Analytics’ reports.

metric

package_id

package_id

The unique identifier for a package from which a deal was created. This value is 0 if the deal was not associated with a package.

dimension

partner_fees

partner_fees

Fees incurred for third-party services, distinct from publisher costs, that are budgeted and tracked, such as ad serving, creative hosting, data, or post-bid reporting fees.

metric

partner_fees_buying_currency

partner_fees_buying_currency

Partner fees expressed in the currency used by the buyer for the transaction.

metric

placement_code

placement_code

The custom code for the placement.

dimension

placement_group_id

placement_group_id

The unique identifier for a placement group, which serves as a hierarchical organizer for placements within the sell-side structure.

dimension

placement_group_name

placement_group_name

The user-defined name for a placement group, used to identify and organize a collection of placements.

dimension

placement_id

placement_id

The unique identifier for the placement where the ad was served.

dimension

placement_name

placement_name

The name of the placement where the ad was served.

dimension

post_click_convs

post_click_convs

The total number of recorded post-click conversions.

metric

post_click_convs_rate

post_click_convs_rate

The rate of post-click conversions relative to impressions.

metric

post_click_revenue

post_click_revenue

The total revenue generated from post-click conversions.

metric

post_view_convs

post_view_convs

The total number of recorded post-view conversions.

metric

post_view_convs_rate

post_view_convs_rate

The rate of post-view conversions relative to impressions.

metric

post_view_revenue

post_view_revenue

The total revenue generated from post-view conversions.

metric

priority

priority

The bid priority assigned to a deal or campaign, influencing its competitiveness in an auction, typically on a scale from 1 (lowest) to 10 (highest).

dimension

profit_advertiser_currency

profit_advertiser_currency

The calculated profit expressed in the advertiser’s local currency.

metric

profit_buying_currency

profit_buying_currency

The buyer’s profit, expressed in the buying currency.

metric

profit_ecpa

profit_ecpa

The effective profit per acquisition.

metric

profit_ecpc

profit_ecpc

The effective profit per click.

metric

profit_ecpm

profit_ecpm

The profit per 1000 impressions (eCPM), calculated as booked revenue minus total cost per 1000 impressions.

metric

profit_ecpm_buying_currency

profit_ecpm_buying_currency

The effective profit per 1000 impressions in the buying currency.

metric

profit_margin

profit_margin

The buyer’s profit margin, calculated as (booked revenue - total cost) / booked revenue.

metric

profit_selling_currency

profit_selling_currency

The profit generated, calculated in the seller’s currency. Profit is a standard metric available in many reports. The selling currency is the transaction currency used by the seller.

metric

psas_or_blanks

psas_or_blanks

The count of Public Service Announcements (PSAs) or blank creatives served when no other eligible ad was available.

metric

publisher_code

publisher_code

The custom code to identify the publisher.

dimension

publisher_currency

publisher_currency

The currency used by the publisher.

dimension

publisher_id

publisher_id

The unique identification number of the publisher.

dimension

publisher_name

publisher_name

The name of the publisher.

dimension

revenue

revenue

The total net revenue.

metric

revenue_buying_currency

revenue_buying_currency

Revenue generated, expressed in the buying currency.

metric

revenue_ecpa

revenue_ecpa

The effective revenue per acquisition.

metric

revenue_ecpa_buying_currency

revenue_ecpa_buying_currency

The effective revenue per acquisition in the buying currency.

metric

revenue_ecpc

revenue_ecpc

The effective revenue per click.

metric

revenue_ecpc_buying_currency

revenue_ecpc_buying_currency

The effective revenue per click in the buying currency.

metric

revenue_ecpm

revenue_ecpm

The effective revenue per 1000 impressions (eCPM).

metric

revenue_ecpm_buying_currency

revenue_ecpm_buying_currency

The effective revenue per 1000 impressions in the buying currency.

metric

revenue_per_video_complete

revenue_per_video_complete

The revenue per video completion.

metric

revenue_selling_currency

revenue_selling_currency

The total revenue earned, calculated in the seller’s currency. Revenue is a standard metric available across various report types. The selling currency is the transaction currency used by the seller.

metric

revenue_type

revenue_type

The classification of how revenue is recorded and generated, such as CPM (Cost Per Mille) or CPA (Cost Per Acquisition), used in line item setup.

dimension

rpm

rpm

Revenue per mille (RPM), representing the revenue earned per 1,000 impressions or ad requests.

metric

sales_tax

sales_tax

Applicable sales, value-added, goods and services, or similar transaction taxes applied based on the customer’s account business location.

dimension

segment_code

segment_code

A user-defined unique identifier for a segment, allowing data providers to use their own identifiers within the Xandr backend for segment management.

dimension

segment_id

segment_id

The unique numerical identifier assigned by the Xandr API to reference a specific segment.

dimension

segment_name

segment_name

The descriptive name assigned to a segment, used for identification and display.

dimension

seller_deal

seller_deal

Indicates if the deal is a seller-side deal. This is relevant for ‘Seller Deal Metrics’ reports.

dimension

seller_deal_id

seller_deal_id

The unique identifier for a specific seller deal. This is relevant for ‘Seller Deal Metrics’ reports.

dimension

seller_deal_name

seller_deal_name

The name of the seller deal. This is relevant for ‘Seller Deal Metrics’ reports.

dimension

seller_deal_type_id

seller_deal_type_id

The unique identifier for the type of seller deal.

dimension

seller_deal_type_name

seller_deal_type_name

The name of the type of seller deal. This is relevant for ‘Seller Deal Metrics’ reports.

dimension

seller_member_id

seller_member_id

The ID of the selling member.

dimension

seller_member_name

seller_member_name

The name of the selling member.

dimension

seller_revenue

seller_revenue

The revenue earned by the seller. Revenue is a standard metric available across various report types.

metric

seller_type

seller_type

The type of selling relationship between the member and Xandr (e.g., “platform”, “partner”).

dimension

service_fees_buying_currency

service_fees_buying_currency

DSP Service fee charged to buying members, expressed in the currency used by the buyer.

metric

serving_fees

serving_fees

Fees incurred for the delivery of ad creatives, charged for ad serving.

metric

serving_fees_buying_currency

serving_fees_buying_currency

Total ad serving fees, expressed in the currency used by the buyer for the impression.

metric

site_domain

site_domain

The domain of the website where the ad was served. This is available in reports such as ‘Network Site Domain Performance’ and ‘Site Domain Performance Report’.

dimension

site_id

site_id

The unique identifier for a specific website (site) where ads are served. This is a common dimension in many reports.

dimension

site_name

site_name

The name of the site.

dimension

split_id

split_id

The ID of the split that purchased the impressions in this data set. Splits are only applicable to augmented line items.

dimension

split_name

split_name

The name of the split that purchased the impressions in this data set. Splits are only applicable to augmented line items.

dimension

start_date

start_date

The start date for the report data. For hourly data, format is ‘YYYY-MM-DD HH:MM:SS’; for daily, monthly, or yearly data, format is ‘YYYY-MM-DD’.

dimension

submitted_bids

submitted_bids

The total count of bids submitted by buyers in an auction.

metric

supply_type

supply_type

The type of inventory (e.g., web, mobile_web, mobile_app).

dimension

targeted_segment_ids

targeted_segment_ids

A list of unique identifiers for segments that were targeted. This is relevant for reports like ‘Buyer Segment Performance Report’ and ‘Curator Segment Performance Report’.

dimension

total_ad_requests

total_ad_requests

The aggregate number of ad requests sent to Xandr for auction opportunities.

metric

total_ad_responses

total_ad_responses

The aggregate number of ad responses recorded within the Xandr platform.

metric

total_convs

total_convs

The total number of post-view and post-click conversions.

metric

total_cost

total_cost

The total amount of costs accrued over the reported period of time. This generally includes budgeted costs (media cost, data cost, partner fees, serving fees, commissions) and publisher revenue if tracking publisher payouts.

metric

total_cost_buying_currency

total_cost_buying_currency

The total sum of media costs, data costs, and partner fees in the buying (advertiser) currency.

metric

total_cost_ecpa

total_cost_ecpa

The total effective cost per acquisition.

metric

total_cost_ecpc

total_cost_ecpc

The total effective cost per click.

metric

total_cost_ecpm

total_cost_ecpm

The total effective cost per 1000 impressions (eCPM).

metric

total_cost_selling_currency

total_cost_selling_currency

The total cost incurred, calculated in the seller’s currency. Cost is a standard metric available across various report types. The selling currency is the transaction currency used by the seller.

metric

total_revenue

total_revenue

The total net revenue.

metric

total_segment_data_costs

total_segment_data_costs

The total costs associated with using segment data. This is relevant for the ‘Buyer Data Usage Report’.

metric

total_segment_data_costs_buying_currency

total_segment_data_costs_buying_currency

The total costs associated with using segment data, calculated in the buyer’s currency. This is relevant for the ‘Buyer Data Usage Report’.

metric

vendor

vendor

The name or identifier of a third-party vendor providing data or services. This is relevant for the ‘Vendor Usage Report’.

dimension

vendor_costs

vendor_costs

The costs associated with services or data from a third-party vendor. This is relevant for the ‘Vendor Usage Report’.

dimension

vendor_costs_buying_currency

vendor_costs_buying_currency

The costs associated with services or data from a third-party vendor, calculated in the buyer’s currency. This is relevant for the ‘Vendor Usage Report’.

dimension

vendor_id

vendor_id

The unique identifier for a third-party vendor. This is relevant for the ‘Vendor Usage Report’.

dimension

vendor_name

vendor_name

The name of a third-party vendor. This is relevant for the ‘Vendor Usage Report’.

dimension

vendor_type

vendor_type

The classification of a third-party vendor based on the type of data or services it provides.

dimension

video_25_pcts

video_25_pcts

The total number of times the video creatives completed 25% of the entire duration.

dimension

video_50_pcts

video_50_pcts

The total number of times the video creatives completed 50% of the entire duration.

dimension

video_75_pcts

video_75_pcts

The total number of times the video creatives completed 75% of the entire duration.

dimension

video_completion_rate

video_completion_rate

The ratio of video completions to impressions, expressed as a percentage.

metric

video_completions

video_completions

The total number of times the video creatives played for the entire duration.

metric

video_default_errors

video_default_errors

Errors encountered when a video ad defaults, often due to technical issues. This is relevant for ‘Video Analytics’ reports.

metric

video_errors

video_errors

The total number of times a video error occurred.

metric

video_player_errors

video_player_errors

Errors originating from the video player during ad playback. This is relevant for ‘Video Analytics’ reports.

metric

video_served

video_served

The total number of video responses served to the player. An ad response occurs when the VAST document (XML) is served in response to a request.

dimension

video_skip_rate

video_skip_rate

The percentage of times the user opted to skip the video.

metric

video_skips

video_skips

The total number of times a user skipped the video.

metric

video_start_rate

video_start_rate

The percentage of times the first segment of the video creative was downloaded and started.

metric

video_starts

video_starts

The total number of times the first segment of the video creative was downloaded and started.

metric

view_measured_imps

view_measured_imps

The total number of impressions that were measured for viewability.

metric

view_measurement_rate

view_measurement_rate

The percentage of impressions measured for viewability out of the total number of impressions. Calculated as (View Measured Imps / Imps).

metric

view_rate

view_rate

The percentage of impressions that were viewable out of the total number of impressions measured for viewability. Calculated as (Viewed Imps / View Measured Imps).

metric

viewed_imps

viewed_imps

The number of viewable impressions, meaning the ad was considered viewable by industry standards. This is relevant for reports providing ad viewability information, such as the ‘Engagement Metrics Report’.

metric