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 BreaksFreewheel LogsThe count of Ad Breaks
Ad ClicksPluginThe count of the Ad Click event, which is fired when a user clicks on the ad
Ad CompletesAllThe 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 SlotsAllThe 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
Content StartsAllThe 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 MidpointsPluginThe 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 CompletesPluginThe count of the Video Complete event, which is fired when the video playback has reached 95% of its total duration
eCPMAllIn GAM eCPM comes from the Line Item. For Freewheel Logs it comes as net value/1000
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 necessarily mean a lost impression
Error Rate (%)AllThe count of ad slots with an error/total ad slots
Fill Rate (%)AllNet 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
Gross ImpressionsAllThe count of all Impression events
Gross Ad Server RevenueFreewheel LogsThe sum of cpms where an impression exists
Net ImpressionsAllThe count of Impression events after deduplication
Impressions with errorsAllNet Impressions where there is also an error event
Impressions with no errorsAllNet Impression event where there is no error event
Lost Ad SlotsFreewheel LogsUnrendered Ad Slots + Unfilled Inventory
MutesAllThe count of the Player Mute Event, Which is fired when the player enters a muted / sound off state
Percent of Ads Bigger than 300pxPluginThe percentage of Ad Request events that occur in Ad Units/placements that measure more than 300px in width
Percent of Ads with 100% VTRAllThe percentage of Ad Start 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 RateAllNet Impressions / Rendered Ad Slots
Sessions AllA 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)
Unfilled InventoryAllThe count of Rendered Ad Slots that only have Error Events (i.e. there are no Impression Events)
Unfilled Inventory RateAllUnfilled Inventory / Total Rendered Ad Slots
Unrendered Ad SlotsFreewheel LogsThe count of Ad Slots that have not been rendered on the playback device
UnmutesAllThe count of the Player Unmute Event, which is fired when the player exits a muted / sound off state
Use RatePluginThe measure of how many times an ad starts playing (the Start Ad event) against how many times it has been successfully loaded (the Ad Loaded event).
Video ReadyPluginThe 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
ViewabilityPluginThe average in-view percentage of an ad at the point of impression

Dimensions#

DimensionAvailabilityDescription
Ad BreakAllThe position of the Ad Break within the content, starting with 000 = Preroll, it is a numerical counter. Midroll 001 onwards, PostRoll = 00-1
Ad Break & SlotAllThe position of the Ad Break and the Ad Slot within the break, starting with 000_00 = First Ad Slot in the Preroll, it is a numerical counter starting at 0. 001_03 = Midroll 1, Slot 4
Ad Creative IdAllThe ID of the Ad Creative set by the Ad Server, if available
Ad IdAllThe ID of the Ad set by the Ad Server, if available
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 4th 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 consent 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: example.com
Error CodeAllThe Code applied to any Error Event. Can include VAST, Freewheel, IMA, Player level
Error ZoneAllCategory of Error, whether the error occurred in the Request, Response or Playback zone
FW: Ad Unit IdFreewheel LogsFreewheel Ad Unit Id. A unique, MRM-generated identifier for the ad unit
FW: Content BrandFreewheel LogsFreewheel Content Brand. Content Brand refers to a collection of TV channels from a particular programmer (e.g., ProgrammerCo Comedy Channels; ProgrammerCo TV Reality, etc.)
FW: EndpointFreewheel LogsFreewheel Endpoint Name. The endpoint (typically the name of the player) where the viewer watches the content
FW: Endpoint OwnerFreewheel LogsFreewheel Endpoint Owner. Owner of the content distribution endpoint. Endpoint owners are commonly programmers or Multiple System Operators (MSOs)
FW: GenreFreewheel LogsFreewheel Genre. The genre(s) associated with video inventory, e.g., Comedy, Lifestyle & Culture, News & Politics, Special Interest, etc.
FW: ListingFreewheel LogsFreewheel Listing ID, The marketplace listing or inventory package IDs that the transaction delivered against
FW: Market Advertiser IdFreewheel LogsFreewheel Market Advertiser Id : Programmatic Sales Channel Only
FW: Market Buyer Seat IdFreewheel LogsFreewheel Market Buyer Seat Id : Programmatic Sales Channel Only
FW: Market Deal IdFreewheel LogsFreewheel Market Deal Id : Programmatic Sales Channel Only
FW: Market Unified Ad IdFreewheel LogsFreewheel Market Unified Ad Id : Programmatic Sales Channel Only
FW: MRM RuleFreewheel LogsThis is the MRM Rule Id that was used to select the seller partner for that ad
FW: PlacementFreewheel LogsThe ID of the placement that was served to the user. This value comes directly from the FreeWheel database
FW: Purchase Order IdFreewheel LogsFreewheel Purchase Order ID. For Marketplace Platform Private buyers, the FreeWheel assigned purchase order ID
FW: Sales Channel TypeFreewheel LogsFreewheel Sales Channel Type: Direct / Reseller / Programmatic
FW: Selling PartnerFreewheel LogsFreewheel Selling Partner : Reseller Sales Channel Only
FW: SeriesFreewheel LogsFreewheel Series ID / Name
FW: SiteFreewheel LogsFreewheel Site ID / Name
FW: Site SectionFreewheel LogsFreewheel Site Section ID / Name
FW: Sold OrderFreewheel LogsFreewheel Sold Order ID. For Marketplace Platform Private sellers, the FreeWheel assigned ID
GAM Ad UnitPluginAd Placement determined by what is on the ad tag url
GAM House SplitPluginA breakdown of GAM ADS based on their line item type, House or Non house
GAM Line ItemPluginGAM Line Item ID / Name - only avaialble for ads that are successfully loaded
GAM Line Item TypePluginA breakdown of GAM ADS based on their line item type
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. Live = 1 and VOD = 0
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
Viewability SegmentPluginAd viewability split into 0-10%, 10-20%, ... 90-100% segments. Where n/a is seen viewability is not measurable
Wrapper PathPluginThe Names of the Ad System/ Servers used in a VAST programmatic chain
60% in-viewPluginWhether the ad was more or less than 60% in view at the time of Impression. Where n/a is seen viewability is not measurable