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 |