{"__v":13,"_id":"56848a0cf72e9e0d00e098e5","category":{"__v":34,"_id":"555627c5ea5e120d001884ff","pages":["555627c6ea5e120d00188501","55562fbdea5e120d00188526","5556368b150ba30d00f4e0b7","5556590e26e9bc0d0044eb61","55567be0150ba30d00f4e248","55567bf026e9bc0d0044ec55","55567c08150ba30d00f4e24a","55567c14150ba30d00f4e24c","55567c4426e9bc0d0044ec59","55567c501026001900d72abc","55567c5926e9bc0d0044ec5d","55567c9a1026001900d72abf","55567cd9150ba30d00f4e24f","55567ce4150ba30d00f4e251","55567ced26e9bc0d0044ec61","555698d62f6b480d0034d9a4","55e0c386dc6b2e170074f2e3","55e0c5e15087cb1900986c16","55e0f99926f51b0d009b1744","567b35067c40060d0056041d","567b3531ee052b1700dbd9da","56846a5a65976e0d00001c57","5684783bc11c7e0d00aaff71","56847cb55a66610d006eabbd","56848a0cf72e9e0d00e098e5","568ccdf38602880d001ce230","569431fcd8c04d1700e5ae05","569ebe1ad233620d007055fb","569edd718f6d4b0d00f13b91","56aa5c3d13a69a0d00a77a09","56aa6eda4d38401900199f7a","56c7a7d5f9aa3b0d00c8457b","56d0ab1440d36e1d00bc143b","56ec9c5a493ce620008ea4c8"],"project":"555627c4ea5e120d001884fb","version":"555627c4ea5e120d001884fe","reference":false,"createdAt":"2015-05-15T17:07:17.512Z","from_sync":false,"order":0,"slug":"design","title":"Design Studio"},"project":"555627c4ea5e120d001884fb","user":"55562799ea5e120d001884f8","version":{"__v":10,"_id":"555627c4ea5e120d001884fe","project":"555627c4ea5e120d001884fb","hasDoc":true,"hasReference":true,"createdAt":"2015-05-15T17:07:16.918Z","releaseDate":"2015-05-15T17:07:16.918Z","categories":["555627c5ea5e120d001884ff","55562a5526e9bc0d0044ea47","555653821026001900d72a3c","5556685c1026001900d72a85","5556687626e9bc0d0044ec04","555668821026001900d72a87","55566892150ba30d00f4e206","555668b826e9bc0d0044ec05","55e0fb6026f51b0d009b1746","567b3b3017368a0d009a6e54"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"createdAt":"2015-12-31T01:51:08.284Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":24,"body":"* [Overview](#overview)\n* [Placement Summary](#placement-summary)\n* [Placement Interaction](#placement-interactions)\n* [Placement - Time on Unit](#placement-time-on-unit)\n* [Placement - Geolocation](#placement-geolocation)\n* [Placement - Auto Events](#placement-auto-events)\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Overview\"\n}\n[/block]\nThese reports show detailed metrics for a particular placement or set of placements. The following reports are available.\n  * **Summary:** A summary report for the selected placement or set of placements.\n  * **Interactions:** A report on all interactions broken down by interaction type.\n    * **Label by Payload:** A report on all interactions of a particular type, broken down by payload.\n    * **Clickthroughs:** A report on all clickthroughs broken down by target URL.\n    * **Shares:** A report on all shares, broken down by share service.\n    * **Share Type:** A report on all shares to a particular service, broken down by URL shared.\n  * **Time on Unit:** A report on the amount of time users spent on this unit.\n  * **Geolocation:** A report on the global distribution of ad impressions by country.\n  * **Auto Events:** A report on all automatic (non-user-initiated) events, broken down by event label and payload. \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Placement Summary\"\n}\n[/block]\nThis is a summary report of a single ad placement. The summary contains some key metrics for the placement, including its Performance Summary, a graph of Impressions, and a bar chart of Interactions by Type. Each is described below. Please see the [Metrics Glossary](doc:metrics-glossary) for more in-depth definitions of the metrics terminology.\n\n## Performance Summary\nThe performance summary allows you to view a summary of this placement’s key performance metrics at a glance. The metrics listed here are:\n  * **Total Impressions:** The number of times that this ad placement has been displayed.\n  * **Total Engagements:** The number of impressions with a user-initiated event. There can only be a maximum of one engagement counted per impression.\n  * **Engagement Rate (ER):** The ratio of number of engagements to number of impressions (i.e. total engagements divided by total impressions). This is expressed as a percentage.\n  * Total Interactions: The number of user-initiated events captured by the ad unit, such as hovers, clicks, scrolls, video plays, etc.\n  * **Interactions per Engagement:** The average number of interactions per engagement (i.e. total interactions divided by total engagements).\n  * **Interaction Rate (IR):** The ratio of ad interactions to the number of ad impressions (i.e. total interactions divided by total impressions).\n  * **Average Time on Unit:** The average amount of time, in seconds, that each user spent on the ad unit.\n  * **Clickthrough Rate (CTR):** The ratio of clicks on advertiser links to the number of impressions.\n  \n## Impressions\nA line graph representing day-by-day variations in the number of impressions for this placement.\n\n## Interactions by Type\nA pie chart of all interactions broken down by type (hover, click, scroll, video play, etc.). \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Placement Interactions\"\n}\n[/block]\nThis is a report on all interactions for this ad placement. All data is for the period specified using the global From and To dates, as defined in the Measure Module Header. At the top is a line graph, showing day-by-day variations in the total number of interactions on this placement. The chart underneath the graph contains the following columns:\n  * **Label:** The type of interaction summarized in this row. There are several standard interaction labels that are used by Flite when tracking events. These are listed in the Standard Labels and Payloads section. Click on any of these labels to open the Label by Payload report for that particular interaction type.\n  * ** Interactions:** The number of instances of this interaction type.\n  * **Percentage (%):** The percent of total interactions that are of this type.\n\nPlease see the[ Metrics Glossary](doc:metrics-glossary) for more in-depth definitions of the metrics terminology.\n\n## Label by Payload\nThis is a report on all interactions of a particular type for this ad placement. All data is for the period specified using the global From and To dates, as defined in the Measure Module Header. At the top is a pie chart showing all interactions of this type broken up by payload. For instance:\n  * for interaction type \"Tab Click\", the payloads would be the names of the tabs;\n  * for interaction type \"Play\", the payloads would be the names of the videos that were played;\n  * for interaction type \"Open\", the payloads would be the URLs of the pages that were opened in a lightbox, or names of the widgets that were opened.\n \nThe table underneath elaborates on the graph using two columns:\n  * **Payload:** The payload for this row. For many interactions, this will be clickable. Click on the payload for a breakdown of each payload by custom string.\n  * **Interactions:** The number of interactions of this type with this payload.\n\nPlease see the [Metrics Glossary](doc:metrics-glossary) for more in-depth definitions of the metrics terminology and the Standard Labels and Payloads section for a list of standard interaction types and payloads used by the Flite platform\n\n## Clickthroughs\nThis is a report on clickthroughs for this placement. At the top is a line graph, showing day-by-day variations in the total number of clickthroughs on this placement. The table underneath the graph breaks the clickthroughs down by target URL using two columns:\n  * **Target:** The target URL.\n  * **Clickthroughs:** The number of clickthroughs for the corresponding target URL. \n\n## Shares\nThis is a report on shares for this placement. At the top is a line graph, showing day-by-day variations in the total number of shares for each share type. Underneath the graph is a table with the following columns:\n  * **Share Type:** The type of share summarized in this row (e.g. LinkedIn, Twitter, Mobile, etc.). See Standard Labels and Payloads for a list of standard share types in the Flite platform. Click on a share type to open the Shares by URL page for that share type.\n  * **Shares:** The number of shares of this type. This is the number of times a user shared a URL from the ad.\n  * **Shares Clicked:** The number of Shares Clicked of this type. This is the number of times that somebody clicked on a link that has been shared using this share type. Note that the number of *Shares Clicked* will frequently be greater than the number of *Shares*, because a single share may be clicked multiple times.\n\nPlease see the [Metrics Glossary](doc:metrics-glossary) for more in-depth definitions of the metrics terminology, including Shares and Shares Clicked. \n\n## Share Type\nThis is a report on all shares of a specific type (e.g. Twitter, LinkedIn or email) for this placement. At the top is a pie chart, which breaks down the total shares of the specified type by the URL that was shared. The table underneath elaborates on the graph using two columns:\n  * **URL Shared:** The URL that was shared.\n  * **Shares:** The number of times that URL was shared.\n \nPlease see the Standard Labels and Payloads section for a list of standard share types used by the Flite platform.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Placement - Time on Unit\"\n}\n[/block]\nThis is a report on the amount of time that users spent engaging with this ad placement. At the top is a bar graph, showing the number of engagements broken down by engagement duration, which is measured as the time elapsed between the user's first and last interaction with this placement's impression. Underneath is a table with further detail:\n  * **Time on Unit:** The amount of time between a user's first interaction with this placement's impression, and their last interaction. Instead of giving exact durations, these are broken down into discrete time ranges:\n    * [0 – 5) s, [5 – 10) s, [10 – 15) s, [15 – 30) s, [30 – 45) s, [45 – 60) s,\n    * [1 – 2) min, [2 – 3) min, [3 – 4) min, [4 – 5) min,\n    * [5 – 10) min, [10 – 15) min, [15 – 30) min, [30 – 60) min,\n    * 60 min or greater\n  * **Engagements:** The number of engagements in which the user spent this amount of time on the unit.\n  * **Percent:** The percent of total engagements in which the user spent this amount of time on the unit.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"NOTE\",\n  \"body\": \"In the notation used above, a square bracket means *inclusive*, and a parenthesis means “not inclusive”. So, for example, [5 – 10) means greater than or equal to 5, and less than 10.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Placement - Geolocation\"\n}\n[/block]\nThis is a report on the distribution of impressions by country for this placement. At the top is a map of the world, with each country with a non-zero “Time on Unit” represented in a different color. Mouse over the country to see the “Time on Unit” metric for that country.\n  * **Country:** The country summarized in this row.\n  * **Impressions:** The number of impressions of this placement for this country.\n  * **Engagements:** The number of engagements of this placement for this country.\n  * **ER (%):** The engagement rate for this country.\n  * **IR (%):** The interaction rate for this country.\n  * **Time On Unit:** The time on unit for this country.\n \nPlease see the [Metrics Glossary](doc:metrics-glossary) for definitions of all the metrics terminology used here.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Placement - Auto Events\"\n}\n[/block]\nThis is a report on the type and number of automatic (non-user-initiated) events that have occurred. These are events like automatic video plays; for instance, a video may be set to start playing automatically as soon as the ad loads, or as soon as a particular tab in the ad loads.\n\nThe automatic events are summarized in a table with the following columns:\n  * **Label:** The label of the automatic event.\n  * **Payload:** The payload of the automatic event\n  * **Count:** The number of automatic events with this label and payload that have occurred for this placement.\n \nPlease see the Standard Labels and Payloads section for a list of standard event labels and payloads used by the Flite platform.","excerpt":"","slug":"design-studio-metrics-framework","type":"basic","title":"Metrics Framework"}

Design Studio

Campaign Studio

Report Studio

Metrics

Flite Console

Ad Ops

Component Studio

Metrics Framework

* [Overview](#overview) * [Placement Summary](#placement-summary) * [Placement Interaction](#placement-interactions) * [Placement - Time on Unit](#placement-time-on-unit) * [Placement - Geolocation](#placement-geolocation) * [Placement - Auto Events](#placement-auto-events) [block:api-header] { "type": "basic", "title": "Overview" } [/block] These reports show detailed metrics for a particular placement or set of placements. The following reports are available. * **Summary:** A summary report for the selected placement or set of placements. * **Interactions:** A report on all interactions broken down by interaction type. * **Label by Payload:** A report on all interactions of a particular type, broken down by payload. * **Clickthroughs:** A report on all clickthroughs broken down by target URL. * **Shares:** A report on all shares, broken down by share service. * **Share Type:** A report on all shares to a particular service, broken down by URL shared. * **Time on Unit:** A report on the amount of time users spent on this unit. * **Geolocation:** A report on the global distribution of ad impressions by country. * **Auto Events:** A report on all automatic (non-user-initiated) events, broken down by event label and payload. [block:api-header] { "type": "basic", "title": "Placement Summary" } [/block] This is a summary report of a single ad placement. The summary contains some key metrics for the placement, including its Performance Summary, a graph of Impressions, and a bar chart of Interactions by Type. Each is described below. Please see the [Metrics Glossary](doc:metrics-glossary) for more in-depth definitions of the metrics terminology. ## Performance Summary The performance summary allows you to view a summary of this placement’s key performance metrics at a glance. The metrics listed here are: * **Total Impressions:** The number of times that this ad placement has been displayed. * **Total Engagements:** The number of impressions with a user-initiated event. There can only be a maximum of one engagement counted per impression. * **Engagement Rate (ER):** The ratio of number of engagements to number of impressions (i.e. total engagements divided by total impressions). This is expressed as a percentage. * Total Interactions: The number of user-initiated events captured by the ad unit, such as hovers, clicks, scrolls, video plays, etc. * **Interactions per Engagement:** The average number of interactions per engagement (i.e. total interactions divided by total engagements). * **Interaction Rate (IR):** The ratio of ad interactions to the number of ad impressions (i.e. total interactions divided by total impressions). * **Average Time on Unit:** The average amount of time, in seconds, that each user spent on the ad unit. * **Clickthrough Rate (CTR):** The ratio of clicks on advertiser links to the number of impressions. ## Impressions A line graph representing day-by-day variations in the number of impressions for this placement. ## Interactions by Type A pie chart of all interactions broken down by type (hover, click, scroll, video play, etc.). [block:api-header] { "type": "basic", "title": "Placement Interactions" } [/block] This is a report on all interactions for this ad placement. All data is for the period specified using the global From and To dates, as defined in the Measure Module Header. At the top is a line graph, showing day-by-day variations in the total number of interactions on this placement. The chart underneath the graph contains the following columns: * **Label:** The type of interaction summarized in this row. There are several standard interaction labels that are used by Flite when tracking events. These are listed in the Standard Labels and Payloads section. Click on any of these labels to open the Label by Payload report for that particular interaction type. * ** Interactions:** The number of instances of this interaction type. * **Percentage (%):** The percent of total interactions that are of this type. Please see the[ Metrics Glossary](doc:metrics-glossary) for more in-depth definitions of the metrics terminology. ## Label by Payload This is a report on all interactions of a particular type for this ad placement. All data is for the period specified using the global From and To dates, as defined in the Measure Module Header. At the top is a pie chart showing all interactions of this type broken up by payload. For instance: * for interaction type "Tab Click", the payloads would be the names of the tabs; * for interaction type "Play", the payloads would be the names of the videos that were played; * for interaction type "Open", the payloads would be the URLs of the pages that were opened in a lightbox, or names of the widgets that were opened. The table underneath elaborates on the graph using two columns: * **Payload:** The payload for this row. For many interactions, this will be clickable. Click on the payload for a breakdown of each payload by custom string. * **Interactions:** The number of interactions of this type with this payload. Please see the [Metrics Glossary](doc:metrics-glossary) for more in-depth definitions of the metrics terminology and the Standard Labels and Payloads section for a list of standard interaction types and payloads used by the Flite platform ## Clickthroughs This is a report on clickthroughs for this placement. At the top is a line graph, showing day-by-day variations in the total number of clickthroughs on this placement. The table underneath the graph breaks the clickthroughs down by target URL using two columns: * **Target:** The target URL. * **Clickthroughs:** The number of clickthroughs for the corresponding target URL. ## Shares This is a report on shares for this placement. At the top is a line graph, showing day-by-day variations in the total number of shares for each share type. Underneath the graph is a table with the following columns: * **Share Type:** The type of share summarized in this row (e.g. LinkedIn, Twitter, Mobile, etc.). See Standard Labels and Payloads for a list of standard share types in the Flite platform. Click on a share type to open the Shares by URL page for that share type. * **Shares:** The number of shares of this type. This is the number of times a user shared a URL from the ad. * **Shares Clicked:** The number of Shares Clicked of this type. This is the number of times that somebody clicked on a link that has been shared using this share type. Note that the number of *Shares Clicked* will frequently be greater than the number of *Shares*, because a single share may be clicked multiple times. Please see the [Metrics Glossary](doc:metrics-glossary) for more in-depth definitions of the metrics terminology, including Shares and Shares Clicked. ## Share Type This is a report on all shares of a specific type (e.g. Twitter, LinkedIn or email) for this placement. At the top is a pie chart, which breaks down the total shares of the specified type by the URL that was shared. The table underneath elaborates on the graph using two columns: * **URL Shared:** The URL that was shared. * **Shares:** The number of times that URL was shared. Please see the Standard Labels and Payloads section for a list of standard share types used by the Flite platform. [block:api-header] { "type": "basic", "title": "Placement - Time on Unit" } [/block] This is a report on the amount of time that users spent engaging with this ad placement. At the top is a bar graph, showing the number of engagements broken down by engagement duration, which is measured as the time elapsed between the user's first and last interaction with this placement's impression. Underneath is a table with further detail: * **Time on Unit:** The amount of time between a user's first interaction with this placement's impression, and their last interaction. Instead of giving exact durations, these are broken down into discrete time ranges: * [0 – 5) s, [5 – 10) s, [10 – 15) s, [15 – 30) s, [30 – 45) s, [45 – 60) s, * [1 – 2) min, [2 – 3) min, [3 – 4) min, [4 – 5) min, * [5 – 10) min, [10 – 15) min, [15 – 30) min, [30 – 60) min, * 60 min or greater * **Engagements:** The number of engagements in which the user spent this amount of time on the unit. * **Percent:** The percent of total engagements in which the user spent this amount of time on the unit. [block:callout] { "type": "info", "title": "NOTE", "body": "In the notation used above, a square bracket means *inclusive*, and a parenthesis means “not inclusive”. So, for example, [5 – 10) means greater than or equal to 5, and less than 10." } [/block] [block:api-header] { "type": "basic", "title": "Placement - Geolocation" } [/block] This is a report on the distribution of impressions by country for this placement. At the top is a map of the world, with each country with a non-zero “Time on Unit” represented in a different color. Mouse over the country to see the “Time on Unit” metric for that country. * **Country:** The country summarized in this row. * **Impressions:** The number of impressions of this placement for this country. * **Engagements:** The number of engagements of this placement for this country. * **ER (%):** The engagement rate for this country. * **IR (%):** The interaction rate for this country. * **Time On Unit:** The time on unit for this country. Please see the [Metrics Glossary](doc:metrics-glossary) for definitions of all the metrics terminology used here. [block:api-header] { "type": "basic", "title": "Placement - Auto Events" } [/block] This is a report on the type and number of automatic (non-user-initiated) events that have occurred. These are events like automatic video plays; for instance, a video may be set to start playing automatically as soon as the ad loads, or as soon as a particular tab in the ad loads. The automatic events are summarized in a table with the following columns: * **Label:** The label of the automatic event. * **Payload:** The payload of the automatic event * **Count:** The number of automatic events with this label and payload that have occurred for this placement. Please see the Standard Labels and Payloads section for a list of standard event labels and payloads used by the Flite platform.