Data Dictionary for SSP Sellers

The report designer provides many options for dimensions and metrics 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, 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 Sellers

Ads

Dimension

Reporting API field

Description

Metrics Available

Ad Source

adSource1M

Indicates the ad source type and whether the ad provided is sourced via programmatic demand from the Verizon Media exchange or via an ad network partner

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

Ad Source ID

adSourceId1M

Internal unique identifier for an ad source type

Same metrics as ad source

Ad Tag

adTag1M

The name of the Ad Source or default RTB Profile

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

Ad Tag GUID

adTagGUID1M

The external ad tag id

Same metrics as ad tag

Ad Tag ID

adTagId1M

The internal unique identifier for an ad source or default RTB Profile

Same metrics as ad tag

Advertiser Domain

advertiser1M

Domain of the advertiser for whom the bid was won

Delivered, Post-auction fraud, Served, Invalid Publisher Revenue, Publisher eCPM, Publisher Revenue
Alias positionAlias1M Custom field identifier for a placement configured by a user. An alias can be used to group placements in reports. All metrics except In-View metrics

Bidder

bidder1M

Name of the Bidder account. A Bidder is a regional endpoint for a DSP.

Delivered, Post-auction fraud, Served, Invalid Publisher Revenue, Publisher eCPM, Publisher Revenue

Bidder ID

bidderId1M

Internal unique identifier for bidder

Same metrics as bidder

Buyer

buyer1M

Name of Demand Side Platform (DSP); the parent account for the bidder

Delivered, Post-auction fraud, Served, Invalid Publisher Revenue, Publisher eCPM, Publisher Revenue

Buyer ID

buyerId1M

Internal unique identifier for a DSP

Same metrics as buyer
Current Deal Priority dealTierName1M The current setting for the priority tier of a deal. In the auction, a high priority type deal will win over a bid from a lower priority type. The priorities are Open (lowest), Priority, and VIP (highest) Same metrics as deal
Current Deal Price dealPrice1M The current value of floor or fixed price set for the deal. This price will be used to evaluate deal bids in an auction. Same metrics as deal
Current Deal Price Type dealPriceTypeName1M Indicates the pricing associated with the Deal. Floor Price value = the price entered is the minimum bid price accepted for the Deal. Fixed Price value = the Deal will always be evaluated at the price value entered, as long as the bid price is equivalent to or above that price. Same metrics as deal

DCN (Site ID)

siteDcn1M

External ID for an app or site

All metrics

Deal

deal1M

Name of deal

Delivered, Post-auction fraud, Served, Invalid Publisher Revenue, Publisher eCPM, Publisher Revenue

Deal ID

dealId1M

Unique identifier 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. Delivered, Post-auction fraud, Served, Invalid Publisher Revenue, Publisher eCPM, Publisher Revenue
HB Partner hbPartnerName1M For Sellers who are integrated via 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) Ad Requests, Bots, Clicks, CTR, Delivered, Delivered (Passbacks Included), Fill Rate, Post-Auction Fraud, Pre-auction Fraud, Served, All TCF 2.0 metrics, Invalid Publisher Revenue, Publisher eCPM, Publisher Revenue, Publisher RPM
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

All metrics

Impression Group

impressionGroup1M

Impression groups provide a method to group impressions under a specific Site for reporting, based on a value passed on the inbound request. Ad Requests, Bots, Clicks, CTR, Delivered (Passbacks Included), Fill Rate, Pre-auction Fraud, Served, All TCF 2.0 metrics.
Operating System os1M The operating system (OS) for the user’s device All metrics except in-view, Requests to Ad Source, Fill Rate (Served | Out)

Placement

position1M

Placement ID as configured in the SSP

All metrics

Placement ID

positionId1M

Internal unique numeric identifier of a placement

Same metrics as placement

Placement Type

placementType1M

Indicates the type of placement (ex: Banner, Video, etc.)

Same metrics as placement

Seat

seatName1M

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

