Link Search Menu Expand Document

PDF

Prebid Analytics Data Schema

Apollo

Publisher


This page includes both Dimensions and Metrics.

Dimensions

FieldField TypeDescription
Ad HeightDimensionHeight of the returned creative size.
Ad PositionDimensionAt the time of ad render, determines if the ad was above the fold (ATF) or below the fold (BTF).
Ad SizeDimensionWidth and height of the creative size.
Ad Unit CodeDimensionUnique identifier created and assigned to the ad unit.
Ad WidthDimensionWidth of the returned creative size.
Advertiser IDDimensionBidder-specific advertiser ID.
Advertiser NameDimensionName of the advertiser.
Agency IDDimensionBidder-specific agency ID.
Agency NameDimensionName of the agency.
Auction SequenceDimensionNumber of auctions run after the initial page load.
Auction TimeoutDimensionPublisher defined timeout of request. Used to help publishers understand impacts of timeout settings.
Available Ad SizesDimensionRequested ad sizes sorted and concatenated.
BidderDimensionThe bidder code. Used by ad server’s line items to identify bidders.
Bidder ObfuscatedDimensionThe bidder code with bidder name obfuscated.
Brand IDDimensionBidder-specific brand ID (some advertisers have many brands).
Brand NameDimensionBrand name.
BrowserDimensionThe browser where the ad request originated.
Campaign ContentDimensionTracks between different content displayed to the user. Can be defined through the adapter configuration or automatically pulled from utm_content.
Campaign MediumDimensionThe type of traffic. Can be defined through the adapter configuration or automatically pulled from utm_medium.
Campaign NameDimensionDifferentiate traffic between different campaigns. Can be defined through the adapter configuration or automatically pulled from utm_campaign.
Campaign SourceDimensionWhere the traffic originated from. Can be defined through the adapter configuration or automatically pulled from utm_source.
Campaign TermDimensionKeywords used on search ads. Can be defined through the adapter configuration or automatically pulled from utm_term.
Configuration IDDimensionPrebid bundle configuration ID. Useful if you have more than one Prebid Client or Server bundle/configuration.
CountryDimensionCountry ISO code.
Country NameDimensionCountry name.
CurrencyDimensionCurrency of the bid CPM.
Device OS TypeDimensionOperating system of the device.
Device TypeDimensionType of device (for example, desktop or mobile).
Distribution ChannelDimensionIndicates the distribution channel of the request: Web or App.
Has Bidder RespondedDimensionIndicates whether a bidder responded to a request.
Is DealDimensionIndicates if the dealId property is present and not empty.
Is WinnerDimensionIndicates if the bid response won the impression.
Latency Buckets (in ms)DimensionTime to Respond for a request by a bidder. 0-3000ms (in 50ms increments) and 3000ms+.
Network IDDimensionBidder-specific Network/DSP ID.
Network NameDimensionNetwork/DSP Name.
Page DomainDimensionThe top level domain from the ad request.
Publisher Account IDDimensionPublisherAccountId configured by publisher.
Publisher Account NameDimensionPublisher Account Name configured by publisher.
Publisher Platform IDDimensionPublisherPlatformId configured by publisher.
Request Media TypesDimensionRequested media type/ad format(s): banner, video, and/or native.
Response Media TypeDimensionMedia type/ad format of the response: banner, video, and/or native.
SourceDimensionSource of the request, including: client, pbs-app, pbs-web, pbs-amp, and s2s (pjs calling pbs).
Test CodeDimensionA free form-string used to track configurations for a/b or multivariate testing. If no value provided, use default.
User ModulesDimensionBid requests that have a User ID module identifier available.
UserID - Has Britepool IDDimensionIndicates whether a Britepool ID was available for the request or not.
UserID - Has Criteo IDDimensionIndicates whether a Criteo ID was available for the request or not.
UserID - Has ID5 IDDimensionIndicates whether a ID5 ID was available for the request or not.
UserID - Has LiveIntent IDDimensionIndicates whether a LiveIntent ID was available for the request or not.
UserID - Has LiveRamp IdentityLink IDDimensionIndicates whether a LiveRamp IDL was available for the request or not.
UserID - Has NetIDDimensionIndicates whether a NetID was available for the request or not.
UserID - Has Parrable IDDimensionIndicates whether a Parrable ID was available for the request or not.
UserID - Has TTD Unified IDDimensionIndicates whether a Unified ID 1.0 was available for the request or not.

Metrics

FieldField TypeDescription
Avg Bid CPMMetricAvg CPM of all positive bid responses
Avg Bidder Latency (in ms)MetricTime to respond / count of bid responses.
Avg Time to Live (in ms)MetricTime to live / bid response count
Bid Request CountMetricTotal number of bid requests across all adunits and bidders.
Bid Response CountMetricTotal number of bid responses across all adunits and bidders.
Bidder TimeoutsMetricCount of timed out bid requests.
Fill RateMetricRate at which a bidder returns with a positive bid.

Formula: responses w/CPM > 0 / Total Bid Requests
Revenue (Pub Currency)MetricSum of winning bid’s CPM rate in publisher currency.
Revenue (USD)MetricSum of winning bid’s CPM rate in USD.
Timeout RateMetricOverall bidder timeout rate.
Formula: Bidder Timeouts/Bid Request Count”
WinMetricNumber of winning bids.
Win CPM (Pub Currency)MetricAverage winning bid CPM in pub currency.
Win CPM (USD)MetricAverage winning bid CPM in USD.
Win RateMetricNumber of winning bids / total bid requests.