Mobile SDKs for Data hub

Bloomreach’s Exponea Android SDK and iOS SDK support Data hub Event stream integration, enabling you to route mobile app tracking through Event streams rather than directly to Engagement projects. This provides centralized control over mobile tracking through Event stream security and permissions features.

Mobile SDK integration with Data hub

Data hub mobile SDK integration uses the standard Exponea Android and iOS SDKs with a configuration change to route tracking through Event streams.

📘

Note

There are no separate mobile SDKs for Data hub; instead, you use the same Exponea SDKs you're already familiar with, configured to connect to an Event stream rather than to an Engagement project directly.

The key difference is the configuration object you use during SDK initialization:

• Legacy mode: Use ProjectConfig (Android) or ProjectSettings (iOS) with a project token to connect directly to an Engagement project

• Data hub mode: Use StreamConfig (Android) or StreamSettings (iOS) with a stream ID to connect through an Event stream

When configured for Data hub, the SDK sends events to your Event stream, which validates them against configured permissions and forwards them to your connected Engagement project. This architecture provides the same Event stream security controls for mobile tracking as for web and server-side tracking.

📘

Note

For an overview of Data hub mobile SDK configuration with JWT authentication, see Android and iOS configuration with JWT.

How Data hub mobile integration works

When you initialize the Exponea SDK with StreamConfig or StreamSettings, your mobile app connects to Data hub instead of directly to Engagement:

1. Your mobile app captures user interactions (screen views, button taps, purchases)

2. The SDK packages these interactions as events with customer identifiers and event properties

3. Events are sent to Event stream specified by your stream ID

4. The Event stream validates events against configured permissions (including JWT validation if enabled)

5. Valid events are forwarded to your connected Engagement project

This means your mobile tracking respects the same permission rules you've configured for the Event stream, including signed-only customer IDs, event types, and properties. The SDK automatically handles JWT authentication when you provide tokens, ensuring secure tracking from mobile apps.

SDK capabilities

The Exponea SDK configured for Data hub supports all standard mobile engagement capabilities:

Tracking: Capture customer behavior and interactions, including screen views, sessions, and custom events. See Android SDK tracking and iOS SDK tracking.

Push notifications: Handle push notification delivery and interaction tracking for both iOS and Android. See Android SDK push notifications and iOS SDK push notifications.

In-app personalization: Deliver personalized in-app messages and content based on customer data in Engagement. See Android SDK in-app personalization and iOS SDK in-app personalization.

App Inbox: When using StreamConfig, App Inbox requires a valid SDK auth token for authentication.

Supported platforms

Data hub integration is available for:

• Android: Native Android SDK with Kotlin/Java

• iOS: Native iOS SDK with Swift/Objective-C

Cross-platform frameworks like Flutter and React Native are not currently supported for Data hub Event stream integration. If you're building mobile applications with these frameworks, you'll need to implement tracking using the Data hub Tracking API directly.

Limitations

Discovery tracking not supported: The mobile SDKs configured for Data hub only send events to Bloomreach Engagement through Event streams. You cannot use this configuration to track Discovery events. For Discovery tracking from mobile apps, implement it separately using Discovery's native mobile tracking solutions.

Event stream dependency: Mobile events flow through Event streams, which means they're subject to Event stream permissions and validation. Configure your Event stream permissions appropriately to ensure mobile tracking works as expected.

Next steps

To implement Data hub integration in your mobile application with JWT authentication, choose your platform: 

• Configure Android SDK JWT authentication - Configure the Exponea Android SDK with StreamConfig

• Configure iOS SDK JWT authentication - Configure the Exponea iOS SDK with StreamSettings