ECO Metrics

 

ECO provides a robust set of metrics to enable application performance monitoring and user behavior analysis across your web and native applications. Metric values appear as time series and distributions in metric widgets, and alongside dimensional values in the dimension drill-down tables. Selecting different metric widgets changes the metrics in the dimension tables.

 

 

Metrics can span either a specific interval or a complete session.

  • Session Metrics: Metrics based on data from events that occur throughout sessions that end within the selected time interval, for example App Video Bounce Rate metric from sessions that ended yesterday. If a session starts before the selected time interval but ends within it, the data for that session is still considered for the calculation of the session metrics.

  • Interval Metrics: Metrics based on data from events that occur within a specific interval during sessions, for example, Total Events, the cumulative count of mapped events occurring within a specific interval during sessions.

Note: A session begins when a device sends one of the following events to the application server: screen_view, page_view, page_ping, periodic_heartbeat, application_foreground, conviva_video_events, or application_error. The session ends when the application server does not receive any of these events within 90-seconds.

In addition to the metrics designed by Conviva to optimize your analysis, ECO supports a custom metric builder so you can create customized metrics based on your specific requirements. For more details, see Metric Builder.

Secondary Metric

Selecting a metric widget in ECO also displays a secondary metric that provides a context or related data to help you more completely understand the primary metric. Secondary metrics enhance the interpretation and analysis of primary metrics.

Secondary metrics display in the dimension panel after clicking a metric widget in the metric panel, for example Ended Session Count displays as a secondary metric for App Video Bounce Rate.

Conviva uses a proprietary combination of native and web applications events to provide a rich set of application performance and experience metrics. The Conviva ECO Sensor supports application events, such as page_view and network_request.

Event Type Semantic Mapping Metric Building Metric in App

Custom Events

For example, User seek action.

  • Map raw events to unified semantics in Semantic Mapper

  • Assign event tag and event value to map events

Use mapped events to build metrics.

 

Metrics based on the mapped events appear in App pages.

For example, to track and analyze user behaviors when seeking videos, map the events seek_forward, seek_backward, seek_bar_dragged_forwards, and seek_bar_dragged_backwards to an event User seek action.

For example, to track the user login behavior and analyze the login success rate, map the event button_click with the tag key button_click_element_text and the tag value Log in to an event Login Button Click.

 

Automatically Collected Events and Minimum SDK Versions

   Conviva App Sensors
 

Android

iOS

JS SDK

C SDK

Roku

    Minimum App SDK 0.5.2 0.2.10 0.3.17 2.183.0.0 0.2.3
Automatically Collected Event Event Source Minimum Video SDK 4.0.30 4.0.32 4.5.13 No No
network request After receiving the network request response   Autocollected,
displays in ECO, Device Modeling Dashboard		 Autocollected,
displays in ECO, Device Modeling Dashboard		 Autocollected,
displays in ECO, Device Modeling Dashboard		 Not applicable for devices Report manually

screen_view

 On screen interaction, either first launch or re-launch   Autocollected,
displays in ECO, Device Modeling Dashboard		 Autocollected,
displays in ECO, Device Modeling Dashboard		 Not applicable for devices Not applicable for devices Report manually

application_error

 On error in application   Autocollected,
displays in ECO, Device Modeling Dashboard		 Autocollected,
displays in ECO, Device Modeling Dashboard		 Autocollected,
displays in ECO, Device Modeling Dashboard		 Not applicable for devices Report manually

button_click

 On button click callback   Autocollected,
displays in ECO, Device Modeling Dashboard		 Autocollected,
displays in ECO, Device Modeling Dashboard		 Autocollected,
displays in ECO, Device Modeling Dashboard		 Not applicable for devices Report manually

application_background

 When application moves to the background   Autocollected Autocollected Not applicable for devices Not applicable for devices Report manually

application_foreground

 When application moves to the foreground   Autocollected Autocollected Not applicable for devices Not applicable for devices Report manually

application_install

 When application is launched for the first time after install. (not exactly installed time)   Autocollected Autocollected Not applicable for devices Not applicable for devices Report manually

deep_link_received

 On application open using the UTM URL.   Autocollected Autocollected Not applicable for devices Not applicable for devices Report manually

anr_start

 When timer starts for the response from the main thread. If more than 4 seconds, event is triggered.   Autocollected Report manually Not applicable for devices Not applicable for devices Report manually

anr_stop

 When SDK gets response after triggering anr_start, anr_end is dispatched.   Autocollected Report manually Not applicable for devices Not applicable for devices Report manually

link_click

 On link click callback   Report manually Report manually Autocollected Not applicable for devices Report manually

 

Out-of-Box ECO Metrics and Metadata
Category Metrics
App Audience and

Engagement

Active Devices

Active Users

App Crashes

App Sessions

App Startup Count

App Video Bounce Rate

Avg App Startup Time

Avg Minutes Per Page

 

Avg Network Request Duration

Avg Page Load Time

Avg Screen Load Time

Ended Session Count

Ended Session Count (Mobile/Web)

