Understanding Results

The Upsight Events module is broken down into two sections:

  • Event Details
  • Event Timeline


Event Details

The Event Details give you an in-depth view into how often any custom event occurs within your app. This view shows a total count of events triggered. You will also be able to view the percentage of Events per Unique user and the percentage of Event Distribution for the selected time range.

Note Even if instrumented in your apps’ code, Events will not display on the dashboard until a user triggers the actual in-app event.


Event Timeline

The Event Timeline lets you compare changes in Upsight events over time, session length, and use. In this section, we can view 3 charts:

  • Percentage Event Distribution Timeline
  • Total Event Distribution Timeline (Normalized)
  • Total Event Distribution Timeline

This section is extremely helpful in seeing the percentage breakdown of a group of similar events triggered within the selected time frame. For example, it can help answer questions such as "What main menu option was chosen most last week?" or "What purchase package generated the largest total value this month?".

Note In this section, you can change the x-axis by session, time since install, time on app, and level. The Level is equal to the integer passed to Upsight in the l parameter.

In addition to the Events module, Upsight has the Funnels module that also uses Upsight Events to populate its charts. But instead of viewing events as counts, Funnels show how many users triggered the event. For example, the Funnel can show 10 users, but those 10 users could have triggered the specific event over 100 times each during the selected time period. There are two types of Funnels - enforced and unenforced.

For additional information on Funnel setup, please see the funnel section.


Enforced Funnel

The enforced funnel will allow you to analyze a series of events in a logical path analysis, not to be confused with user path analysis. In order for a user to appear in one of the funnel steps, the user must have completed the previous steps of the funnel in no particular order. With funnels, you will see the number of users who started with the first event and how many of those users reached the final event of your funnel.

Note A user does NOT have to complete the selected events in order. For example, a user can reach event D by completing the events as A, B, C, D or C, B, A, D.


Unenforced Funnel

The unenforced funnel view will allow you to analyze user behaviour when a user is given multiple choices after an initial event. It’s a powerful tool that unveils the most popular path users take within your app. For example, unenforced funnels can help determine the most popular item of your in-app store or what section of your app users travel to most from the main menu screen.

Building Custom Events

  1. Build out which primary folders (st1) you would like to organize your custom events by. This is based on how you would like to slice and dice your data.
  2. Within each st1 folder, add additional levels of hierarchy with st2 folders and/or st3 folders or skip straight to the unique events without using secondary or tertiary folders This depends on how you would like to organize and view your events.
  3. Add additional information you would like tracked to each custom event. Whether it will pull in data into the value and/or level parameters as well as anything you would like to be passed in the json parameter.
  4. Integrate your custom events code into your app code with help from the Upsight Integration docs.
  5. Start building custom dashboard charts using either a count or a value of any and all the custom events once the app is live and events have been fired.

Optional Once all custom events have been organized using the template, open the Event Designer tool under the Help section of the Analytics dashboard. By adding your Custom Events into the Event Designer, you are able to generate the code needed to implement your custom events into your app code without having to write the code from scratch. Be sure to also check the box “Include as a funnel step” if you plan to use the event in the funnels tab of the dashboard. Checking this box will automatically add funnel steps to your dashboard. This step is to be completed prior to Integrating your custom events code into your app (step 4).