Modules

The Tealium Prism library uses a modular architecture. Install only the modules you need to maintain a smaller resource footprint. All modules depend on the Core module.

Available modules

Module	Package	Description
Core	`prism-core`	Required. Provides the Tealium instance, configuration, tracking, and data layer.
Lifecycle	`prism-lifecycle`	Tracks app lifecycle events such as launch, wake, and sleep.
Context API	`prism-context-api`	Provides access to real-time visitor profiles.
AppData	`prism-core`	Collects app-level data such as app name, version, and build number.
Collect	`prism-core`	Dispatches events to the Tealium Collect endpoint.
ConnectivityData	`prism-core`	Collects device connectivity information such as network type.
DeepLink	`prism-core`	Handles deep link URLs and passes deep link data to the data layer.
DeviceData	`prism-core`	Collects device information such as model, OS version, and screen resolution.
TimeData	`prism-core`	Adds timestamp data to tracking calls.
Trace	`prism-core`	Enables trace sessions for debugging and validation.

Module	Package	Description
Core	`TealiumPrismCore`	Required. Provides the Tealium instance, configuration, tracking, and data layer.
Lifecycle	`TealiumPrismLifecycle`	Tracks app lifecycle events such as launch, wake, and sleep.
Context API	`TealiumPrismContextAPI`	Provides access to real-time visitor profiles.
AppData	`TealiumPrismCore`	Collects app-level data such as app name, version, and build number.
Collect	`TealiumPrismCore`	Dispatches events to the Tealium Collect endpoint.
ConnectivityData	`TealiumPrismCore`	Collects device connectivity information such as network type.
DeepLink	`TealiumPrismCore`	Handles deep link URLs and passes deep link data to the data layer.
DeviceData	`TealiumPrismCore`	Collects device information such as model, OS version, and screen resolution.
DataLayer	`TealiumPrismCore`	Extended data layer operations and persistence.
TimeData	`TealiumPrismCore`	Adds timestamp data to tracking calls.
Trace	`TealiumPrismCore`	Enables trace sessions for debugging and validation.

React Native modules are npm packages. Install only the packages your app needs.

Module	Package	Description
Core	`@tealium/prism-react-native`	Required. Wraps the native iOS and Android Prism SDKs. Provides the Tealium instance, tracking, and data layer.
Lifecycle	`@tealium/prism-react-native-lifecycle`	Tracks app lifecycle events such as launch, wake, and sleep.

Module enablement is controlled by your Tealium settings JSON, not by individual packages.

Install modules

Add the Prism BOM and the modules you need to your build.gradle file:

implementation(platform("com.tealium.prism:prism-bom:0.7.0"))
implementation("com.tealium.prism:prism-core")
implementation("com.tealium.prism:prism-lifecycle")

Select the modules you need when adding the Swift package dependency, or specify them in your Podfile for CocoaPods.

Install the core package with npm:

npm install @tealium/prism-react-native

To add the Lifecycle module:

npm install @tealium/prism-react-native-lifecycle

Install the native iOS dependencies:

cd ios && pod install

Configure modules in the UI

SDK modules are available in your Tealium mobile profile as a marketplace, similar to tags. You can add, configure, and manage modules from the UI without changing your app code.

To add a module in the UI:

Go to your Tealium mobile profile.
Go to Modules.
Select Add Module and choose a module from the marketplace.
Configure the module settings.
Save and publish your changes.

The SDK picks up the updated module configuration on the next remote settings refresh or app startup.

Advanced: programmatic module activation

To activate modules programmatically, specify them in your TealiumConfig during SDK initialization:

React Native does not support programmatic module activation. Enable and configure modules in your Tealium mobile profile or settings JSON.

val config = TealiumConfig.Builder(
    application = application,
    accountName = "my_account",
    profileName = "my_profile",
    environment = Environment.PROD,
    modules = listOf(
        Modules.appData(),
        Modules.collect(),
        Modules.lifecycle(),
    )
).build()

#if COCOAPODS
import TealiumPrism
#else
import TealiumPrismCore
import TealiumPrismLifecycle
#endif

let config = TealiumConfig(account: "my_account",
                           profile: "my_profile",
                           environment: "prod",
                           modules: [
                            Modules.appData(),
                            Modules.collect(),
                            Modules.lifecycle(),
                           ],
                           settingsUrl: "https://tags.tiqcdn.com/dle/my_account/my_profile/settings.json")