Data Dictionary for SSP Buyers

The report designer provides many dimension and metric options to use when creating custom reports. Each report is broken out by dimensions and metrics.

  • Dimensions are aspects used to slice metric data. These are your "pivots" or ways  to breakdown the data. Example: Site, 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: Publisher Revenue, Ad Requests

Reporting Dimensions for Buyers

Ads Dimensions

Dimension

Reporting API field

Description

Metrics Available

Bidder

bidder1M

Name of bidder account. A bidder is a regional endpoint for a DSP

Average clearing price, Bids won, Delivered, Forfeits, Post-auction Fraud, Response Timeout Rates, Response Timeouts, Served, Win Notice Timeout Rates, Win Notice Timeouts, Gross eCPM, Invalid Spend, Spend

Bidder ID

bidderId1M

Internal unique identifier for bidder

Same metrics as bidder

Buyer

buyer1M

Name of Demand Side Platform (DSP). This is the parent account for the bidder.

Average clearing price, Bids won, Delivered, Forfeits, Post-auction Fraud, Response Timeout Rates, Response Timeouts, Served, Win Notice Timeout Rates, Win Notice Timeouts, Gross eCPM, Invalid Spend, Spend

Buyer ID

buyerId1M

Internal unique identifier for a DSP

Same metrics as buyer
Deal deal1M Name of Deal Average clearing price, Bids won, Delivered, Forfeits, Post-auction Fraud, Served, Win Notice Timeout Rates, Win Notice Timeouts, Gross eCPM, Invalid Spend, Spend

Deal ID

dealId1M

System ID of a deal

Same metrics as deal
External Seat ID seatId1M The buyer seat provided on the seat level bid. Represents the buyer on whose behalf the bid is made. Average clearing price, Bids won, Delivered, Forfeits, Post-auction Fraud, Served, Win Notice Timeout Rates, Win Notice Timeouts, Gross eCPM, Invalid Spend, Spend

HB Partner

hbPartnerName1M

For Sellers integrated through a Server to Server (s2s) header bidding connection, this field provides the name of the exchange that sent the request to VM SSP (i.e, Google Open Bidding, MoPub, Amazon TAM)

Average clearing price, Bids won, Delivered, Forfeits, Post-auction Fraud, Response Timeout Rates, Response Timeouts, Served, Win Notice Timeout Rates, Win Notice Timeouts, Gross eCPM, Invalid Spend, Spend

HB Partner ID

hbPartnerId1M

Internal unique identifier for header bidding partner

Same metrics as HB Partner

Header Bidding

headerBidding1M

Indicates whether the winning bid from the auction will be used to submit a bid into an upstream header bidding auction

Average clearing price, Bids won, Delivered, Forfeits, Post-auction Fraud, Response Timeout Rates, Response Timeouts, Served, Win Notice Timeout Rates, Win Notice Timeouts, Gross eCPM, Invalid Spend, Spend

Seat

seatId1M

The name assigned to the buyer seat provided on the seat level bid. Represents the buyer on whose behalf the bid is made.

Average clearing price, Bids won, Delivered, Forfeits, Post-auction Fraud, Served, Win Notice Timeout Rates, Win Notice Timeouts, Gross eCPM, Invalid Spend, Spend
Seat ID internalSeatId1M Internal unique identifier for a buyer seat Same metrics as seat
Site site1M Name of site as configured in the SSP All Metrics

 

Date/Time Dimensions

Dimension

Reporting API field

Description

Metrics Available

Date

scaledDay1M

Day formatted to MM/DD/YYYY

All metrics

Hour

scaledDayHourly1M

Hour of the day formatted to 1-23

Delivered, Post-auction Fraud, Served, Gross eCPM, Invalid Spend, Spend

Month

scaledMonth1M

Month formatted to month’s full name (ex: January)

Average clearing price, Bids won, Delivered, Forfeits, Post-auction Fraud, Response Timeout Rates, Response Timeouts, Served, Win Notice Timeout Rates, Win Notice Timeouts, Gross eCPM, Invalid Spend, Spend

 

Geo Dimensions

Dimension

Reporting API field

Description

Metrics Available

Country Code

countryCode

Country abbreviated to ISO code (ex: USA)

Ad Requests, Clicks, Delivered, Delivered (Passbacks Included), Fill Rate, Post-Auction Fraud, Served, Invalid Publisher Revenue, Publisher eCPM, Publisher Revenue, Publisher RPM

 

Reporting Metrics for Buyers

Ads Metrics

Metric

Reporting API field

Description

Average Clearing Price

avgClearingPrice1M

Average of unit price in $USD paid for an impression if this seat level bid was the winner of the auction.

Bid Responses

bidResponses1M

Count of the bidder’s total number of bid responses for an auction

Bids Won

bidsWon1M

Count of bids that won an auction

Delivered

adsDelivered1M

Count of impressions where the ad successfully displayed to the user. This is based on a successfully rendered ad beacon on the site or screen. This is detected from a successfully rendered ad beacon on the site or screen.

Forfeits

bidsForfeits1M

Count of bids ineligible to win the auction due to failure to deliver markup or ad quality related block

Gross Wins grossWins1M Total number of wins attributed to the bid
Outbound Bid Requests requestsOut1M Count of bid requests sent to the Bidder

Response Timeout Rates

responseTimeoutRate1M

Response Timeouts divided by Total Bid Responses

Response Timeouts

bidsTimeout1M

Count of bid responses that exceeded the time limit to return a bid.

Served

adsServed1M

Count of auctions that had an auction winner

Win Notice Timeout Rates

winNoticeTimeoutRate1M

Calculated by dividing win notice timeouts by total win notices received

Win Notice Timeouts

winsTimeout1M

Count of win notice calls that exceeded the time limit to display an impression.

 

Revenue Metrics

Metric

Reporting API field

Description

Spend

spend1M

Gross revenue attributed to the bidder

Gross eCPM

totalEcpm1M

Average Cost per thousand impressions attributed to the bidder. Calculated by dividing DSP revenue by delivered impressions and multiplying by 1000.

 

Filters Metrics

The report designer allows a report to be filtered by a specific type of data.

Filter

Reporting API Field

Description

Ad Tag ID

adTagId1M

Filter by internal unique identifier for an ad tag

Bidder

bidder1M

Filter by name of bidder

Company ID cid Filter by the unique identifier assigned to the publisher’s company or companies in Analytics Reports. The Company ID is required to run a report.

Country

country1M

Filter by country

Currency Conversion toCurrency1M Filter converts revenue to non-USD currencies. Always select the metrics labeled “Non-USD” when building a report.

Deal ID

deal1M

Filter by internal unique identifier for a private marketplace deal

HB Partner hbPartner1M Filter by header bidding partner. For Sellers who are integrated via a Server to Server (s2s) header bidding connection, this field provides an internal unique identifier of the exchange that sent the request to VM SSP (i.e., Google Open Bidding, MoPub, Amazon TAM)

Seat

 

Filter by buyer seat name associated with an impression

Site ID   Filter by Site ID