Capture Behavior Data

The Data Cloud Module for the Engagement Mobile SDK enables comprehensive collection of granular data about customer mobile app interactions through advanced event tracking capabilities.

Before behavior data can be sent to Data Cloud, ensure the following:

  • SDK Configuration: The Data Cloud Module must be properly configured and initialized.
    • Enable Lifecycle Events by setting trackLifecycle to true
    • Enable Screen Events by setting trackScreens to true
  • Consent Management: Consent to track user data must be granted.

Behavioral lifecycle and screen events are disabled by default in the Data Cloud Module for privacy compliance.

Each behavior generates an engagement event with eventType="appEvents" and relevant behavior-specific fields populated.

Lifecycle events are automatically triggered when your mobile app transitions between foreground and background states, or when the application is updated.

When the mobile application comes to the foreground, an event is generated:

On the first app launch, behaviorType is set to "AppFirstLaunch".

When the mobile application moves to the background, an event is generated,

When the mobile application is updated, an event is generated.

Screen events track customer navigation patterns as they move through different screens and views within your mobile application.

Screen view events are generated when customers navigate through different screens in your app:

  • Android: When navigating through Activity views
  • iOS: When UIViewControllers are added to the view hierarchy

After you've configured the Data Cloud Module and enabled the desired behavioral events, the SDK automatically sends these events to Data Cloud as they occur in your app. No manual intervention is required.