Data Dictionary for SSP Buyers

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 Buyers

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

HB Partner

 

Name of header bidding partner

HB Partner ID

 

System ID  of header bidding partner

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 Buyers

Ads

Metric

Reporting API field

Description

Average Clearing Price

requestsIn1M

Sum of clearing price / number of bids

Bid Requests (Out)

requestsOut1M

Bid requests that are sent to a bidder from the SSP

Bid Responses

bidResponses1M

Count of bid responses received from bidder containing at least one valid bid

Bids Won

bidsWon1M

Count of bids won by the seat

Delivered

adsDelivered1M

Count of ads confirmed delivered to the device (e.g., via tracking pixel, SDK report)

Forfeits

bidsForfeits1M

Count of bids lost due to failure to deliver markup or ad quality rejection.

Response Timeout Rates

responseTimeoutRate1M

Response Timeouts divided by Total Bid Responses

Response Timeouts

bidsTimeout1M

Count of bid responses that did not return a bid within the timeout limit.

Served

adsServed1M

Count of ads that have been sent to a site or screen

Win Notice Timeout Rates

winNoticeTimeoutRate1M

Win Notice Timeouts divided by Total Win Notices Received

Win Notice Timeouts

winsTimeout1M

Count of win notice calls that resulted in timeout

 

Revenue

Metric

Reporting API field

Description

Gross Wins

grossWins1M

Total of (bid price/1000)

Spend

spend1M

Total bid prices from 

Total eCPM

totalEcpm1M

Total average eCPM ((pub revenue/served)*1000)

 

Filters

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

Filter

Description

Ad Tag ID

Filter by system ad tag ID

Bidder

Filter by system bidders

Multiple buyers

Filter by your multiple buyers

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