Introduction

Datasources and destinations

Fields listing for Xandr

Hour
The hour of the auction.Note: For impressions older than 100 days, the day will be returned rather than the hour.
Field IDhour
TypeTEXT
Data Typedimension
Day
The day of the auction.
Field IDday
TypeTEXT
Data Typedimension
Month
The month of the auction.
Field IDmonth
TypeTEXT
Data Typedimension
Adjustment Id
The unique identification number of the adjustment used to make changes to the media cost and/or impressions, clicks, and conversions you see in reporting for a publisher.
Field IDadjustment_id
TypeTEXT
Data Typedimension
Advertiser Code
The custom code for the advertiser.
Field IDadvertiser_code
TypeTEXT
Data Typedimension
Advertiser Currency
The type of money used by the advertiser.
Field IDadvertiser_currency
TypeTEXT
Data Typedimension
Advertiser Id
The unique identification number for each advertiser.
Field IDadvertiser_id
TypeTEXT
Data Typedimension
Buyer Member Id
The unique identification number for the buyer member.
Field IDbuyer_member_id
TypeTEXT
Data Typedimension
Seller Member Id
The unique identification number of the selling member.
Field IDseller_member_id
TypeTEXT
Data Typedimension
Seller Member Name
The name of the selling member.
Field IDseller_member_name
TypeTEXT
Data Typedimension
Seller Member
Deprecated (as of October 17, 2016).
Field IDseller_member
TypeTEXT
Data Typedimension
Campaign Id
The unique identification number of the campaign.
Field IDcampaign_id
TypeTEXT
Data Typedimension
Campaign Name
The name of the campaign.
Field IDcampaign_name
TypeTEXT
Data Typedimension
Campaign
Deprecated (as of October 17, 2016).
Field IDcampaign
TypeTEXT
Data Typedimension
Campaign Code
The custom code for the campaign.
Field IDcampaign_code
TypeTEXT
Data Typedimension
Campaign Priority
The bid priority of a campaign that is targeting direct inventory. The scale is from 1-10, with 1 being lowest and 10 being highest.
Field IDcampaign_priority
TypeTEXT
Data Typedimension
Split Id
The ID of the split that purchased the impressions in this data set. Splits are only applicable to augmented line items. For any reports that contain campaigns, the split_id (if included) will be null.
Field IDsplit_id
TypeTEXT
Data Typedimension
Split Name
The name of the split that purchased the impressions in this data set. Splits are only applicable to augmented line items. For any reports that contain campaigns, the split_name (if included) will be null.
Field IDsplit_name
TypeTEXT
Data Typedimension
Creative Id
The unique identification number of the creative.Note:- For impressions older than 14 months, creatives will be aggregated into one row with 0 as the creative_id.- For external click or impression trackers, creative_id will be "External Clicks" or "External Imps".
Field IDcreative_id
TypeTEXT
Data Typedimension
Creative Name
The display name of the creative.Note:- For impressions older than 14 months, creatives will be aggregated into one row with "All creative data older than 14 months" as the creative_name.- For external click or impression trackers, creative_name will be "External Clicks" or "External Imps".
Field IDcreative_name
TypeTEXT
Data Typedimension
Creative
Deprecated (as of October 17, 2016).
Field IDcreative
TypeTEXT
Data Typedimension
Placement Id
The unique identification number of the placement.Note:- For impressions older than 14 months, placements will be aggregated into one row with -1 as the placement_id.
Field IDplacement_id
TypeTEXT
Data Typedimension
Placement Name
The name of the placement.Note: For impressions older than 14 months, placements will be aggregated into one row with "All placement data older than 100 days" as the placement_name.
Field IDplacement_name
TypeTEXT
Data Typedimension
Placement
Deprecated (as of October 17, 2016).
Field IDplacement
TypeTEXT
Data Typedimension
Deal Id
The ID of the deal. For more information about deals you have negotiated with sellers, see Deal Buyer Access Service.
Field IDdeal_id
TypeTEXT
Data Typedimension
Deal Name
The name of the deal.
Field IDdeal_name
TypeTEXT
Data Typedimension
Deal
Deprecated (as of October 17, 2016).
Field IDdeal
TypeTEXT
Data Typedimension
Deal Code
The custom code for the deal. For deals with external supply partners, this is generally the string that you use to identify the deal.
Field IDdeal_code
TypeTEXT
Data Typedimension
Placement Code
The custom code for the placement.
Field IDplacement_code
TypeTEXT
Data Typedimension
Size
The size of the placement/creative served.
Field IDsize
TypeTEXT
Data Typedimension
Geo Country
The code for the geographic country or region.
Field IDgeo_country
TypeTEXT
Data Typedimension
Geo Country Name
The name of the geographic country or region.
Field IDgeo_country_name
TypeTEXT
Data Typedimension
Creative Recency Bucket
Deprecated. If you request this dimension, only a default value will be returned. Use the Advertiser Creative Frequency & Recency report to view creative recency data.
Field IDcreative_recency_bucket
TypeTEXT
Data Typedimension
Creative Recency Bucket Id
Deprecated. If you request this dimension, only a default value will be returned. Use the Advertiser Creative Frequency & Recency report to view creative recency data.
Field IDcreative_recency_bucket_id
TypeTEXT
Data Typedimension
Creative Frequency Bucket
Deprecated. If you request this dimension, only a default value will be returned. Use the Advertiser Creative Frequency & Recency report to view creative frequency data.
Field IDcreative_frequency_bucket
TypeTEXT
Data Typedimension
Creative Frequency Bucket Id
Deprecated. If you request this dimension, only a default value will be returned. Use the Advertiser Creative Frequency & Recency report to view creative frequency data.
Field IDcreative_frequency_bucket_id
TypeTEXT
Data Typedimension
Gender
The gender of the user.Note:For impressions older than 100 days, the gender will be "u".The value of the gender is defined by the publisher in the bid request. Xandr does not have control over it apart from processing the value.
Field IDgender
TypeTEXT
Data Typedimension
Imp Type Id
The ID for the type of impression. Possible values (associated types in parentheses):- 1 ("Blank"): No creative served.- 2 ("PSA"): A public service announcement served because there were no valid bids and no default creative was available.- 3 ("Default Error"): A default creative served due to a timeout issue.- 4 ("Default"): A default creative served because there were no valid bids.- 5 ("Kept"): Your advertiser's creative served on your publisher's site.- 6 ("Resold"): Your publisher's impression was sold to a third-party buyer.- 7 ("RTB"): Your advertiser's creative served on third-party inventory.- 8 ("PSA Error"): A public service announcement served due to a timeout issue or lack of a default creative.- 9 ("External Impression"): An impression from an impression tracker.- 10 ("External Click"): A click from a click tracker.
Field IDimp_type_id
TypeTEXT
Data Typedimension
Imp Type
The type of impression. For possible values, see imp_type_id.
Field IDimp_type
TypeTEXT
Data Typedimension
Bid Type
The optimization phase the node was in when it bid for this impression.Note: The term "give up" is appended to the bid types below if the valuation for that impression falls below the venue's "give up price". Allowed values:- "Manual": Applies when you are bidding with a CPM goal, whether it's Base, EAP, or ECP.- "Learn": Applies when you are bidding with optimization (CPA, CPC, or margin) and we do not yet have enough data to bid optimized.- "Optimized": Applies when you are bidding with optimization (CPA, CPC, or margin) and we have enough data to bid optimized.- "Unknown": The node was in an unknown optimization phase.- "Optimized give up"- "Learn give up"- "Manual give up"
Field IDbid_type
TypeTEXT
Data Typedimension
Insertion Order Id
The unique identification number of the insertion order.
Field IDinsertion_order_id
TypeTEXT
Data Typedimension
Insertion Order Name
The name of the insertion order.
Field IDinsertion_order_name
TypeTEXT
Data Typedimension
Insertion Order
Deprecated (as of October 17, 2016).
Field IDinsertion_order
TypeTEXT
Data Typedimension
Insertion Order Code
The custom code for the insertion order.
Field IDinsertion_order_code
TypeTEXT
Data Typedimension
Line Item Id
The unique identification number of the line item.
Field IDline_item_id
TypeTEXT
Data Typedimension
Line Item Name
The name of the line item.
Field IDline_item_name
TypeTEXT
Data Typedimension
Line Item
Deprecated (as of October 17, 2016).
Field IDline_item
TypeTEXT
Data Typedimension
Line Item Code
The custom code for the line item.
Field IDline_item_code
TypeTEXT
Data Typedimension
Supply Type
The type of inventory. Possible values:- "web"- "mobile_web"- "mobile_app".
Field IDsupply_type
TypeTEXT
Data Typedimension
Pixel Id
The unique identification number of the conversion pixel.Note: This dimension will return a maximum of 10 conversion pixels. Also, you can filter by no more than 10 conversion pixels.
Field IDpixel_id
TypeTEXT
Data Typedimension
Publisher Id
The unique identification number of the publisher.
Field IDpublisher_id
TypeTEXT
Data Typedimension
Publisher Name
The name of the publisher.
Field IDpublisher_name
TypeTEXT
Data Typedimension
Publisher
Deprecated (as of October 17, 2016).
Field IDpublisher
TypeTEXT
Data Typedimension
Publisher Code
The custom code for the publisher.
Field IDpublisher_code
TypeTEXT
Data Typedimension
Seller Type
The seller type.
Field IDseller_type
TypeTEXT
Data Typedimension
Media Type
The general display style of the creative. You can use the Media Type Service to view the complete list of media types.
Field IDmedia_type
TypeTEXT
Data Typedimension
Mediatype Id
The unique identification number of the media type to which the subtype belongs.
Field IDmediatype_id
TypeTEXT
Data Typedimension
User Group For Campaign
The test/control user group for the campaign. See the "labels" field in the Campaign Service for more details.
Field IDuser_group_for_campaign
TypeTEXT
Data Typedimension
Venue
The name of the cluster of domain, site, tag, and user country/region that Xandr' optimization system uses to determine bid valuations. A campaign cannot target a venue explicitly.
Field IDvenue
TypeTEXT
Data Typedimension
Billing Period Start Date
The earliest date of the insertion order's billing period.Note: Alpha-Beta NoticeThis field or feature is part of functionality currently in either Alpha or Beta phase. It is therefore subject to change.
Field IDbilling_period_start_date
TypeYEAR_MONTH_DAY
Data Typedimension
Billing Period End Date
The last date of the insertion order's billing period.Note: Alpha-Beta NoticeThis field or feature is part of functionality currently in either Alpha or Beta phase. It is therefore subject to change.
Field IDbilling_period_end_date
TypeYEAR_MONTH_DAY
Data Typedimension
Billing Period External Code
The custom code for the billing period (budget_interval).
Field IDbilling_period_external_code
TypeTEXT
Data Typedimension
Imps
The total number of impressions served.
Field IDimps
TypeTEXT
Data Typemetric
Attributed Revenue
The amount of revenue from all recorded post views and post clicks.
Field IDattributed_revenue
TypeTEXT
Data Typemetric
Attributed Pc Revenue
The amount of revenue from all recorded post views.
Field IDattributed_pc_revenue
TypeTEXT
Data Typemetric
Attributed Pv Revenue
The amount of revenue from all recorded post clicks.
Field IDattributed_pv_revenue
TypeTEXT
Data Typemetric
Clicks
The total number of clicks across all impressions.
Field IDclicks
TypeTEXT
Data Typemetric
Click Convs Rate
The rate of conversions to clicks.
Field IDclick_convs_rate
TypeTEXT
Data Typemetric
Click Conv Rate
The rate of conversions to clicks.Note: This field is identical to click_convs_rate.
Field IDclick_conv_rate
TypeTEXT
Data Typemetric
Click Thru Pct
The percentage of users viewing a creative that clicked on it.
Field IDclick_thru_pct
TypeTEXT
Data Typemetric
Cpa
The cost per acquisition.
Field IDcpa
TypeTEXT
Data Typemetric
Cpc
The cost per click.
Field IDcpc
TypeTEXT
Data Typemetric
Cpm
The cost per 1,000 impressions.
Field IDcpm
TypeTEXT
Data Typemetric
Post View Convs
The total number of recorded post view conversions.
Field IDpost_view_convs
TypeTEXT
Data Typemetric
Post View Revenue
The total amount of recorded post view revenue.
Field IDpost_view_revenue
TypeTEXT
Data Typemetric
Post Click Convs
The total number of recorded post click conversions.
Field IDpost_click_convs
TypeTEXT
Data Typemetric
Post Click Revenue
The total amount of recorded post click revenue.
Field IDpost_click_revenue
TypeTEXT
Data Typemetric
Total Revenue
The total amount of post view and post click revenue.
Field IDtotal_revenue
TypeTEXT
Data Typemetric
Total Convs
The total number of post view and post click conversions.
Field IDtotal_convs
TypeTEXT
Data Typemetric
Conv Rate
The rate of post click and post view conversions to impressions.
Field IDconv_rate
TypeTEXT
Data Typemetric
Convs Rate
The rate of conversions to impressions.
Field IDconvs_rate
TypeTEXT
Data Typemetric
Convs Per Mm
The number of conversions per million impressions.
Field IDconvs_per_mm
TypeTEXT
Data Typemetric
Ecpa Adv Curr
The cost per acquisition in the advertiser currency type.
Field IDecpa_adv_curr
TypeTEXT
Data Typemetric
Ecpc Adv Curr
The cost per click in the advertiser currency type.
Field IDecpc_adv_curr
TypeTEXT
Data Typemetric
Ecpm Adv Curr
The cost per 1,000 impressions in the advertiser currency type.
Field IDecpm_adv_curr
TypeTEXT
Data Typemetric
Post View Convs Rate
The rate of post view conversions to impressions.
Field IDpost_view_convs_rate
TypeTEXT
Data Typemetric
Post Click Convs Rate
The rate of post click conversions to impressions.
Field IDpost_click_convs_rate
TypeTEXT
Data Typemetric
Post Click Conversion Pixel
The number of post click conversions for a specific pixel. For more information on how we attribute post-view (and other) conversions, Conversion Attribution (Monetize) or Conversion Attribution (Invest).
Field IDpost_click_conversion_pixel
TypeTEXT
Data Typemetric
Post Click Revenue Pixel
The amount of revenue earned for a specific pixel.
Field IDpost_click_revenue_pixel
TypeTEXT
Data Typemetric
Post View Conversion Pixel
The number of post view conversions for a specific pixel. For more information on how we attribute post-view (and other) conversions, see Conversion Attribution (Monetize) or Conversion Attribution (Invest).
Field IDpost_view_conversion_pixel
TypeTEXT
Data Typemetric
Post View Revenue Pixel
The amount of revenue earned for a specific pixel.
Field IDpost_view_revenue_pixel
TypeTEXT
Data Typemetric
Ppm
The profit per 1000 impressions.
Field IDppm
TypeTEXT
Data Typemetric
Rpm
The revenue per 1000 impressions.
Field IDrpm
TypeTEXT
Data Typemetric
Spend Adv Curr
The total amount spent by the advertiser in the advertiser's preferred currency.
Field IDspend_adv_curr
TypeTEXT
Data Typemetric
Total Revenue Pixel
The total revenue earned for a specific pixel.
Field IDtotal_revenue_pixel
TypeTEXT
Data Typemetric
Ctr
The rate of clicks to impressions.
Field IDctr
TypeTEXT
Data Typemetric
Spend
The total marketer spend across both direct and real time media buys.
Field IDspend
TypeTEXT
Data Typemetric
Media Cost
The total amount spent to purchase all impressions.
Field IDmedia_cost
TypeTEXT
Data Typemetric
Ecpm
The effective advertiser spend per 1000 impressions.
Field IDecpm
TypeTEXT
Data Typemetric
Ecpc
The effective advertiser spend per click.
Field IDecpc
TypeTEXT
Data Typemetric
Ecpa
The effective advertiser spend per conversion/acquisition.
Field IDecpa
TypeTEXT
Data Typemetric
Imps Viewed
The number of measured impressions that were viewable, per the IAB Viewability definition, which states that an impression is viewable if 50% of the pixels are in-view during 1 consecutive second.
Field IDimps_viewed
TypeTEXT
Data Typemetric
View Measured Imps
The total number of impressions that were measured for viewability.
Field IDview_measured_imps
TypeTEXT
Data Typemetric
View Rate
The percentage of impressions that were viewable out of the total number of impressions measured for viewability. (Viewed Imps / View Measured Imps)
Field IDview_rate
TypeTEXT
Data Typemetric
View Measurement Rate
The percentage of impressions measured for viewability out of the total number of impressions. (View Measured Imps / Imps)
Field IDview_measurement_rate
TypeTEXT
Data Typemetric
Avg Bid Reduction
The average bid reduction you gained on the line item or campaign. This value represents the difference (as a percentage) between your bid and the actual media cost you paid for the impression you won (e.g., due to bid reduction). This value is only valid for RTB bidding (i.e., not Managed). Currently, this value is not accurately calculated for line items for which the payment_auction_event_type field has been set to 2.
Field IDavg_bid_reduction
TypeTEXT
Data Typemetric
Video Skips
The total number of times a user skipped the video. Use this metric for reporting when buying skippable inventory.
Field IDvideo_skips
TypeTEXT
Data Typemetric
Video Starts
The total number of times the first segment of the video creative was downloaded and started.
Field IDvideo_starts
TypeTEXT
Data Typemetric
Video 25 Pcts
The total number of times the video creatives completed 25% of the entire duration.
Field IDvideo_25_pcts
TypeTEXT
Data Typemetric
Video 50 Pcts
The total number of times the video creatives completed 50% of the entire duration.
Field IDvideo_50_pcts
TypeTEXT
Data Typemetric
Video 75 Pcts
The total number of times the video creatives completed 75% of the entire duration.
Field IDvideo_75_pcts
TypeTEXT
Data Typemetric
Video Completions
The total number of times the video creatives played for the entire duration.
Field IDvideo_completions
TypeTEXT
Data Typemetric
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. An ad response doesn't necessarily indicate a successful impression. For an impression, the first frame of the video must be served.
Field IDvideo_served
TypeTEXT
Data Typemetric
Video Errors
The total number of times a video error occurred.
Field IDvideo_errors
TypeTEXT
Data Typemetric
Revenue Per Video Complete
The revenue per video completion.
Field IDrevenue_per_video_complete
TypeTEXT
Data Typemetric
Cost Per Video Complete
The cost per video completion.
Field IDcost_per_video_complete
TypeTEXT
Data Typemetric
Video Completion Rate
The ratio of video completions to impressions, expressed as a percentage.
Field IDvideo_completion_rate
TypeTEXT
Data Typemetric
Video Start Rate
The percentage of times the first segment of the video creative was downloaded and started.
Field IDvideo_start_rate
TypeTEXT
Data Typemetric
Video Skip Rate
The percentage of times the user opted to skip the video.
Field IDvideo_skip_rate
TypeTEXT
Data Typemetric
Extracted Date
The date where the extraction take times.
Field ID_catchr_date_extract
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Platform Name
Return the platform name
Field ID_catchr_platform_name
TypeTEXT
Data Typedimension