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 ClicksPlugin/GAMThe 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 StartsPlugin/GAMThe count of the Ad Start event, which is fired when the ad creative playback has begun
Ads Selected (beta)Freewheel LogsWhere the Commercial Break Pattern is set for Volume of ads per break, this metric records how many ads were selected by the Freewheel Serve to play in that break
Content StartsAllThe count of the Start of Content, which is fired when the first frame of the video playback has been delivered
Content First QuartilesPlugin/GAMThe count of the First Quartile of Content, which is fired when the video playback has reached 25% of its total duration
Content MidpointsPlugin/GAMThe count of the Midpoint of Content, which is fired when the video playback has reached 50% of its total duration
Content Third QuartilesPlugin/GAMThe count of the Third Quartile of Content, which is fired when the video playback has reached 75% of its total duration
Content CompletesPlugin/GAMThe count of the Video Complete event, which is fired when the video playback has reached 95% of its total duration
eCPM (beta)Freewheel LogsFor 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
Gross ImpressionsAllThe count of all Impression events
Gross Ad Server Revenue (beta)Freewheel LogsThe sum of cpms where an impression exists
Gross ErrorsCollector APIThe count of all error events (ad and content)
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
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 300pxPlugin/GAMThe 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 RequestsPlugin/GAMThe 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 BreaksFreewheel LogsThe number of Ad Breaks that were Rendered on the end viewing device, this is determined by the presence of at least one impression and/or one error event per ad break
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)
Time Unfilled (beta)Freewheel LogsWhere the Commercial Break Pattern has been set to time delimited, the Time Unfilled metric records how many seconds are left unfilled against the desired break length
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 RatePlugin/GAMThe 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 ReadyPlugin/GAMThe 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
ViewabilityPlugin/GAMThe 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 ExtensionPlugin/GAMThe file extension of the ad creative, if available - .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 IdPlugin/GAMThe ID of any Creative Wrapper used in a VAST programmatic chain
Ad Wrapper IdPlugin/GAMThe ID of any System Wrapper used in a VAST programmatic chain
Ad Manager VersionPlugin/GAMThe 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
DSPPlugin/GAMThe Name of the Ad System / Server that delivered the ad
Data SourceAllThe friendly name for the Data Source coming into the Watching That platform (e.g: Freewheel)
Device TypePlugin/GAMThe 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 UnitPlugin/GAMAd Placement determined by what is on the ad tag url
GAM House SplitPlugin/GAMA breakdown of GAM ADS based on their line item type, House or Non house
GAM Line ItemPlugin/GAMGAM Line Item ID / Name - only available for ads that are successfully loaded
GAM Line Item TypePlugin/GAMA breakdown of GAM ADS based on their line item type
GAM: Order NamePlugin/GAMThe name of the order as you defined it in your GAM account
HB BidderHeader BiddingThe Bidder Name
HB Winning BidderHeader BiddingThe Winning Bidder Name
Live ContentAllA 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 VisiblePlugin/GAMA binary marker that denotes if the player is in an active tab or not
PlayerAllThe name / ID of the player
Player VersionPlugin/GAMThe version of the player where available
Playlist PositionPlugin/GAMIf a playlist / recommendation engine is used, the index of the player in the playlist
SSPPlugin/GAMThe Name of the Ad System / Server which is the first wrapper in a programmatic VAST chain: AdX, GDFP
Stream IDCollector APIThe ID of the Stream used in Google DAI setups
TerritoryAllThe world zones (e.g EU, Middle East, Rest of the world)
VideoAllThe Name / ID of the Video
Viewability SegmentPlugin/GAMAd viewability split into 0-10%, 10-20%, ... 90-100% segments. Where n/a is seen viewability is not measurable
Wrapper PathPlugin/GAMThe Names of the Ad System/ Servers used in a VAST programmatic chain
60% in-viewPlugin/GAMWhether the ad was more or less than 60% in view at the time of Impression. Where n/a is seen viewability is not measurable