Skip to content

Data Collection

The Metrics functionality of ChilliConnect allows you easily collect and track core KPIs, specific player activity, and any custom events that happen within your game.


Metrics are automatically collected for your game when logging a player in to ChilliConnect using any of the supported login methods: LogInUsingChilliConnect, LogInUsingEmail, LogInUsingFacebook, LogInUsingGameCenter, LogInUsingMobileDeviceId, LogInUsingUserName.

ChilliConnect will start a metrics session and capture the players Location, Platform, Device Type and any A/B Test and Test Group the player is currently part of. These parameters can also be manually overridden if required. You can also supply the version of the game using the AppVersion parameter.

To ensure that accurate session lengths are recorded, we recommend calling the RefreshSession method whenever a game session is resumed from a suspended or paused state, and the EndSession method when the player explicitly exits the game. EndSession will simply record an end time against the players session. RefreshSession will check for the last activity time on the current session, and if greater than a specified threshold (60 minutes by default), will consider the current session expired and create a new session. This allows you to easily handle situations in mobile games where the game is backgrounded for just a short time (perhaps the player checking a text message) before almost immediately resuming play. The threshold can be altered from the Game Settings page.

Note that because players may unexpectedly exit your game, run out of battery or even lose internet access, the Session End time is also updated every time a custom metric event is received from your game. This is a best-effort practice to ensure that majority of Sessions have a length associated with them.

By default ChilliConnect will also automatically record IAP events when an IAP is validated via the following endpoints: RedeemAmazonIap, RedeemAppleIap, RedeemGoogleIap, ValidateAmazonIap, ValidateAppleIap, ValidateGoogleIap These endpoints will also need to have LocalCost and LocalCurrency sent up as per the documentation or calls will return an error. LocalCurrency must be in ISO-4217 format.


By simply logging in players to your game, ChilliConnect will collect a number of industry standard KPIs.


ChilliConnect tracks several real-time metrics that provide live insight into your game. This is especially useful when a promotion from our Live Ops module goes live, or when a new build of your game is distributed.


The following Live KPIs are available:

Active Players The number of active Players in the last 30 minutes. An active Player is one that has started a session, or triggered an event within that time period.
Total Installs The number of Player accounts. This will differ from the regular KPI metric which is calculated daily.
Installs Last 24 Hours The number of new Player accounts in the last 24 hours.
Total Revenue The total IAP revenue for the game as reported through IAP redeem (if configured) or Metrics IAP events. This will differ from the regular KPI metric which is calculated daily.
Revenue Last 24 Hours The IAP revenue for the game within the last 24 hours.

Realtime metrics are automatically updated while viewing the page, the refresh interval can be configured by the control in the upper right corner.


The Players tab displays information relating to the amount of players and installs you have.


The following charts are available:

DAU Daily Active Users. The number of users who have played your game at least once that day
WAU Weekly Active Users. The number of users who have played your game at least once within the last 7 days
MAU Monthly Active Users. The number of users who have played your game at least once within the last 30 days
Stickiness The number of users who have played your game at least once within the last 30 days
Daily Installs The number of new installs of your game for that day
Total Installs The total number of installs of your game


The Sessions tab displays information on the number and length of player sessions within your game.


The following charts are available:

Median Session Length The median session length time that players play within a single session. Median is provided rather than average as exceptionally long or short sessions can lead to inaccurate lengths.
Average Sessions The average number of sessions each user plays for each day
Sessions The total number of player sessions each day


The Retention tab displays what % of your players are returning to your game within a range of time periods. In ChilliConnect, a player is considered retained for a time period if they start a session at any point during that period. For example, a player that starts a session on the 1st of January, and then returns on the 15th of January will be considered to have been retained for each day up to the 15th. Therefore, in the retention displayed by ChilliConnect, they will be included as a retained player in the 1, 2, 3, 7 and 14 day retention charts.



Revenue metrics can be collected from your game using the AddIapEvent method every time a player purchases an item. IAPs are converted to USD from the provided Local Currency using the exchange range available at the time of aggregation. In addition to this, Revenue figures do not include charges deducted by platform providers so will not match the actual end revenue for your game.


The following charts are available:

ARPDAU Average Revenue per Daily Active User. The average amount spent by each player per day
ARPPDAU Average Revenue per Paying Daily Active User. The average amount spent by each paying user per day
Conversion Rate Percentage of players that purchase at least on item
Daily Revenue Total revenue in USD per day
Average Transaction Average transaction in USD


By default, ChilliConnect will display KPIs for all players. Further breakdowns can be viewed by using the Segments drop down from the top left:

Up to six segments can be displayed at once.

Custom Events

Custom Events allow you to track any player behaviour that is specific to your game. For example, this could include when the player levels up, fails a mission or uses a particular item, it's completely up to you. You can send custom events from your game using the AddEvent method. Before sending the event, you must define the event on the Dashboard from the Events tab:

For each Event, the following properties can be specified:

Name A descriptive name for the Event
Key The Key used to identify the Event in API calls from your game
Params Up to 6 optional parameters for additional data you may wish to capture with each event

For example, if your game has a crafting element and you wanted to track what items players crafted most you could define an event called "Item Crafted", with a parameter for "Item Name".

Custom Charts

Custom charts can be used to visualise data captured from your custom and in-app purchase events. Custom charts are added from the Dashboard tab:

For each Custom Chart, the following properties can be specified:

Chart Type The type of chart you want to use
Event The Event you want to report on
Primary Grouping The primary grouping for the chart, this can be built in session segments or event parameters.

Note: Line charts always have a primary grouping of date, number charts do not have any groupings
Sub Groups Any sub groups for the chart, this can be built in session segments or event parameters. There is a limit of 2 sub groups per custom chart

Note: Pie charts do not have sub groups, and number charts do not have any groupings
Filters The filters that you want to apply to the event parameters, these will be autocompleted as you type
Segment Filters The segments that you want to filter by
Measure The measure you want to see. This can be a count of players/events/sessions or the sum/average/min/max of an event parameter
Days to Include Number of days to include in the collected chart data, this can be a maximum of 90 days
Date Range A date range in the last 90 days to generate a custom chart for
Chart Name The name of the chart as you want it to appear in the Dashboard

Note: Chart name is only available to set after generating a custom chart

Custom charts can be previewed before saving,

After previewing a custom chart, any of the settings can be modified before saving the chart, this allows you to preview a sample of data and then increase the date range.

After saving the custom chart, the dialog can be closed and the custom chart will be generated and displayed on your Dashboard. The status of the chart will be shown until the data is generated.

Once a custom chart is saved it will then updated automatically every day.


The Dashboard tab allows you to combine chart types from different metrics categories within a single view. Your chart selection will also be maintained and displayed the next time you log in, allowing you to quickly view the information that is most relevant to where your game is in it's launch cycle.


Data Export

ChilliConnect also provides you the option to download it your raw metrics data for each day in either a CSV or SQL format, allowing you to perform detailed offline analysis or even import your data in to a separate reporting tool. Daily exports are available from the Data Exports tab.



Automatic recording of IAPs and the refresh session threshold can both be modified from the Game Settings page: