Dashboards and Reports

The Dashboard is what we call the navigational and informational views of your Urban Airship apps. There are two levels within Engage:

  1. All your apps, listed at go.urbanairship.com/apps. See Your Apps.

  2. An individual app, after you’ve opened it from the list of all your apps. See App Dashboard.

A third definition is specific to Insight:

3. A collection of topical reports. The reports are contained in Insight dashboards:

Choose your app from the Urban Airship dashboard, click Insight in the navigational header, then click an Insight dashboard name. Each dashboard and its reports are detailed in Dashboard Reports. The default view is the Overview dashboard.

The next section, Exploring, describes the features common to all reports.

Exploring

Each dashboard has the same basic layout and options above the dashboard’s reports.

The dashboard name is followed by the app’s industry. At the end of the same row is the time the reports in the dashboard last ran, and a gear icon dropdown menu. To download a formatted PDF of the dashboard, click the dropdown menu and select Download as PDF.

Optionally edit the default file name, then click a button to either Open in Browser or Download.

If the wrong industry selections were made during during set up, click the industry and sub-industry shown in the upper right corner of the dashboard, select from the dropdown menus, then click the Change Industry button. This requires Owner, Administrator, or Full Access permissions.

The next row displays the dashboard’s default Filters and a Run button. Click anywhere in the row to expose the filter options.

  • The default value for the Date Range filter is “in the past 7 days.”

  • The default value for the App Name filter is the current Engage app name.

  • Click the plus sign (+) at the end of a filter row to add another filter of the same type, which will be processed as a Boolean OR. Click the X to remove an added filter row.

  • After making changes to filters, click the Run button. The reports below will update, as will the last ran time stamp in the row above.

Explore View

Each dashboard contains multiple reports of various Visualization types. While the formats differ, each report can be further explored from dashboard, as well from within the Explore view:

  • Hover over displayed data to see detail pop-ups.

  • Click report data or any gear icon to expose Download and Explore options.

Click a report’s name from the dashboard to go directly to the Explore view. Once there, you can begin to further slice the chosen report. The Explore view is the same for all reports.

The header includes the report name, and a Run button and gear icon dropdown menu are at the end of the header row.

The left side menu contains a search field for the Dimensions and Measures beneath it. Toggle the menu exposure by clicking + / - in the upper right corner of the menu. Selections made in the left side menu are immediately reflected in the Filters and Data sections of the Explore view.

Filters

  • The default value for the App Name filter is the current Engage app name.

  • Click the plus sign (+) at the end of a filter row to add another filter of the same type, which will be processed as a Boolean OR. Click the X to remove an added filter row.

  • After making changes to filters, click the Run button. The reports will update, and a last ran time stamp will appear to the left of the button after its first run.

Check the box for Custom Filter at the end of the Filter section header to expose the entry box.

Visualization

Each report opens to its default Visualization type. To view the report in another Visualization format, click an icon in the section header. Click the ellipses at the end to expose a dropdown menu with additional choices. Click Edit or the gear icon at the end of the header to see options sepecific to the selected Visualization type.

Available types:

  • Table

  • Column

  • Bar

  • Scatterplot

  • Line

  • Area

  • Pie

  • Map

  • Single Value

  • Static Map (Regions)

  • Static Map (Points)

  • Donut Multiples

  • Single Record

Some Visualization types may be incompatible with the Dimensions and Measures available in a report.

Data

Data is essentially the Table type of Visualization.

To bookmark your explorations, open the Explore view in a new window. Ctrl+Click (Windows) or ⌘++Click (Mac) any report name or data point. You can then use your browser’s bookmark feature to save the explored view.

Dashboard Reports

The number of reports, as well as the styles and options, vary per dashboard. Note that if you have just recently purchased Insight, you must wait for your dashboards to be populated with data.

Each dashboard has an app name filter and a time range filter that defaults to the last 30 days which will apply to most reports in the dashboards.

