Extension Events

Extension Events enable you to track events from within extensions related to your app.

For example, if you wish to track Events and compare usage between your app and its Apple Watch extension on iPhone apps, you can take advantage of this new feature in Flurry analytics, which currently provides support for Apple Watch extensions. (Other extension types are soon to come.)

To start, you’ll need to enable Apple Watch extensions, described in the section Apple Watch Extensions.

Once you enable an Apple Watch Extension, you’ll see a new navigation item called Extension Events in the left navigation for the parent app (shown below).

event extensions

From the Extension Events navigation pane:

  • Event Summary - A table presenting summary metrics for each Extension Event
  • Event Log - A log displaying each individual grouping of Events and their related parameters.

Additional pages provide detail for each specific Event that can be accessed via the Event Summary page:

Event Details Description
Statistics Displays a collection of charts providing insight into the triggering of the selected Event.
Parameters Allows for the review of summary information for each individual parameter recorded along with the event.
Log Similar to the Event Log page at the top level, this page shows the logs of each individual event occurrence for the selected Event.

Event Summary

The Event Summary page under Extension Events shows information regarding all the events from your app’s related extensions.

Metrics for each event are displayed as follows:

Event Metrics Description
Total Event Occurrences The total sum of event occurrences across the date range selected.
Event Occurrences (Daily Avg) The sum of the Total Events by Day metric found on the Event Details details page (found when you click on an event) for the date range selected divided by the number of days in that period.
Unique Event Users (Daily Avg) The sum of the Unique Users Performing Event by Day metric found on the Event details page (found when you click on an event) for the date range selected divided by the number of days in that period.
Events Users as % of Active App Users The Unique Event Users (Daily Avg) defined above divided by the average Active Users by Day metric (found on the Usage - Active Users) for the date range selected. This metric helps you understand how engagement balances out between the extension and the app.

Icons linking to Event Detail pages

Under the Analyses column, you’ll see icons that link to event pages that provide further details for each event. These include

icon event stats
  • Links to the Event Statistics page that shows detailed metrics: events per session distribution, unique users performing events, total events and average events per session.
icon event parameters
  • Links to the Event Parameters page that shows distribution of parameters for the event. The icon will not appear for events that have no parameters.
icon event logs
  • Links to the Event Logs page that shows sessions (see Note below) that include the event.

Note: For Apple Watch events, the end of a session is determined mechanically as determined by the Flurry Watch Duration Threshold and Flurry Watch Event Threshold settings (details) and therefore “sessions” are not really meaningful. The groupings of events into “sessions” is purely for presentation purposes.

CSV download

Additional metrics beyond the daily average shown in the table on the page are available in the csv download file. The metrics in the csv download file are (in order of appearance):

  • Event Occurrences (Daily Avg)
  • Unique Event Users (Daily Avg)
  • Event Users as % of App Users
  • Unique Event Users Last Day
  • Unique Event Users Last Week
  • Unique Event Users Last Month
  • Unique Event Users (Weekly Avg)
  • Unique Event Users (Monthly Avg)
  • Total Event Occurrences

Filtering data

You can use the Version and Date filters on the top gray bar to narrow down the event summary metrics.

Event Statistics

The Event Statistics page displays three charts for the selected event:

Event Description
Unique Extension Event Users Performing the Event Shows the number of unique devices triggering the event for the selected interval over time.
Total Events Shows the total number of events triggered for the selected interval over time.
Event Users as % of App Users Displays the number of Unique Extension Event Users as a percentage of the number of users active in the parent app for the selected interval over time.

Event Parameters

If you have added parameters to your Extension Event, you can view this data by selecting the Parameters link (and associated pie chart icon) at the top of the Event page.

Use the dropdown bar at the top to select the specific parameter for the Event that you are interested in. The pie chart will display the distribution of parameter values, highlighting the Top 10 values triggered and placing the remaining values into Other.

For more detail beyond the top 10, the table below the chart shows the Top 500 parameter values triggered, placing the remaining values into “Other”. In the below example, the Event “Article Read” has a parameter named “Article Category”.

The distribution chart shows that the most common type of article read is News articles, followed by Entertainment articles, and so on.

Event Log

Event Logs provide a detailed view of all of your users’ sessions that contain Events. (See the Note below for details related to Apple Watch events.)

This is the first place that session data hits the Flurry portal; all other charts subsequently update with this information. Data will populate in this section within minutes of the actual session.

For developers who are testing their Flurry Extension Event integration, this is the place you should look to see if your Event testing is working as expected.

The Event Log provides a log of the Events (and associated parameters ) that were triggered in a specific session (see Note below). For each session (see Note below related to Apple Watch events) it displays:

  • Timestamp
  • Device type. If the extension is an Apple Watch Extension, the size of the watch will be indicated in addition to the iPhone model.
  • Events and parameters triggered. Note that parameters can be viewed by clicking the ‘+’ next to the Event name.

Note: For Apple Watch events, the end of a session is determined mechanically as determined by the Flurry Watch Duration Threshold and Flurry Watch Event Threshold settings (details) and therefore “sessions” are not really meaningful. The groupings of events into “sessions” is purely for presentation purposes.