Application lifecycle

  • iOS
  • watchOS
  • tvOS
 

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
    }
}
 

Metrics recovery (>= 2.11.1)

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

let metrics = tracker.getLifecycleMetrics()
NSDictionary* 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):
let metrics = tracker.getLifecycleMetrics()
let sc = metrics["sc"] // get the session count
NSDictionary* metrics = [self.tracker getLifecycleMetrics];
NSObject* sc = [metrics objectForKey:@"sc"];