The following Dashboards are available:

  • Overview — Quickly understand active users and high-level message metrics.

  • Predictive — Learn about users across churn risk groups and churn mitigation performance.

  • Lifecycle — View trends of new users and app uninstalls.

  • Messages — Explore detailed results of your messaging.

  • Cohorts — Review user activation and retention data.

  • Revenue — Understand the revenue generated by your app and the conversion metrics for your app.

  • Location — See where your users have been within the last day.

  • Device Properties — Learn OS and app versions, languages, and other device-specific settings and information.

  • Profile — View user attribute tag tag counts.

Overview

The Overview dashboard displays the user count for each report.

Available reports:

Daily Active Users

The number of unique users that opened your app in the last 1 day (does not include today).

Weekly Active Users

The number of unique users that opened your app in the last 7 days (does not include today).

Monthly Active Users

The number of unique users that opened your app in the last 30 days (does not include today).

Users inactive in the last day

The number of unique users that were not active 1 day ago but were active in the 6 days prior.

Users inactive in the last 7 days

The number of unique users that were not active in the last 7 days but were active in the 14 days prior.

Users inactive in the last 30 days

The number of unique users that were not active in the last 30 days but were active in the 30 days prior.

Authenticated Users

The number of users that opened your app with a named user that has been set for them previously.

Inactive Users

Two date range filters are needed to get a count of Inactive Users:

  • App Open Date is used to look at a window of activity for users that opened the app. For example, for Users inactive in the last day, this filter is set to “is in the past 7 complete days.”

  • Last Seen Date is used to pick a relative point in time in which to filter out users that have only been seen before the chosen date. For example, for Users inactive in the last day, this filter is set to “is before (relative) 1 day ago.”

Adding an Uninstall field allows you to see which inactive users have uninstalled in the period after their last seen activity. Follow these steps after opening a Users inactive… report.

  1. In Filters, set the Last Seen Date filter to “is any time.”

  2. In Visualization, select Column.

  3. Click the plus sign in the upper left corner to display the left side menu, if it is not already open.

  4. In the left side menu, under Inactive Users » Last Seen Date, click Date.

  5. Click the Run button.

Now you can see the days in which the Last Seen Date for users was the highest and better understand why that may have been the last time they were in your app.

Predictive

The Predictive dashboard is a view into Predictive Churn risk groups, distribution of users across and opt-in rates within the risk groups, as well as the performance of churn mitigation.

Predictive tags are added on Sundays, and the reports default to the most recent Sunday. You must have at least five weeks of churn analysis for the Historical Predictive Churn Outcome report to populate.

See the Predictive Churn topic guide and video tutorials.

Available reports:

Low Churn Risk Users

Users least likely to become inactive in the next 30 days.

Medium Churn Risk Users

Users who exhibit signs of potentially becoming inactive in the next 30 days.

High Churn Risk Users

Users most likely to become inactive in the next 30 days.

Risk Distribution

Percentage breakdown of Low, Medium and High Risk users based on the last prediction in the timeframe (date in center). Click to drill down to a view where you can identify users’ channel IDs.

Top 25 Device Tags by Risk Distribtion

List the top 25 device tags by user count split by predictive churn risk category.

Average Sends per Weekly Churn Transition

The average number of messages sent to each user in a one week period, based on the users’ transition between churn risk categories. This can help you understand how message frequency correlates to users in the low risk category.

Historical Predictive Churn Outcome

A historical view of the peformance of churn prediction. The left side shows the predictions that occurred four weeks prior to the date selected in the Date Range filter. On the right side are the categories of those same users at the end of the fourth week.

If you are not taking action on your highest risk users, a majority of them will become inactive. This report gives you an easy way to see what happened to those users and can give you confidence that our model is performing well or that your actions have caused High and Medium Risk users to move into the Low Risk category.

Lifecycle

The Lifecycle dashboard displays the user count for each Active Users report. Line graphs show user counts over time and broken down by platform.