Delivered, Post-auction fraud, Served, Invalid Publisher Revenue, Publisher eCPM, Publisher Revenue
Seat ID internalSeatId1M Internal unique identifier for a buyer seat Same metrics as seat

Seller

sellerName1M

Publisher name

All metrics
Seller ID sellerId1M Internal unique identifier for a publisher Same metrics as seller
Site site1M Name of site as configured in the SSP All metrics
Site ID siteId1M Internal unique identifier for a site Same metrics as site ID

Source Type

sourceType1M

Indicates whether the impression was filled by demand from Open RTB or a Mediation partner

Clicks, CTR, Delivered, Fill Rate, Outbound Bid Requests, Post-Auction Fraud, Served, Invalid Publisher Revenue, Publisher eCPM, Publisher Revenue, Publisher RPM

Date/Time

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 0-23

Ad Requests, Bots, Clicks, CTR, Delivered, Delivered (Passbacks Included), Fill Rate, Post-Auction Fraud, Pre-auction Fraud, Served, All TCF 2.0 metrics, Invalid Publisher Revenue, Publisher eCPM, Publisher Revenue

Month

scaledMonth1M

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

All metrics except in-view

Geo

Dimension

Reporting API field

Description

Metrics Available
Country country1M Name of the country where the user or device is located. Ad Requests, Clicks, Delivered, Delivered (Passbacks Included), Fill Rate, Post-Auction Fraud, Served, All TCF 2.0 metrics, Invalid Publisher Revenue, Publisher eCPM, Publisher Revenue, Publisher RPM

Country Code

countryCode

Country abbreviated to ISO code (ex: USA)

Same metrics as country

Other

Dimension

Reporting API field

Description