Network Request Count

Page Load Complete

Page Loads

Screen Loads

Time to First Attempt

Total Events

Total Events Per User Active Hour

User Active Time

User Events

Web Errors

 

 Out-of-Box ECO and Video Dimensions

Category

Metadata

Ad

Ad Assets

Ad Creative Id

Ad Id

Ad Media File API Framework

Ad Position

Ad System

 Ad Technology
Content

App Name

App Version

Assets

CDNs

Channel

Content Category

Last CDN Edge Group

Last CDN Edge Server

Platform Version

Device

Browser Name

Browser Version

Device Hardware Type

Device Manufacturer

Device Marketing Name

Device Model

Device Name

Device Operating System

Device Operating System Family

Device Operating System Version

Player Framework Name

Player Framework Version
GEO AS Numbers

Cities

Countries

Continents

DMAs

ISPs

States

 

 

ECO Metrics

Metric Definition Secondary Metrics Supported Sensors
Metrics for Analyzing Only Native Applications Performance

Note: Native applications are applications installed on mobile devices or TVs.
App Crashes

The total count of unique occurrences of the application_error event within a mobile app during the specified time interval.

Note: Enabling the percentage mode displays the metric in percentage format, representing the proportion of sessions with application errors in a native application. This calculation divides the number of sessions containing native application errors by the total native app session count.

 App
Sessions

  • Conviva Android Sensor

  • Conviva iOS/tvOS Sensor
Avg Screen Load Time

The average duration, measured in seconds, to completely load a screen in a mobile app. The metric is calculated by dividing the total time in seconds for loading screens on a mobile app, starting from the initiation of loading screens to the completion of loading in the mobile screen, by the number of loaded screens.

 

Distribution: App Start Up Complete vs Avg Screen Load Time Distribution: a distribution by preset buckets, where each bucket displays the total screen load complete count in a specified range for corresponding average screen load time. This distribution helps you understand screen load time and app performance, enabling you to optimize both the app and screen.

 Screen
Loads

  • Conviva Android Sensor

  • Conviva iOS/tvOS Sensor
Avg App Startup Time

The average duration, measured in seconds, for an app to start. This metric is calculated by dividing the total launch time in seconds for a mobile app by the number of the event app launch.

 

Distribution: App Start Up Complete vs Mobile App Startup Time Distribution: a distribution by preset buckets, where each bucket displays the app start up complete count in a specified range for corresponding average duration for an app to start. This distribution helps you to identify performance issues and optimize the performance of apps.

App
Startup
Count

  • Conviva Android Sensor

  • Conviva iOS/tvOS Sensor
App Startup Count

The number of the event app launch during the specified time interval.

 N/A

  • Conviva Android Sensor

  • Conviva iOS/tvOS Sensor
Screen Loads

The number of screen id changes that occurstartred within the selected time interval.

 

 N/A

  • Conviva Android Sensor

  • Conviva iOS/tvOS Sensor
Ended Session Count (Mobile)

The total number of sessions that ended during the specified time interval.

 N/A

  • Conviva Android Sensor

  • Conviva iOS/tvOS Sensor
Metrics for Analyzing Only Web Applications Performance  
Web Errors

The total count of unique occurrences of the application_error event within a web page during the specified time interval.

Note: Enabling the percentage mode displays the metric in percentage format, representing the proportion of sessions with application errors in a web application. This calculation divides the number of sessions containing web application errors by the total web app session count.

 App Sessions Conviva JS Sensor
Avg Minutes Per Page

The average duration, measured in minutes, that users spend on each web page. The metric is calculated by dividing the total duration of time users spend on each web page by the number of pages.

 

Distribution: Page Load Complete Count vs Avg Minutes Per Page Distribution: a distribution by preset buckets, where each bucket displays the total page load complete count in a specified range for corresponding average minutes per page. This distribution helps you understand audience engagement with web pages and optimize them accordingly.

 Page Loads Conviva JS Sensor
Avg Page Load Time

The average duration, measured in seconds, of all valid page loads. The metric is calculated by dividing the total time taken to load pages, from the initiation of the page view to the completion of loading in the browser, by the number of loaded pages.

 

Distribution: Page Load Complete Count vs Avg Page Load Time Distribution: a distribution by preset buckets, where each bucket displays the total page load complete count in a specified range for corresponding average page load time. This distribution helps you understand page load time and app performance, enabling you to optimize both the app and page.

 Page Loads Conviva JS Sensor
Page Load Complete

The total count of pages that loaded completely.

Note: Enabling the percentage mode displays the metric in percentage format, representing the proportion of total count of pages that loaded completely. This calculation divides the total count of pages that loaded completely by the number of page URL changes.

 N/A Conviva JS Sensor
Page Loads

The number of page URL changes that occurred within the selected time interval.

 N/A Conviva JS Sensor
Ended Session Count (Web)

The total number of sessions that ended during the specified time interval.

 N/A

  • Conviva JS Sensor
Metrics for Analyzing Web and Native Applications Performance

