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).
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:
|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.|
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:
|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.|
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
You can use the Version and Date filters on the top gray bar to narrow down the event summary metrics.
The Event Statistics page displays three charts for the selected event:
|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.|
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 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:
- 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.