Metrics Available
Custom Key 01 - 25 customKey18Value_1m (replace the #18 with each key 1- 20) This dimension is used for a key-value pair set up in the SSP. A Key-value pair (KVP) is a set of custom data sent to the SSP from the publisher’s ad call. If the SSP is set up to capture and report on this data, the values will be added into one of these dimensions. The dimension name maps to the Reporting Dimension Name set in the SSP key-value pair UI. Ad Requests, Bots, Clicks, CTR, Delivered, Delivered (Passbacks Included), Fill Rate, Pre-auction Fraud, Served, Publisher Revenue

 

Reporting Metrics for Sellers

Ads

Metric

Reporting API field

Description

Ad Requests (In)

requestsIn1M

Total count of inbound requests into Verizon Media SSP, inclusive of VM Exchange and other mediation ad sources

Ad Requests (RTB Only) requestsIn1M Count of inbound Requests into the Verizon Media Exchange
Ad Requests (RTB Only, Fraud Excluded) trafficRequestsIn1M Count of inbound requests into the Verizon Media Exchange that are not flagged as fraudulent

Bots

adsBots1M

Count of inbound requests that are flagged as bot traffic, based on the IAB Bots & Spiders list.

Clicks

adsClicked1M

Counts of when a user clicked an impression

CTR

clickThroughRate1M

Click through rate, calculated by dividing clicks by delivered impressions

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.

Delivered (Passbacks Included)

adsDisplayed1M

Count of when a programmatic impression or an impression via passback was served successfully on the screen.

Fill Rate (Delivered) trafficFillRateIn1M Calculated by dividing ads delivered by ad requests

Fill Rate (Served)

fillRateIn1M

Calculated by dividing ads served by ad requests

Fill Rate (Served, Out)

fillRateOut1M

Calculated by dividing ads delivered by requests to ad sources

Fraud

adsFraud1M

Total count of impressions identified as fraudulent, based on Verizon Media's proprietary traffic protection technology. This includes fraudulent impressions identified both pre-auction and post-auction.

Insufficient Bids

insufficientBidsAuctionType1M

Number of seat bids that were below the placement’s floor price

In-View Impressions inViewImp1M Number of impressions where at least 50% of an ad was In-View for at least one continuous second
In-View Measured Impressions inViewMeasuredImp1M The number of impressions where viewability was measurable
In-View Rate inViewImpRate1M Calculated by dividing in-view impressions by in-view measured impressions
Outbound Bid Requests requestsOut1M Count of requests sent to bidders during an auction
Pre-auction Fraud adsFraud1M Total count of ad requests identified as fraudulent prior to the auction occurring, based on Verizon Media's proprietary traffic protection technology
Post-auction Fraud adsPostFraud1M Total count of delivered impressions identified as fraudulent after the ad is delivered, based on Verizon Media's proprietary traffic protection technology. These delivered impressions will be filtered out as invalid.
Requests to Ad Source requestsOut1M Total count of requests sent out to the VM Exchange or an ad network
Served adsServed1M Count of ad requests to the VM Exchange that resulted in a won auction
Served (Includes Passbacks) adsServedWithPassbacks1M Count of requests to the VM Exchange that had an auction winner or a passback occurred.

 

GDPR

Metric Reporting API field Description
TCF 2.0 Basic Ads Consent gdprBasicAdsConsent1M Total count of ad requests with user consent given to Verizon Media to use personal data for basic ad delivery only. It allows frequency capping, creative sequencing, optimization, measurement and reporting, but not targeting or building user profiles and segments.
GDPR EU Jurisdiction gdprEuJurisdiction1M Total count of ad requests coming from GDPR jurisdiction. It includes all ad requests with a GDPR flag or from an IP address located in European Economic Area.
TCF 2.0 Interest-Based Ads Consent gdprInterestBasedAdsConsent1M Total count of ad requests with user consent given to Verizon Media to use personal data for interest-based ads. It allows use of personal data for basic ad delivery, as well as for delivering personalized ads and for targeting purposes.
TCF 2.0 No Consent gdprNoConsent1M Number of ad requests without user consent given to Verizon Media to process personal data. It allows only to serve contextual ads without using personal data nor tracking users.
TCF 2.0 Precise Geolocation gdprPreciseGeolocation1M Total count of ad requests with user consent given to Verizon Media to use precise geolocation. It allows use of IP address or latitude and longitude GPS coordinates to target or contribute to a user profile.

 

Revenue

Metric

Reporting API field

Description

Invalid Publisher Revenue invalidPublisherRevenueNonRtb1M Revenue associated with a filtered fraudulent impression post auction
Invalid Publisher Revenue (RTB Only) invalidPublisherRevenueRtb1M Revenue associated with a filtered fraudulent impression post auction served in the Verizon Media Exchange (excludes other ad sources)

Publisher eCPM

pubEcpm1M

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

Publisher RPM (In)

publisherRpm1M

Revenue per thousand impressions and is calculated by dividing publisher revenue by ads requested and multiplying by 1,000.

Publisher RPM (Out)

publisherRpmOut1M

Revenue per thousand impressions and is calculated by dividing publisher revenue by requests to ad sources and multiplying by 1,000.

Publisher Revenue (RTB Only)

publisherRevenueRtb1M

Publisher revenue for RTB demand (excludes other ad sources)

Publisher Revenue

publisherRevenueNonRtb1M

The total revenue attributed to the publisher

 

Filters

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

Filter

Reporting API field

Description

Ad Source

adSource1M

Filter by different exchanges and ad networks

Ad Tag ID

adTagId1M

Filter by internal unique identifier for an ad tag

Bidders

bidder1M

Filter by name of bidder

Company ID cid Filter by the unique identifier assigned to the publisher’s company or companies in Analytic 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

Exchange / RTB Only rtbOnly Filters to only include exchange data and excludes all other ad sources
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).

Impression Group

impressionGroup1M

Filter by impression group. Impression groups provide a way of grouping impressions under a specific Site for reporting, based on a value passed on the inbound request. This is a legacy feature that has been replaced by Key Value Pairs.

Include All Ad Sources

includeAdNetworks

Filters data to include all ad sources. This will limit the amount of metrics and dimensions available to build a report.

Placement Type placementType1M Filters

Seat

seat1M

Filter by buyer seat name associated with an impression

Site

site1M

Filter by name of site as configured in the SSP