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 stcvariable of your hits.

Example

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

JavaScript

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

{

"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 :

Java

1

2

3

Map<String,Objectmetrics=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):

Java

1

2

3

4

Map<String,Objectmetrics=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.