Lifecycle Tracking Module

Install

The Lifecycle Tracking module must be added to your app. Install the module with CocoaPods or manually similar to the Tealium for iOS library.

In any abstraction class (like TealiumHelper.h) replace any @import TealiumIOS with @import TealiumIOSLifecycle.

CocoaPods

To install the Lifecycle Tracking module with CocoaPods, add the following to your Podfile:

pod 'TealiumIOSLifecycle'

Manual

To install the Lifecycle Tracking module manually, following these steps:

1. Download the Lifecycle Tracking module.

2. Add the TealiumIOSLifecycle.framework file to your project (in the Embedded Binaries section).

Track

The module tracks the following lifecycle events:

These values are indicated in the lifecycle_type variable.

Automatic Tracking

Configure the Lifecycle Tracking module to automatically listen for the standard UIApplication notifications to automatically trigger launch, wake and sleep events.

Unlink or remove the TealiumIOSLifecycle.framework from your project to remove lifecycle tracking.

Launch Event
Generated on detection of UIApplicationDidFinishLaunchingNotification.

Sleep Event
Generated on detection of UIApplicationWillResignActiveNotification.

Wake Event
Generated on detection of UIApplicationWillEnterForegroundNotification.

Manual Tracking

Available for specific lifecycle paradigms and non-conventional lifecycle tracking. In order to manually track lifecycle events, disable lifecycle auto-tracking by setting setLifecycleAutotrackingIsEnabled to NO.

Launch Event
To manually track a launch event, call:

[[Tealium instanceForKey:@"(uniqueInstanceId)"] launch];

Sleep Event
To manually track a sleep event, call:

[[Tealium instanceForKey:@"(uniqueInstanceId)"] sleep];

Wake Event
To manually track a wake event, call:

[[Tealium instanceForKey:@"(uniqueInstanceId)"] wake];

Data Layer

The Lifecycle Tracking module adds the following data layer variables: