Buyer transparency feed

The Buyer Transparency Feed provides advertisers with the most granular insights about transactions that occurred on supply. Those insights include the bid that was submitted, the inventory that was sold, the auction that was run, as well as the tech fees and revenues that ended up with the exchange and the seller. The feed provides 28 datapoints for each impression that was served.

Currently, more than 60% of our direct seller transactions globally—and 85% in the US—are fee transparent.

For most auctions, there will be 1 row with all columns populated (fee columns will not be populated if the seller is not transparent). For Guaranteed Outcomes auctions, where the buyer is buying on an event basis (e.g., such as views or video completion), there can be 1 or 2 rows for the same auction. This will be determined by the following:

  • For Guaranteed Outcomes auctions, where the buyer wins the auction and their creative is rendered, there will be 1 row that contains columns 1-10 (all columns).
  • If the buyer’s required outcome (e.g., a view or complete) occurs, there will be another row that will include columns 1-7 and 10.

The Xandr internal name for this feed is brand_transparency_feed.

Sequence

The columns below are listed in the same order in which they appear in the log-level feed file (top to bottom here, left to right in the file).

Integer key

  • tinyint = 1 byte (8 bit)
  • smallint = 2 byte (16 bit)
  • int = 4 byte (32 bit)
  • bigint = 8 byte (64 bit)

Columns

Column Index Column Name Type Description
1 date_time UNIX Epoch time The date and time of the transaction (e.g., 1526057561 which would need to be translated to Friday, May 11, 2018 4:52:41 PM (UTC)) .
2 partition_time_millis bigint Auction timestamp in milliseconds.
3 auction_id_64 bigint The auction ID (bid.request.imp.id) generated by the Xandr exchange. Value is unique for a given hour (counter is reset each hour).
4 buyer_member_id int The ID of the buyer member within Xandr that bid on this inventory.
5 buyer_member_name string The name of the buyer associated with the buyer member ID.
6 bidder_id int The ID of the DSP that bid on this inventory.
7 bidder_name string The name of the DSP associated with the Bidder ID.
8 inventory message Information about the inventory being purchased. See Inventory for more details.
9 bid message Information about the bid. See Bid for more details.
10 result message Information about the final costs and revenue results. See Result for more details.
11 external_bidrequest_id bigint A unique identifier for the bid request. This ID is often generated by the exchange (or the platform making the request) to distinguish and track individual bid requests. Demand side platforms (DSPs) can use this identifier to associate a response with the corresponding bid request.
12 external_bidrequest_imp_id bigint A unique identifier for the impression within the bid request. Each impression in a bid request has its own ID, allowing advertisers and demand side platforms (DSPs) to reference and submit bids for a specific impression. This field helps identify which impression a bid pertains to.

Inventory

Column Index Column Name Type Description
1 site_domain string The top-level domain of the website.
2 exchange string The name of the exchange selling the inventory.
3 seller_member_id int The ID of the selling member within the Xandr exchange.
4 seller_name string The name associated with the Seller member ID.
5 tag_id int The ID of the tag that was registered with Xandr.
6 supply_type tinyint The type of supply. Possible values are:
- 0 - Web
- 1 - Mobile Web
- 2 - Mobile App
7 device_type tinyint The type of device on which the impression is served. Possible values are
- 0 - Other
- 1 - Desktop/laptop
- 2 - Mobile phone
- 3 - Tablet
- 4 - TV
- 5 - Game console
- 6 - Media player
- 7 - Set top box
8 country string The country where the inventory was sold.
9 auction_type enum The auction type (first price or second price). Possible values are:
- 1 - FIRST_PRICE - The auction is a first price auction
- 2 - SECOND_PRICE - The auction is a second price auction
10 ads_txt_certification enum Whether or not this seller is authorized to sell the inventory according to ads.txt. Possible values are:
- 1 - domain_data_unavailable
- 2 - seller_unauthorized
- 3 - seller_authorized

Bid

Column Index Column Name Type Description
1 bid_amount numeric Gross bid from the buyer (including tech fees).
2 creative_id int Creative ID submitted on the bid response.
3 deal_id int Deal ID submitted on the bid response.
4 clearing_event_id int The commodity being bought; either impressions or one of the Guaranteed Outcomes clearing events. Possible values are:
- 1 - IMPRESSIONS
- 2 - VIEWS - STANDARD DISPLAY
- 6 - VIEWS - CUSTOM DISPLAY - 100pv1s
- 8 - VIEWS - STANDARD VIDEO
- 9 - VIEWS - CUSTOM VIDEO - 100pv50pd
- 10 - COMPLETES - STANDARD COMPLETE
5 media_type tinyint The general display style of the creative, classified by media subtype. To map media subtype IDs to their names and parent media types, use the Media Subtype Service. Two common values are:
- 1 - BANNER
- 64 - VIDEO
6 external_campaign_id string The campaign identifier passed in by external DSPs on their bids.
7 insertion_order_id int32 The ID of the insertion order (in Invest).
8 bidder_seat_id int32 The DSP's identifier for a buyer (including external DSPs).
9 bidder_seat_name string The name of the buyer corresponding to the bidder_seat_id.

Result

Column Index Column Name Type Description
1 gross_media_ cost numeric Cost charged to the buyer inclusive of all tech fees. Total Media Cost plus any tech fees specified in the buyer’s contract applied outside the auction.
2 total_media_cost numeric Final amount that the buyer owes Xandr for the media that was purchased in this auction.
3 exchange_ revenue numeric Amount destined towards the Xandr exchange. Total Media Cost less any tech fees specified in the buyer’s contract applied as a part of the auction.
4 exchange_cost numeric Amount destined towards the seller. Exchange Revenue less any tech fees that the exchange must collect for running this auction.
5 seller_revenue numeric Revenue that the seller will make for selling this media. Exchange Cost less any tech fees specified on the seller’s contract applied as a part of the auction.
6 net_seller_revenue numeric Net revenue paid to the seller. Seller Revenue less any tech fees specified in the seller’s contract applied outside the auction.
7 sasc_cap_savings double Savings from applied SASC cap (e.g., 0.50).