Available reports:

Daily Active Users

The number of unique users that opened your app in the last 1 day (does not include today).

Weekly Active Users

The number of unique users that opened your app in the last 7 days (does not include today).

Monthly Active Users

The number of unique users that opened your app in the last 30 days (does not include today).

New Users

Daily count of new users that opened the app for the first time broken down by platform along with the total. Sessions Daily count of the number of times the app was opened.

Uninstall

The number of uninstalls for each day. Uninstall information is only available for a user you have sent a notification to.

Daily Active User Trend

Daily count of users that opened the app broken down by platform along with the total.

User Session Duration

The distribution of user session durations in minutes for the given time range. In the Explore View, filter by a specific push ID, or slice by tags.

Messages

The Messages dashboard displays report lists detailed results of your messaging.

Available reports:

Top 50 Notifications sent

View the top notifications sorted by send count. Only notifications that are sent to an audience larger than 1 are shown in this table. Direct open rate is equal to Direct Open Count / Sent Messsage Count. Indirect open rate is equal to Indirect Open Count / Sent Message Count. Indirect opens are defined as anyone that opens the app after receiving the notification listed.

A/B Tests

Variant ID is CONTROL for the control group, then 0 = A, 1 = B, etc. Click a measure to get a list of users.

Top 50 Rich App Pages

A listing of Rich Message metrics.

Top 50 Automation Messages

Automation messages sent during the selected date range.

In App Impressions

See performance metrics in the Top 50 Notifications sent report. Follow these steps after opening the report.

  1. Click the plus sign in the upper left corner to display the left side menu, if it is not already open.

  2. In the left side menu, under Messaging Report » Dimensions, enable Filter for In App Message Impression Rate and In App Message Impression User Count.

  3. In Filters, set the In App Message Impression Rate filter to “is greater than,” and enter zero (0) as the value.

  4. Click the Run button.

  5. Optionally click the user count or rate within the returned data to drill down to a view where you can export user IDs.

Cohorts

The Cohorts dashboard displays reports of user activation and retention data.

Available reports:

Retention by Install Week

See the activity of new users over time. Each row represent a cohort of users that opened the app for the first time in the labeled week. The install count represents all the users that installed in the calendar week. Day One retention is the percentage of people that opened the app the next day after install. Day One through Seven Retention, 7-14, and 14-30 is the percentage of people that opened the app anytime between that range from the install cohort.

Activation Cohort

An activation cohort gives you a view of the group of people who complete a specific event in your app, as well as their open activity each day after completing the event. This type of report is helpful for finding which events in your app ultimately lead to a user returning day after day. This is often referred to as a behavioral cohort as opposed to a retention cohort, which tracks activity of users after an install.

Revenue

The Revenue dashboard helps you understand key performance indicators associated with revenue generation or related events. This dashboard is customized based on your Industry type. All your custom events are in this dashboard as well.

Available reports:

Total Purchase/Shared Value

Sum of all event values for those named [Purchase or Shared, depending on industry] over the given time range.

Purchase/Shared Value per User

Total [Purchase or Shared, depending on industry] Value divided by the number of distinct users.

Retail/Content Funnel

Users that followed the [Retail or Content, depending on industry] funnel path over the date range selected. See Supported funnels list below.

Custom Events Table

All custom events that occured in the given time range.

Supported funnels:

Media

browsed_content » consumed_content » shared_content

Retail

browsed » added_to_cart » purchased

Travel & Transportation

browsed » added_to_cart » purchased

Total Revenue

All purchase revenue over the date range.

Revenue per user

Average purchase revenue per customer that purchased.

Retail Funnel

The total value for the browsed, added_to_cart and purchased event.

Retail Funnel Counts

The total number of times users browsed, added_to_cart and purchased.

Location

The Location dashboard provides a way for you to understand where your active users are, as well as their behaviors.

