Metrics and Dimensions Glossary

Introduction#

The following is the list of the standard metrics and dimensions currently available in the Watching That platform.

Everywhere Edition customers can augment this with Custom Data and Events as they see fit.

Where necessary, entries have been marked with their availability based on the data source.

Typical usage of these metrics and dimensions is to them using the platform to execute meaningful business queries and set up actionable visual reports.

Metrics#

MetricAvailabilityDescription
Ad Clicks PluginThe count of the Ad Click event, which is fired when a user clicks on the ad
Ad Completes AllThe count of the Ad Complete event, which is fired when the ad has finished playing
Ad LoadsPluginThe count of the Ad Load event, which is fired when the ad metadata has successfully loaded
Ad RequestsAllThe count of the Ad Request event, which is fired when the client requests an ad or ads from the primary ad server
Ad Slots AllThe count of Ad Slots. Ad Slots make up an ad break and are where ad creatives are rendered, they are generated by ad / trafficking rules.
Ad StartsPluginThe count of the Ad Start event, which is fired when the ad creative playback has begun
Avg Time from Ad Req to Ad ImpAllThe average time it takes from the Ad Request events to the Impressions, in seconds
Content Starts AllThe count of the Start of Content, which is fired when the first frame of the video playback has been delivered
Content First QuartilesPluginThe count of the First Quartile of Content, which is fired when the video playback has reached 25% of its total duration
Content Midpoints PluginThe count of the Midpoint of Content, which is fired when the video playback has reached 50% of its total duration
Content Third QuartilesPluginThe count of the Third Quartile of Content, which is fired when the video playback has reached 75% of its total duration
Content Completes PluginThe count of the Video Complete event, which is fired when the video playback has reached 95% of its total duration
ErrorsAllThe count of the Ad Error events, which is fired when an error occurs in the processing of the ad request - note: this does not mean a lost impression
Error Rate (%)AllCalculated as 1. The count of Sessions with an error/total sessions or 2. The count of ad slots with an error/total ad slots
Fill Rate (%)AllCalculated as 1. The count of impressions where there is an ad opportunity (ad request and play request)/ total ad opportunities or 2. The count of ad slots where there is an impressions/total ad slots
FW: Buyer ResponseFreewheel LogsThe count of 3rd party Response events in the Freewheel V4 Logs, which is fired when a 3rd party has responded to the available ad slot
HB Average Win CPM ($)Header BiddingThe average value of the winning bid CPM
HB Revenue ($)Header BiddingThe sum of all winning bids
HB Total AuctionsHeader BiddingThe count of total auctions run
HB Under Floor PriceHeader BiddingThe count of total winning bids that were under the set floor price
ImpressionsAllThe count of the Impression event
Impressions with errorsAllThe count of the Impression event where there is also an error event
Impressions with no errorsAllThe count of the Impression event where there is no error event
Lost Ad SlotsFreewheel LogsUnrendered Ad Slots + Unfilled Inventory
MutesPlugin OnlyThe count of the Player Mute Event, Which is fired when the player enters a muted / sound off state
Percent of Ads Bigger than 300pxPlugin OnlyThe percentage of Ad Request events that occur in Ad Units/placements that measure more than 300px in width
Percent of Ads More than 60% In ViewPlugin OnlyThe percentage of Impression Events that occur in Ad Units / Placements that are 60% or more inside the browser viewport
Percent of Ads with 100% VTRAllThe percentage of Ad Request Events that also have an Ad Complete Event
Play RequestsPluginThe count of Requests to Play the Video Content - either initiated by the user (Click to Play) or automatically by the player (Auto Play)
Rendered Ad SlotsAllThe count of Ad Slots that are Rendered on a playback device, calculated as Error Events + Impression Events
Rendered Fill RateAllThe count of Rendered Ad Slots / Total Ad Slots where there was an impression
Sessions AllCalculated as 1. A content session represents the interval from when the video player initialises the video, goes through playing the video (including any potential preroll/midroll ads), until the video ends (including any postroll ad) or 2. An Ad Session contains all Ad Lifecycle events: the ad request for that particular ad, ad load, ad start, impression, quartiles, ad complete and the potential errors
Unfilled InventoryAllCalculated as 1. The count of Sessions that only have Error Events or 2. The count of Rendered Ad Slots that only have Error Events (i.e. there are no Impression Events)
Unfilled Inventory RateAllCalculated as 1. The count of Sessions that only have Error Events / Total Sessions or 2. The count of Ad Slots that only have Error Events / Total Rendered Ad Slots
Unrendered Ad SlotsFreewheel LogsThe count of Ad Slots that have not been rendered on the playback device
UnmutesPlugin OnlyThe count of the Player Unmute Event, which is fired when the player exits a muted / sound off state
Video ReadyPlugin OnlyThe count of the Video Ready event, which is fired when the video has been successfully loaded by the player and is available to start playback
Video ViewsAllThe count of the Video View event, which is fired when the first frame of video content is rendered and playback has begun

