Skip to end of metadata
Go to start of metadata

Analytics Tab for Client Services

The Analytics tab lets you view detailed analytics for each application. The Analytics tab contains several sub-tabs to view different metric categories and create event funnels and queries. Each sub-tab is explained below.

Real-Time Tab

The Real-Time tab displays the number of currently active sessions, as well as the number of installs, sessions, and the average session length over the last hour. Note that all times are in Coordinated Universal Time (UTC).

Active Users - The number of users in the application at the moment.

Installs - The number of application installs over the past 15 minutes.

Sessions - The number of users in the application over the past 15 minutes.

Events - The number of events generated by the application over the past 15 minutes.

The real-time analytics information can be filtered by version and environment.

Installs Tab

The Installs tab displays the total number of installs of the application by platform, version, and location for the provided time period, version, and environment. To export the metrics data, click the Action Menu icon in the upper-right of the screen. For details on exporting the metrics, refer to Export Data. To close the metric overview, click the X icon. To disable showing the metric overview, select Do not show again for this metric.

In the Platform and Version views:

  • At the top, a line chart displays time series of the metric; hover your mouse over an inflection point in the chart to view data for that time.
  • Below the chart, a table displays additional details for the metric.

In the Location view:

  • Double-click the map to zoom in on a region to view more granular session counts by region.

  • Hover over a circle to view an outline of the region represented by the displayed count.

  • To zoom out, shift+click on the map. You can also use the on-screen zoom controls.

Unique Devices Tab

The Unique Devices tab displays the maximum daily number of unique devices using the application by platform and application version for the provided time period, version, and environment. The maximum unique devices number provides you with a measure of the number of real users using your application, normalized for the fact that some users may use the application multiple times a day. To export the metrics data, click the Action Menu icon in the upper-right of the screen. For details on exporting the metrics, refer to Export Data. To close the metric overview, click the X icon. To disable showing the metric overview, select Do not show again for this metric.

 In the Platform and Version views:

  • At the top, a line chart displays time series of the metric; hover your mouse over an inflection point in the chart to view data for that time.
  • Below the chart, a table displays additional details for the metric.

Sessions Tab

The Sessions tab displays the total number of user sessions for the application for the provided time period, version, and environment and how long on average users spent using it by platform and location. To export the metrics data, click the Action Menu icon in the upper-right of the screen. For details on exporting the metrics, refer to Export Data. To close the metric overview, click the X icon. To disable showing the metric overview, select Do not show again for this metric.

Session length is calculated based on the following user actions:

  • Starting and closing an application
  • Starting an application and putting it in the background
  • Resuming an application that was in the background, and returning it to the background
  • Resuming an application that was in the background, and closing it
Icon

If the application was placed in the background and resumed within the timeout value (default is 30 seconds), both events are canceled and the previous session remains active.

 In the Platform view:

  • At the top, a line chart displays time series of the metric; hover your mouse over an inflection point in the chart to view data for that time.
  • Below the chart, a table displays additional details for the metric

In the Location view:

  • Double-click the map to zoom in on a region to view more granular session counts by region.

  • Hover over a circle to view an outline of the region represented by the displayed count.

  • To zoom out, shift+click on the map. You can also use the on-screen zoom controls.

Avg. Session Length Tab

The Avg. Session Length tab displays the average length of use of the application by platform for the provided time period, version, and environment. To export the metrics data, click the Action Menu icon in the upper-right of the screen. For details on exporting the metrics, refer to Export Data. To close the metric overview, click the X icon. To disable showing the metric overview, select Do not show again for this metric.

Version Adoption Tab

The Version Adoption tab shows the number of sessions by platform version for the selected time period, version, and environment. To export the metrics data, click the Action Menu icon in the upper-right of the screen. For details on exporting the metrics, refer to Export Data. To close the metric overview, click the X icon. To disable showing the metric overview, select Do not show again for this metric.

Events Tab

The Events tab lists the name and number of each custom events generated by your application, as well as a timeline of when events were generated for the selected time period, version, and environment. To get custom events to appear on the list, you must build your application and trigger each event to ensure that the events are registered with the analytics engine. To export the metrics data, click the Action Menu icon in the upper-right of the screen. For details on exporting the metrics, refer to Export Data. To close the metric overview, click the X icon. To disable showing the metric overview, select Do not show again for this metric.

The Events tab also displays events generated by Appcelerator Mobile Backend Services API calls. Mobile Backend Services API events are named cloud-class-method

Event Funnels Tab

The Event Funnels tab lets you create new event funnels, edit existing event funnel, and view event funnel analytics for the selected time period, version, and environment. To export the metrics data, click the Action Menu icon in the upper-right of the screen. For details on exporting the metrics, refer to Export Data. To close the metric overview, click the X icon. To disable showing the metric overview, select Do not show again for this metric.

An event funnel is a sequence of custom events you define that corresponds to a process you want to measure and analyze.  For example, a shopping application would likely want to measure the flow of users through the process of searching for, viewing, and purchasing a product. By analyzing event funnel data you can identify, for example, where users drop out of the purchase process. For instructions on creating and viewing event funnels, see Appcelerator Analytics: Creating and Viewing Event Funnels.


Query Builder Tab

The Query Builder tab lets you create and view queries. For additional information on building queries, refer to Building Queries.

Analytics Tab for Mobile Backend Services