For the reports listed below, the User Locations report is based on automatic location events via a device’s GPS. See the Location Triggers topic guide. The remaining reports are based on usage of our Region framework via Gimbal and other beacon providers. See Location Triggers: Gimbal Setup.

Region data exists as enter or exit records triggered by entering or exiting a region. A region is defined by either a geofence or beacon.

In the Location dashboard’s filter:

  • Recent Activity refers to activity prior to entering a region. By default, the Recent Activity Window is twelve (12) hours and affects recent send, direct open, and indirect open calculations.

  • Date Range refers to the date range of region activity. The Recent Activity Window will always extend the appropriate number of hours prior to the date range.

See Exploring for information about dashboard layouts and filtering.

Available reports:

User Locations

Your users’ locations within the last whole day are represented in a heat map. See the legend in the lower left corner for numeric values. Drag and zoom to concentrate the view on a specific region.

Total Arrivals

The number of times users triggered a geofence or beacon by entering a region during the selected date range.

Unique Users

The number of unique users that triggered a geofence or beacon during the selected date range.

Average Dwell Time (min)

The average dwell time in minutes of a user while in a geofence or the vicinity of a beacon during the selected date range.

The dwell time within a region is derived by matching an enter record to an exit record. Records are matched for a user if they are consecutive actions within the same region within twelve hours. Unmatched records are not included in dwell time calculations.

Arrivals by Hour

A line graph of the number of enters per hour for the last seven days by platform.

Top 15 Regions by Total Arrivals

A bar chart of the top regions by overall enter record count. The first enter for each user is represented in blue and can be thought of as a unique count for each region. All subsequent visits are considered repeat enters and represented in green.

Unique Regions Encountered per User

The distribution of users by the number of distinct regions they encounter.

Region Dwell Time in Minutes

The distributions of dwell time for all visits.

Profile

The Profile dashboard displays current tag count reports.

Available reports:

Top 50 Device Tags Added (During Date Range)

The top 50 tags that users added over the specified date range. The date range defaults to the past 7 days.

Top 50 Device Tags (All Time)

The top tags among your devices. The tag counts are partitioned by opt-in status. Click the name of the report to splice the tags by tag group, opt-in status, or specific device properties.

Device Properties

The Device Properties dashboard provides information about your users’ devices. Urban Airship SDK version, app version, opt-in enabled/disabled, and other device-relevant metadata is accessible via this dashboard.

Unless otherwise indicated, the data in each report corresponds to the date range specified in the Filters section.

Available reports:

Notification Opt-in Enabled Devices (All Time)

Percentage of opted-in and opted-out devices, split by platform. These charts display the total number of opted-in/out devices on your app:

At the bottom of the report, you will see iOS Opt-In Benchmarks. These numbers provide some guidance on industry standard opt-in/out rates, based on our benchmark studies. The Low, Medium, and High percentages indicate the 10th, 50th, and 90th percentiles, respectively, for your industry.

Notification Opt-in Enabled Devices (During Date Range)

Percentage of users that have opted-in or out of push notifications during the specified date range.

Background Enabled (During Date Range)

Percentage of background-enabled Devices.

Location Enabled (During Date Range)

Percentage of location-enabled devices.

Timezones (Top 50) (During Date Range)

The top 50 timezones among your users.

Language Country (Top 50) (During Date Range)

The top 50 country tags among your users.

Language (Top 50) (During Date Range)

The top 50 language tags among your users.

iOS Model (Top 50) (During Date Range)

The top iOS models among your users.

iOS Version (Top 50) (During Date Range)

The most frequently installed iOS versions among your users.

iOS App Version (Top 50) (During Date Range)

The most frequently installed iOS app versions among your users.

iOS UA Version (During Date Range)

The most frequently installed iOS SDK versions among your users.

Android Version (Top 50) (During Date Range)

The most frequently installed Android versions among your users.

Android App Version (During Date Range)

The most frequently installed Android app versions among your users.

Android UA Version (During Date Range)

The most frequently installed Android SDK versions among your users.