Dimensions#

DimensionAvailabilityDescription
Ad BreakAllThe position of the Ad Break, starting with 0 = Preroll, it is a numerical counter. Midroll 1 = 1, PostRoll = -1
Ad Break_SlotAllThe position of the Ad Break and Slot, starting with 0_0 = First Ad Slot in the Preroll, it is a numerical counter starting at 0. 1_3 = Midroll 1, Slot 4
Ad Creative IdAllThe ID of the Ad Creative set by the Ad Server, if available - only supplied when an Impression Event is acheived
Ad IdAllThe ID of the Ad set by the Ad Server , if available - only supplied when an Impression Event is acheived
Ad Media URL ExtensionPluginThe file extension of the ad creative, if avaiable - .mp4, .webm, .js are typical values
Ad Slot In BreakAllThe position of the Ad Slot in a given Ad Break, it is a numerical counter. 0 = the position is the first ad slot in a break, 3 is the 4 ad slot in a break
Ad Wrapper Creative IdPluginThe ID of any Creative Wrapper used in a VAST programmatic chain
Ad Wrapper IdPluginThe ID of any System Wrapper used in a VAST programmatic chain
Ad Manager VersionPluginThe version of the ad manager component used in the ad request. Example IMA SDK 3.4.2
BrowserAllThe common name of the web browser used: Chrome, Safari Mobile
Consent ObservedAllA binary flag denoting if content strings were observed on the ad tag used in the request
DSPPluginThe Name of the Ad System / Server that delivered the ad
Device TypeAllThe Device Category : Phone, Desktop, Tablet, TV
DomainAllThe Domain where the ad session was recorded: nypost.com
Error CodeAllThe Code applied to any Error Event. Can include VAST, Freewheel, IMA, Player level
FW: Ad Unit IdFreewheel LogsFreewheel Ad Unit Id
FW: Market Advertiser IdFreewheel LogsFreewheel Market Advertiser Id : Programmatic SalesChannel Only
FW: Market Buyer Seat IdFreewheel LogsFreewheel Market Buyer Seat Id : Programmatic SalesChannel Only
FW: Market Deal IdFreewheel LogsFreewheel Market Deal Id : Programmatic SalesChannel Only
FW: Market Unified Ad Id IdFreewheel LogsFreewheel Market Unified Ad Id : Programmatic SalesChannel Only
FW: Sales Channel TypeFreewheel LogsFreewheel Sales Channel Type: Direct / Reseller / Programmatic
FW: Selling PartnerFreewheel LogsFreewheel Selling Prtner : Reseller SalesChannel Only
FW: SeriesFreewheel LogsFreewheel Series ID / Name
FW: SiteFreewheel LogsFreewheel Site ID / Name
FW: Site SectionFreewheel LogsFreewheel Site Section ID / Name
GAM Ad UnitPluginGAM Ad Unit
GAM Line ItemPluginGAM Line Item ID / Name - only avaialble for ads that are successfully loaded
HB BidderHeader BiddingThe Bidder Name
HB Winning BidderHeader BiddingThe Winning Bidder Name
Live PlayerPluginA binary marker that denotes if the player is set to deliver LIVE content vs VOD / OnDemand
OSAllThe common name of the operating system: MacOS, Windows
Page VisiblePluginA binary marker that denotes if the player is in an active tab or not.
PlayerAllThe name / ID of the player
Playlist PositionPluginIf a playlist / recommendation engine is used, the index of the player in the playlist
SSPPluginThe Name of the Ad System / Server which is the first wrapper in a programmatic VAST chain: AdX, GDFP
Stream IDPluginThe ID of the Stream used in Google DAI setups
TerritoryAllThe Country code of the session
VideoAllThe Name / ID of the Video
Wrapper PathPluginThe Names of the Ad System/ Servers used in a VAST programmatic chain