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 |
ad_serving_fees |
General fees related to the delivery and display of advertisements across the Xandr platform. This metric is often included in network-wide billing or analytics reports. |
metric |
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 |
approximate_consumer_count |
approximate_consumer_count |
The approximate number of unique consumers who viewed an impression due to cross-device audience extension. |
metric |
approximate_incremental_devices |
approximate_incremental_devices |
The total number of unique cookies, mobile devices, or other device types reached by the impressions. |
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 |
auction_service_fees |
The fees charged to a buyer for participating in real-time bidding (RTB) auctions, as specified in the buyer member’s contract. This is often referred to as the Buyer Auction Service Charge (BASC). |
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 |
bids |
bids |
The total number of bids submitted by buyers in response to bid requests for impression opportunities. |
metric |
billable_buyer_imps |
billable_buyer_imps |
The number of impressions delivered on behalf of a buyer for which the buyer will be billed. This is a key metric in financial reconciliation reports. |
metric |
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_ad_serving_fees |
buyer_ad_serving_fees |
Fees charged to the buyer for the ad serving function, which are additional to the media cost. This often relates to the Buyer Auction Service Charge (BASC) for impressions bought from third parties. |
metric |
buyer_cost_ecpm |
buyer_cost_ecpm |
The effective cost per mille (eCPM) from the buyer’s perspective. |
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 (advertiser or agency) associated with the reported data. |
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_billing_trx_type_id |
buying_billing_trx_type_id |
An identifier for the type of transaction within the buying billing process, which may be related to different impression types or financial events. |
dimension |
buying_currency |
buying_currency |
The transaction currency used by the buyer to purchase the impression. |
dimension |
buying_imp_type |
buying_imp_type |
The descriptive name for the type of impression from the buyer’s perspective, such as Resold, RTB, or External Impression. |
dimension |
buying_imp_type_id |
buying_imp_type_id |
The unique identifier for the type of impression from the buyer’s perspective, corresponding to specific impression categories like Resold or RTB. |
dimension |
call_type |
call_type |
This field indicates the type of ad request or bid call, such as OpenRTB2 or Prebid, which influences how impressions are recorded and processed. |
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_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_per_mm |
convs_per_mm |
The total number of conversions recorded per million impressions served. |
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 |
Defines the method by which advertising costs are calculated, such as Cost Per Acquisition (CPA), Cost Per Click (CPC), or Cost Per Mille (CPM - cost per 1000 impressions). |
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_hosting_deductions |
creative_hosting_deductions |
metric |
|
creative_hosting_fees |
creative_hosting_fees |
Fees incurred by the buyer for hosting creative assets, typically charged when creative sizes or usage exceed predefined limits. |
metric |
creative_id |
creative_id |
The unique identifier for the creative. |
dimension |
creative_name |
creative_name |
The display name of the creative. |
dimension |
creative_overage_fees |
creative_overage_fees |
Charges incurred when hosted creative assets exceed specified size limits or usage thresholds. |
metric |
creative_overage_fees_buying_currency |
creative_overage_fees_buying_currency |
Charges incurred when hosted creative assets exceed specified size limits or usage thresholds, expressed in the transaction currency used by the buyer. |
metric |
cross_device_incremental_imps |
cross_device_incremental_imps |
The number of impressions delivered on devices outside of the targeted segments, attributed to cross-device audience extension through a cross-device graph. |
metric |
ctr |
ctr |
Click-through rate. Calculated as Clicks / Impressions. |
metric |
curated_deal |
curated_deal |
Curated deals represent a negotiated agreement between a buyer and a curator, combining proprietary assets like audience data or preferred inventory access with Xandr Marketplace supply to create unique offerings. |
dimension |
curated_deal_id |
curated_deal_id |
This field represents the unique identifier assigned to a specific curated deal, used for targeting and reporting purposes within the Xandr platform. |
dimension |
data_costs |
data_costs |
This field represents the aggregated monetary value of costs associated with using third-party data segments and services in ad campaigns. These costs are incurred when third-party data is used to target users and win an impression. |
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 |
This field represents the unique identifier for a third-party data provider whose data segments are utilized in advertising campaigns. |
dimension |
data_provider_name |
data_provider_name |
This field provides the display name of the third-party data provider whose data segments are used in advertising campaigns. |
dimension |
data_type |
data_type |
This field indicates the category or classification of the data being used, with common types including ‘Segment’ for user segments and ‘Cross Device’ for cross-device targeting. |
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 |
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 |
estimated_people_reach |
estimated_people_reach |
The estimated number of people reached, deduplicated across user-specified dimensions. This metric is currently available in the US only. |
metric |
exchange |
exchange |
dimension |
|
exchange_cost |
exchange_cost |
The cost associated with inventory acquired through the Xandr ad exchange. |
metric |
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_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. |
dimension |
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_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 |
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 |
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_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_auction_discount |
post_auction_discount |
metric |
|
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 |
pricing_media_type_id |
pricing_media_type_id |
A unique identifier for the video-specific media type classification, primarily used for billing purposes. |
dimension |
pricing_media_type_name |
pricing_media_type_name |
The descriptive name corresponding to the pricing media type ID, classifying the media type (e.g., video, display) relevant for billing. |
dimension |
priority |
priority |
Determines the order in which an order line consumes ad capacity, as configured in the ad server. This field can be used to filter data based on priority levels (e.g., PRIORITY>=5). |
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 |
This field represents any applicable sales, value-added, goods and services, or similar transaction taxes that are applied to transactions within the Xandr platform. |
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_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 |
service_fees |
General charges applied for various services provided within the platform, which can include a combination of different operational or ad serving fees. |
metric |
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_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_feature_costs |
total_feature_costs |
The cumulative costs associated with using specific features or functionalities provided by Xandr or third-party vendors, as detailed in the Vendor Usage Report. |
metric |
total_revenue |
total_revenue |
The total net revenue. |
metric |
total_segment_data_costs |
total_segment_data_costs |
The aggregated costs incurred for utilizing third-party user segment data in targeting, as reported in the Data Usage and Vendor Usage Reports. |
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 |
unidentified_imps |
unidentified_imps |
The total number of impressions where a cookie, device ID, or other identifying information was not included in the ad request. |
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. |
metric |
video_50_pcts |
video_50_pcts |
The total number of times the video creatives completed 50% of the entire duration. |
metric |
video_75_pcts |
video_75_pcts |
The total number of times the video creatives completed 75% of the entire duration. |
metric |
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. |
metric |
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 |