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.
All entries have been marked with their availability based on the data source.
Metrics#
| Metric | Availability | Database | Description |
|---|---|---|---|
Ad Breaks | Freewheel Logs | Ad Break | The count of Ad Breaks |
Ad Break Starts | GAM Logfiles | Ad | This is the count of vmap_ad_break_start events received in the GAM Impression Logs |
Ad Clicks | Plugin/GAM | Ad & Content | The count of the Ad Click event, which is fired when a user clicks on the ad |
Ad Completes | All | Ad Break, Ad & Content | The count of the Ad Complete event, which is fired when the ad has finished playing |
Ad Loads | Plugin & GAM Logfiles | Ad & Content | The count of the Ad Load event, which is fired when the ad metadata has successfully loaded |
Ad Requests | All | Content | The count of the Ad Request event, which is fired when the client requests an ad or ads from the primary ad server |
Ad Slots | All | Ad | The 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 Starts | Plugin/GAM | Ad & Content | The count of the Ad Start event, which is fired when the ad creative playback has begun |
Ads Selected (beta) | Freewheel Logs | Ad Break & Content | Where 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 |
Bid eCPM | GAM Logfiles | Bid | Bid eCPM averaged across the GAM, AdSense, Adx, and other third-party networks |
Bid Revenue | GAM Logfiles | Bid | Bid revenue is based on the number of ad impressions served by GAM, AdSense, Adx, and/or any other third-party networks |
Bids | GAM Logfiles | Bid | This is count of bid rows/events in the GAM Bid Logs |
Bid Response Errors | GAM Logfiles | Bid | This event represents a bid request without any bids from DSP |
Code Serves | GAM Logfiles | Ad & Content | Number of times the ad server responded to a request for an ad. A code serve is not counted if the ad server response is empty. For video requests and out-of-page requests (delayed impressions): Formula: Code served count >= Impressions |
Content Starts | All | Content | The count of the Start of Content, which is fired when the first frame of the video playback has been delivered |
Content First Quartiles | Plugin/GAM | Content | The count of the First Quartile of Content, which is fired when the video playback has reached 25% of its total duration |
Content Midpoints | Plugin/GAM | Content | The count of the Midpoint of Content, which is fired when the video playback has reached 50% of its total duration |
Content Third Quartiles | Plugin/GAM | Content | The count of the Third Quartile of Content, which is fired when the video playback has reached 75% of its total duration |
Content Completes | Plugin/GAM | Content | The count of the Video Complete event, which is fired when the video playback has reached 95% of its total duration |
eCPM (beta) | Freewheel Logs | Ad & Content | For Freewheel Logs it comes as net value/1000 |
Errors | All | Ad Break, Ad & Content | The 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 (%) | All | Ad Break, Ad & Content | The count of ad slots with an error/total ad slots |
Fill Rate (%) | All | Ad Break, Ad & Content | Net impressions/total ad slots |
FW: Buyer Response | Freewheel Logs | Ad Break, Ad & Content | The 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 |
FW: Fallback Ads | Freewheel Logs | Ad | Impressions that did not have a Buyer Response (The Response Event in the FW logs) |
Gross Impressions | All | Ad Break, Ad & Content | The count of all impression events that don't have the IVT flag set |
Gross Invalid Impressions | Freewheel Logs | Ad Break, Ad & Content | The count of all impression events that have the IVT flag set |
Gross Ad Server Revenue (beta) | Freewheel Logs | Ad Break, Ad & Content | The sum of cpms where an impression exists |
Gross Errors | Collector API | Content | The count of all error events (ad and content) |
HB Average Win CPM ($) | Header Bidding | Content | The average value of the winning bid CPM |
HB Revenue ($) | Header Bidding | Content | The sum of all winning bids |
HB Total Auctions | Header Bidding | Content | The count of total auctions run |
HB Under Floor Price | Header Bidding | Content | The count of total winning bids that were under the set floor price |
Impressions - All | Freewheel Logs | Ad Break, Ad & Content | The count of the total number of impression events, valid/invalid/duplicate |
Impressions with errors | All | Ad | Net Impressions where there is also an error event |
Impressions with no errors | All | Ad | Net Impression event where there is no error event |
JW: Player Setup Time | JW Player | Content | The time it takes the player to set everything up and emit the 'ready' event. Provided by the JW player |
JW: Time to First Frame | JW Player | Content | The amount of time (In milliseconds) it takes for the player to transition from a play attempt to a firstFrame event |
Lost Ad Slots | Freewheel Logs | Ad | Unrendered Ad Slots + Unfilled Inventory |
Mutes | All | Ad & Content | The count of the Player Mute Event, Which is fired when the player enters a muted / sound off state |
Net Impressions | All | Ad | The count of total valid deduplicated impressions |
Not Selected Bids | Freewheel Logs | Ad & Content | This event represents a bid not selected by FreeWheel ad server |
Percent of Ads Bigger than 300px | Plugin/GAM | Ad & Content | The percentage of Ad Request events that occur in Ad Units/placements that measure more than 300px in width |
Percent of Ads with 100% VTR | Freewheel Logs & Plugin/GAM | Ad | The percentage of Ad Start Events that also have an Ad Complete Event |
Play Requests | Plugin/GAM | Content | The count of Requests to Play the Video Content - either initiated by the user (Click to Play) or automatically by the player (Auto Play) |
Play Rate | JW Player | Content | Plays per embeds, Only the first play (based on the firstFrame event) for a given embed is counted |
Player Loads | JW Player | Content | Number of times a player has been set up on a page (counts the 'ready' event emitted by the player) |
Rendered Ad Breaks | Freewheel Logs | Ad Break & Content | The 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 Slots | Freewheel Logs & Plugin/GAM | Ad | The count of Ad Slots that are Rendered on a playback device, calculated as Error Events + Impression Events |
Rendered Fill Rate | Freewheel Logs & Plugin/GAM | Ad | Net Impressions / Rendered Ad Slots |
Responses With Bids | Freewheel Logs | Content | Number of received responses with bids from demand partners |
Selected Bids | Freewheel Logs | Ad & Content | This event represents a bid selected by FreeWheel ad server |
Sessions | Freewheel Logs & Plugin/GAM | Content | 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) |
Time Unfilled (beta) | Freewheel Logs | Ad Break & Content | Where 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 Inventory | All | Ad & Content | The count of Rendered Ad Slots that only have Error Events (i.e. there are no Impression Events) |
Unfilled Inventory Rate | All | Ad & Content | Unfilled Inventory / Total Rendered Ad Slots |
Unrendered Ad Slots | Freewheel Logs | Ad | The count of Ad Slots that have not been rendered on the playback device |
Unmutes | All | Ad & Content | The count of the Player Unmute Event, which is fired when the player exits a muted / sound off state |
Use Rate | Plugin/GAM | Content | The 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 Ready | Plugin/GAM | Content | The 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 Views | All | Content | The count of the Video View event, which is fired when the first frame of video content is rendered and playback has begun |
Viewability | Plugin/GAM | Ad & Content | The average in-view percentage of an ad at the point of impression |
Dimensions#
| Dimension | Availability | Database | Description |
|---|---|---|---|
Advertiser | GAM Logfiles | Ad & Content | The name of the advertiser that won the auction |
Ad Break | All | Ad & Ad Break | The 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 & Slot | All | Ad | The 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 Id | All | Ad & Content | The ID of the Ad Creative set by the Ad Server, if available |
Ad Id | Plugin/GAM | Ad | The ID of the Ad set by the Ad Server, if available |
Ad Manager Version | Plugin/GAM | Ad & Content | The version of the ad manager component used in the ad request. Example IMA SDK 3.4.2 |
Ad Media URL Extension | Plugin/GAM | Ad & Content | The file extension of the ad creative, if available - .mp4, .webm, .js are typical values |
Ad Slot In Break | All | Ad | The 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 Id | Plugin/GAM | Ad | The ID of any Creative Wrapper used in a VAST programmatic chain |
Ad Wrapper Id | Plugin/GAM | Ad & Content | The ID of any System Wrapper used in a VAST programmatic chain |
Agency | GAM Logfiles | Ad | The organization managing ad accounts for brands and individual clients |
Audience Segment | GAM Logfiles | Ad | Audience segment IDs that the user belonged to. A list of Audience Solutions segment ID values associated with a user separated by pipe delimiter |
Browser | All | Ad Break, Ad & Content | The common name of the web browser used: Chrome, Safari Mobile |
Consent Observed | All | Content | A binary flag denoting if consent strings were observed on the ad tag used in the request |
Currency | GAM Logfiles | Ad & Bid | The Ad Manager network's default currency |
Data Source | All | Ad & Content | The friendly name for the Data Source coming into the Watching That platform (e.g: Freewheel) |
Deal Id | GAM Logfiles | Ad | The ID of the Ad Exchange (AdX) or Ad Manager deal that applied for this impression. Blank if no deal applied |
Device Type | Plugin/GAM | Ad & Content | The Device Category : Phone, Desktop, Tablet, TV |
Domain | Plugin/GAM | Ad Break, Ad & Content | The Domain where the ad session was recorded: example.com |
DSP | Plugin/GAM | Ad & Content | The Name of the Ad System / Server that delivered the ad |
Error Code | All | Ad & Content | The Code applied to any Error Event. Can include VAST, Freewheel, IMA, Player level |
Error Zone | All | Ad | Category of Error, whether the error occurred in the Request, Response or Playback zone |
FW: Ad Unit Id | Freewheel Logs | Ad | Freewheel Ad Unit Id. A unique, MRM-generated identifier for the ad unit |
FW: Ad Unit Type | Freewheel Logs | Ad | Freewheel Ad Unit Type. Indicates the Ad Unit Package Name is an Ad Unit or a Package. |
FW: Campaign | Freewheel Logs | Ad | Freewheel Campaign ID. A unique, MRM-generated identifier for the campaign |
FW: Content Brand | Freewheel Logs | Ad | Freewheel 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: Content Provider Partner | Freewheel Logs | Ad | Freewheel Content Provider Partner ID. The content partner is the partner directly upstream from the network getting the log file. |
FW: Distribution Partner | Freewheel Logs | Ad | Freewheel Distribution Partner ID. This field will be empty if there is no distributor for the event. |
FW: Endpoint | Freewheel Logs | Ad | Freewheel Endpoint Name. The endpoint (typically the name of the player) where the viewer watches the content |
FW: Endpoint Owner | Freewheel Logs | Ad | Freewheel Endpoint Owner. Owner of the content distribution endpoint. Endpoint owners are commonly programmers or Multiple System Operators (MSOs) |
FW: Genre | Freewheel Logs | Ad | Freewheel Genre. The genre(s) associated with video inventory, e.g., Comedy, Lifestyle & Culture, News & Politics, Special Interest, etc. |
FW: Global Advertiser | Freewheel Logs | Ad | Freewheel Global Advertiser ID. A unique identifier for a Global Advertiser; this identifier is assigned when FreeWheel adds an advertiser to the Global Advertiser list. |
FW: Insertion Order | Freewheel Logs | Ad | Freewheel Insertion Order ID. A unique, MRM-generated identifier for the insertion order (IO) |
FW: Listing | Freewheel Logs | Ad | Freewheel Listing ID, The marketplace listing or inventory package IDs that the transaction delivered against |
FW: Market Advertiser Id | Freewheel Logs | Ad | Freewheel Market Advertiser Id : Programmatic Sales Channel Only |
FW: Market Buyer Seat Id | Freewheel Logs | Ad | Freewheel Market Buyer Seat Id : Programmatic Sales Channel Only |
FW: Market Deal Id | Freewheel Logs | Ad | Freewheel Market Deal Id : Programmatic Sales Channel Only |
FW: Market Unified Ad Id | Freewheel Logs | Ad | Freewheel Market Unified Ad Id : Programmatic Sales Channel Only |
FW: MRM Rule | Freewheel Logs | Ad | This is the MRM Rule Id that was used to select the seller partner for that ad |
FW: Placement | Freewheel Logs | Ad | The ID of the placement that was served to the user. This value comes directly from the FreeWheel database |
FW: Purchase Order Id | Freewheel Logs | Ad | Freewheel Purchase Order ID. For Marketplace Platform Private buyers, the FreeWheel assigned purchase order ID |
FW: Sales Channel Type | Freewheel Logs | Ad | Freewheel Sales Channel Type: Direct / Reseller / Programmatic |
FW: Selling Partner | Freewheel Logs | Ad | Freewheel Selling Partner : Reseller Sales Channel Only |
FW: Series | Freewheel Logs | Ad Break, Ad & Content | Freewheel Series ID / Name |
FW: Site | Freewheel Logs | Ad Break, Ad & Content | Freewheel Site ID / Name |
FW: Site Section | Freewheel Logs | Ad Break, Ad & Content | Freewheel Site Section ID / Name |
FW: Sold Order | Freewheel Logs | Ad | Freewheel Sold Order ID. For Marketplace Platform Private sellers, the FreeWheel assigned ID |
GAM Ad Unit | Plugin/GAM | Ad & Content | Ad Placement determined by what is on the ad tag url |
GAM Fallback Position | GAM Logfiles | Ad | The fallback position of the video ad or mobile ad. 0 = Non-fallback. 1 = First fallback ad, 2 = second fallback ad, 3 = third fallback ad and so forth. |
GAM House Split | Plugin/GAM | Ad | A breakdown of GAM ADS based on their line item type, House or Non house |
GAM Line Item | Plugin/GAM | Ad & Content | GAM Line Item ID / Name - only available for ads that are successfully loaded |
GAM Line Item Type | Plugin/GAM | Ad | A breakdown of GAM ADS based on their line item type |
GAM Line Item Priority | GAM Logfiles | Ad | The numeric priority assigned at the time of creating the line item, that serves as a guide for ad selection. The lowesr the number the higher the priority |
GAM: Order Name | Plugin/GAM | Ad | The name of the order as you defined it in your GAM account |
GAM: Order - Is Programmatic | Plugin/GAM | Ad | This specifies whether or not the Order is a programmatic Order. This value is optional and defaults to false. 0 is false, 1 is true. |
Genre | GAM Logfiles | Ad & Content | The Content Category/Genre |
HB Bidder | Header Bidding | Content | The Bidder Name |
HB Winning Bidder | Header Bidding | Content | The Winning Bidder Name |
Live Content | All | Ad & Content | A binary marker that denotes if the player is set to deliver LIVE content vs VOD / OnDemand. Live = 1 and VOD = 0 |
OS | All | Ad Break, Ad & Content | The common name of the operating system: MacOS, Windows |
Page Visible | Plugin/GAM | Ad & Content | A binary marker that denotes if the player is in an active tab or not |
Player | Freewheel Logs & Plugin/GAM | Ad Break, Ad & Content | The name / ID of the player |
Player Version | Plugin/GAM | Ad Break, Ad & Content | The version of the player where available |
Playlist Position | Plugin/GAM | Content | If a playlist / recommendation engine is used, the index of the player in the playlist |
SSP | Plugin/GAM | Ad & Content | The Name of the Ad System / Server which is the first wrapper in a programmatic VAST chain: AdX, GDFP |
Stream ID | Collector API | Ad & Content | The ID of the Stream used in Google DAI setups |
Territory | All | Ad Break, Ad & Content | The world zones (e.g EU, Middle East, Rest of the world) |
Video | All | Ad Break, Ad & Content | The Name / ID of the Video |
Viewability Segment | Plugin/GAM | Ad & Content | Ad viewability split into 0-10%, 10-20%, ... 90-100% segments. Where n/a is seen viewability is not measurable |
Wrapper Path | Plugin/GAM | Ad & Content | The Names of the Ad System/ Servers used in a VAST programmatic chain |
60% in-view | Plugin/GAM | Ad & Content | Whether the ad was more or less than 60% in view at the time of Impression. Where n/a is seen viewability is not measurable |