Data Dictionary for SSP Sellers
The report designer provides many dimension and metric options to use when creating custom reports. Reports are broken out by dimensions and metrics.
Dimensions |
Metrics |
---|---|
Dimensions are aspects used to slice metric data. These are your "pivots" or ways to breakdown the data Example: Site Name, Country |
Metrics are numerical data accumulated and stored in our system. These are real statistics, such as total ad impressions, which can be broken out by the dimensions selected. Example: Revenue, Bid Requests |
Reporting Dimensions for Sellers
Ads
Dimension |
Reporting API field |
Description |
---|---|---|
Ad Source |
adSource1M |
Name of a mediation partner |
Ad Source ID |
adSourceId1M |
System ID for ad source |
Ad Tag |
adTag1M |
The creative ad tag for an impression |
Ad Tag GUID |
adTagGUID1M |
The external ad tag id |
Ad Tag ID |
adTagId1M |
System ID for ad tag |
Advertiser Domain |
advertiser1M |
Domain of the advertiser for whom the bid was won |
Bidder |
bidder1M |
Name of entity that bid on a bid request |
Bidder ID |
bidderId1M |
System ID of bidder |
Buyer |
buyer1M |
Name of DSP who bid on a bid request |
Buyer ID |
buyerId1M |
System ID of buyer |
DCN (Site ID) |
siteDcn1M |
External ID for an app or site |
Deal |
deal1M |
Name of deal that associated with an impression |
Deal ID |
dealId1M |
System ID of a deal |
Header Bidding |
headerBidding1M |
Whether the auction uses header bidding |
Impression Group |
impressionGroup1M |
|
Placement |
position1M |
Name of placement sent out on the bid request |
Placement ID |
positionId1M |
System ID of a placement |
Placement Type |
placementType1M |
Whether the placement type is banner, interstitial, rectangle, instream video, native or other |
Seat |
seatId1M |
Buyer seat name associated with an impression |
Seller |
sellerName1M |
Publisher name |
Source Type |
sourceType1M |
Whether the auction is using RTB or Mediation |
Date/TIme
Dimension |
Reporting API field |
Description |
---|---|---|
Date |
scaledDay1M |
Day formatted to MM/DD/YYYY) |
Hour |
scaledDayHourly1M |
Hour of the day formatted to 1-23 |
Month |
scaledMonth1M |
Month formatted to month’s full name (ex: January) |
Geo
Dimension |
Reporting API field |
Description |
---|---|---|
Country Code |
country1M |
Country abbreviated to ISO code (ex:USA). |
Reporting Metrics for Sellers
Ads
Metric |
Reporting API field |
Description |
---|---|---|
Bid Requests (In) |
requestsIn1M |
Bid requests that are inbound to the SSP exchange |
Bid Requests (Out) |
requestsOut1M |
Bid requests that are sent to a bidder from the SSP |
Served |
adsServed1M |
Number of ads served to a site or screen |
Bots |
adsBots1M |
Number of bid requests determined to be from bots |
Clicks |
adsClicked1M |
Counts of when a user clicked an impression |
CTR |
clickThroughRate1M |
Clicks divided by ads delivered |
Delivered |
adsDelivered1M |
The number of ads confirmed delivered to the device (e.g., via tracking pixel, SDK report). |
Displayed |
adsDisplayed1M |
Count of ads successfully displayed on a device |
Fill Rate ( In) |
fillRateIn1M |
Ads served divided by bid requests (inbound) |
Fill Rate (Out) |
fillRateOut1M |
Ads served divided by bid requests (outbound) |
Fraud |
adsFraud1M |
Number of bid requests determined to be from fraudulent IPs |
Insufficient Bids |
insufficientBidsAuctionType1M |
Number of seat bids that were below the site's reserve price |
Revenue
Metric |
Reporting API field |
Description |
---|---|---|
Publisher eCPM |
pubEcpm1M |
Publisher average eCPM ((pub revenue/served)*1000) |
Publisher RPM (In) |
publisherRpm1M |
|
Publisher RPM (Out) |
publisherRpmOut1M |
|
RTB Publisher Revenue |
publisherRevenueRtb1M |
The RTB revenue attributed to the publisher |
Total Publisher Revenue |
publisherRevenueNonRtb1M |
The total revenue from the Exchange and other mediation partners attributed to the publisher |
Filters
The report designer allows a report to be filtered by a specific type of data.
Filter |
Description |
---|---|
Ad Source |
Filter by different mediation partners |
Ad Tag ID |
Filter by system ad tag ID |
Bidders |
Filter by system bidder |
Country |
Filter by country |
Deal ID |
Filter by system deal ID |
Impression Group |
Filter by impression group |
Include Ad Networks |
Filters data to include mediation partners. This will limit the amount of metrics and dimensions available to add to a report. |
RTB Only |
Filters by only data running through the exchange. This will not include mediation partners. |
Seat Name |
Filter by buyer seat |
Multiple Sellers |
Filter by your multiple sellers |
Site |
Filter by site names |
Site ID |
Filter by system site ID |