Application lifecycle 6f1d08

Data collection / Android / Users / Application lifecycle

Foreword

Lifecycle variables allow you to know how users are using your application. With lifecycle variables, you can calculate, for example, user retention and the use rate of your application.

Lifecycle variables are automatically calculated and added in stc variable of your hits.

Example

Here’s an example of JSON added in the stc variable of your hits:

{
    "lifecycle": {
        "sessionId": "e1e04f45-8d54-4e24-81cf-75314a5bcead",
        "fs": 0,
        "fsau": 0,
        "sc": 5,
        "scsu": 2,
        "fsd": 20160120,
        "dsfs": 0,
        "fsdau": 20160120,
        "dsu": 0,
        "dsls": 0
    }
}

Get metrics (>= 2.10.1)

Since 2.10.1 version, it’s now possible to get metrics computed by SDK to do an other processing. To do this, just call tracker method :

Map<String,Object metrics = tracker.getLifecycleMetrics();

Metrics are rendered in the same way as in the stc, so get it from the same key (sample with “sc” : session count):

Map<String,Object metrics = tracker.getLifecycleMetrics();
metrics.get("sc"); // get the session count

Variables

Name	Description
sessionId	The session begins when an application is launched or brought into the foreground, and ends when the application is sent to the background during more than 60 seconds (by default), or when the application is closed.
fs	Allows you to know if the application was launched for the first time
fsau	Allows you to know if the application has been launched for the first time since an update
sc	Number of sessions made from the application’s installation
scsu	Number of sessions made since the last application update
fsd	Date of the application’s very first session
dsfs	Number of days since the very first session
fsdau	Date of first session since the last update
dsu	Number of days since the last update
dsls	This variable indicates the number of days that have passed since the last session. The calculation is made using the phone’s settings. As such, if the user has changed the phone’s date, the variable may be a negative number.

Last update: 26/10/2018