Note: If you integrate both your web and native applications with the Conviva sensor, these metrics are calculated using data from both types of applications.
Active Devices

The total number of devices that generated at least one event within sessions during the specified time interval.

 N/A

  • Conviva Android Sensor

  • Conviva iOS/tvOS Sensor

  • Conviva JS Sensor
Active Users

The total number of unique users who generated at least one event within sessions during the specified time interval.

 N/A

  • Conviva Android Sensor

  • Conviva iOS/tvOS Sensor

  • Conviva JS Sensor
Network Request Count

The total number of the network_request event during the specified time interval.

 N/A

  • Conviva Android Sensor

  • Conviva iOS/tvOS Sensor

  • Conviva JS Sensor
App Video Bounce Rate

The percentage of sessions that did not include the video attempt event in an app. The metric is calculated as the total number of sessions without the video attempt event in an app, divided by the total number of sessions in the app.

Note:  Need to install the Video SDK to use the metric.

 Ended
Session Count

  • Conviva Android Sensor

  • Conviva iOS/tvOS Sensor

  • Conviva JS Sensor
App Sessions

The total count of sessions that occurred during the specified time interval.

 N/A

  • Conviva Android Sensor

  • Conviva iOS/tvOS Sensor

  • Conviva JS Sensor
Avg Network Request Duration

The average duration, measured in seconds, for web servers to handle network requests, including the time taken to receive, process, and respond. This metric is calculated by dividing the total duration of the entire process for web servers to handle network requests by the total number of the network_request event.

 

Distribution: Total Request Count vs Avg Network Request Duration Distribution: a distribution by preset buckets, where each bucket displays the total request count in a specified range for the corresponding average network request duration. This distribution helps you to identify performance issues and optimize the performance of web applications.

Note: Network request is a type of web request that allows web pages to update content dynamically without requiring a full page refresh.

 Network
Request Count

  • Conviva Android Sensor

  • Conviva iOS/tvOS Sensor

  • Conviva JS Sensor
Ended Session Count

The total number of sessions that ended during the specified time interval.

 N/A

  • Conviva Android Sensor

  • Conviva iOS/tvOS Sensor

  • Conviva JS Sensor
Time To First Attempt

The average duration, measured in seconds, within a session before the first video attempt. This metric is calculated by dividing the total interval time from the “session start” event to the first video attempt event as a type of conviva_video_events by the number of sessions during which the viewer clicked play or the video auto-played generating a video attempt event.

 

Distribution: First Attempt Count vs Time To First Attempt Distribution: a distribution by preset buckets, where each bucket displays the count of first attempt in a specified range for corresponding average duration within a session before the first video attempt. This distribution helps you understand user engagement with videos in your app and optimize their accessibility and visibility.

Note:  Need to install the Video SDK to use the metric.

 App
Sessions

  • Conviva Android Sensor

  • Conviva iOS/tvOS Sensor

  • Conviva JS Sensor
Total Events

The count of mapped events.

 N/A

  • Conviva Android Sensor

  • Conviva iOS/tvOS Sensor

  • Conviva JS Sensor
Total Events Per User Active Hour

The average event count per active user hour. The metric is calculated by dividing the total number of events by the total amount of hours users spend actively engaged in a native application or a web application.

 N/A

  • Conviva Android Sensor

  • Conviva iOS/tvOS Sensor

  • Conviva JS Sensor
User Active Time

The total time user spends in app within a single session.

 Active
Devices

  • Conviva Android Sensor

  • Conviva iOS/tvOS Sensor

  • Conviva JS Sensor
User Events

The count of events, such as the page_view event, excluding the page_ping, periodic_heartbeat, and network_request events.

 N/A

  • Conviva Android Sensor

  • Conviva iOS/tvOS Sensor

  • Conviva JS Sensor
Network Request Failure

The total number of failed network requests during the specified time interval. A network request is classified as failed if its response code is not null, and is outside the range from 100 to 399.

This metric is only available for the preset Server Side Performance dashboard.

Note: Enabling the percentage mode displays the metric in percentage format, representing the proportion of total count of failed network requests. This calculation divides the total count of failed network requests by the number of network requests.

 Active Device

  • Conviva Android Sensor

  • Conviva iOS/tvOS Sensor

  • Conviva JS Sensor

 

 

ECO Metrics ECO Metrics App Crashes App Crashes Avg Screen Load Time Avg Screen Load Time Mobile App Startup Time Mobile App Startup Time App Startup Count App Startup Count Screen Loads Screen Loads Web Errors Web Errors Avg Minutes Per Page Avg Minutes Per Page Avg Page Load Time Avg Page Load Time Page Load Complete Page Load Complete Page Loads Page Loads Active Devices Active Devices Active Users Active Users Network Request Count Network Request Count App Video Bounce Rate App Video Bounce Rate App Sessions App Sessions Avg Network Request Duration Avg Network Request Duration Ended Session Count Ended Session Count Time To First Attempt Time To First Attempt Total Events Total Events Total Events Per User Active Hour Total Events Per User Active Hour User Active Time User Active Time User Events User Events