The Analytics tab lets you view detailed analytics for Mobile Backend Services APIs. The Analytics tab contains several sub-tabs to view different metric categories. Each sub-tab is explained below.

All APIs Tab

The All APIs tab displays the total number of Mobile Backend Services requests made during the provided time range and for the selected environment either by application or by type. To export the metrics data, click the Action Menu icon in the upper-right of the screen. For details on exporting the metrics, refer to Export Data. To close the metric overview, click the X icon. To disable showing the metric overview, select Do not show again for this metric.

Authentication Tab

The Authentication tab displays the number of requests, the daily average of requests, the top request, and the time of the last request per application or per application type for the authentication requests for the selected time period and environment. To export the metrics data, click the Action Menu icon in the upper-right of the screen. For details on exporting the metrics, refer to Export Data. To close the metric overview, click the X icon. To disable showing the metric overview, select Do not show again for this metric.

Communication Tab

The Communication tab displays the number of requests, the daily average of requests, the top request, and the time of the last request per application or per application type for the communication requests for the selected time period and environment. To export the metrics data, click the Action Menu icon in the upper-right of the screen. For details on exporting the metrics, refer to Export Data. To close the metric overview, click the X icon. To disable showing the metric overview, select Do not show again for this metric.

Custom Tab

The Custom tab displays the number of requests, the daily average of requests, the top request, and the time of the last request per application or per application type for the custom object requests for the selected time period and environment. To export the metrics data, click the Action Menu icon in the upper-right of the screen. For details on exporting the metrics, refer to Export Data. To close the metric overview, click the X icon. To disable showing the metric overview, select Do not show again for this metric.

Location Tab

The Location tab displays the number of requests, the daily average of requests, the top request, and the time of the last request per application or per application type for the location requests for the selected time period and environment. To export the metrics data, click the Action Menu icon in the upper-right of the screen. For details on exporting the metrics, refer to Export Data. To close the metric overview, click the X icon. To disable showing the metric overview, select Do not show again for this metric.

Media Tab

The Media tab displays the number of requests, the daily average of requests, the top request, and the time of the last request per application or per application type for the media requests for the selected time period and environment. To export the metrics data, click the Action Menu icon in the upper-right of the screen. For details on exporting the metrics, refer to Export Data. To close the metric overview, click the X icon. To disable showing the metric overview, select Do not show again for this metric.

Social Tab

The Social tab displays the number of requests, the daily average of requests, the top request, and the time of the last request per application or per application type for the social requests for the selected time period and environment. To export the metrics data, click the Action Menu icon in the upper-right of the screen. For details on exporting the metrics, refer to Export Data. To close the metric overview, click the X icon. To disable showing the metric overview, select Do not show again for this metric.

Data Filters

When viewing analytics, you can filter analytics data by the time period, the version number of the application, and environment (development or production). Click the appropriate drop-down box and select a filter option.  The data in the dashboard page will be updated based on the new filter setting. Note that the filters you select persist when navigating through the Dashboard.

Custom Date/Time Range Filter

To filter data for a specific time period, either select one of the predefined options or specify a custom start and end date/time. To use the custom date/time range filter:

  1. Click on the date filter and select a granularity level from the granularity drop-down list.
    1. Last 3 Months: aggregate results by the last 3 months.
    2. Last 30 Days: aggregate results by the last 30 days.
    3. Last 7 Days: aggregate results by the last 7 days.
    4. Last 24 Hours: aggregate results by day.
    5. Last 60 Minutes: aggregate results by last 60 minutes.
  2. To set a custom time range, click on one of the calendar date fields.
  3. Select a start and end date with the calendar widget. The date range is capped to one year.
  4. If the dates selected are less than four days apart, you also need to select a start time and end time with the time picker.
  5. Click Set.

The data on the dashboard page will be updated based on the newly set data/time range filter. Note that the filters you select persist when navigating through the Dashboard.

Export Data

You can export chart and table data to CSV format to use in other programs, such as Microsoft Excel, to analyze offline.

  1. To export data, first select the data you want to export, including the time frame, version, and environment. The data frequency is based on the granularity level selected in the custom date/time range filter.
  2. To refresh the data export, click the Refresh icon.
  3. Click the Action Menu icon, then select either:
    1. Chart - To export the data in the chart.
    2. Table - To export the data from the table.

Once you select the export option, your data download begins.

Unspecified Metric Names and Values

In some cases, a metric's value may be unknown to the Dashboard analytics engine. In such cases, a placeholder value – "(not set)" – or placeholder is displayed instead. The following describes why, when, and where these placeholder values appear.

Platform Icons for Mobile Backend Services Requests

In the metrics for Mobile Backend Services Requests, if a Mobile Backend Services API call originated from a source other than a Titanium application or native iOS application using AMPLIFY Appcelerator Services SDK, an icon is displayed. For instance, this icon would appear for calls made to the Mobile Backend Services APIs using a command-line tool, such as cURL.

Version and Environment Values for Crash and Test Metrics

When viewing Test and Crash analytics, the Version and Environment drop-down menus display "(not set)" since version and environment are not available. For the same reason, graphs that display a version series of Crash or Test metrics will display "(not set)"

Geographic Analysis

On a metric's Geo tab, if the country could not be determined from the metric's included geographic coordinates or coordinates were not provided at all, "(not set)" is displayed as the Country name.

  • No labels