Skip to main content

FAQ

Does the SDK Start Tracking Immediately?​

No. After initialization, call enable(config) to start tracking.

Can I Change the Application Code Later?​

Yes. Call disable(), then changeApplicationCode(newCode), then enable() with the new configuration.

No. Calling linkAuthenticated replaces the prior identification.

How Do I Know If Push Is Active?​

Call getToken(). If a token is present and the SDK is enabled, push notifications can be delivered. Delivery also depends on user permissions and the push provider (FCM, HMS, APNs, or browser).

Are Events Lost During App Crashes?​

Events are persisted locally before being sent. On the next launch, they are retried automatically.

What Happens If I Call enable Twice?​

A second call returns an error because the SDK is already enabled. You can safely ignore this error.

Does Disabling Tracking Remove Stored Data?​

No. It stops sending network requests and tracking new events. Contact data, language, and queued events remain until tracking is re-enabled or explicitly cleared.

Is In-App on Web Supported?​

Not yet. In-app on Web will be available with web channel integration.

How Large Can Custom Event Attributes Be?​

For optimal processing, keep individual attribute values below 256 characters and the total attribute count below 32.

How Do I Migrate from the SAP Emarsys SDKs Login/Logout?​

login(value) maps to contact.link(value). logout() maps to contact.unlink().

note

Contact linking and unlinking is not equivalent to login and authentication. It only links the device and session data with a contact in SAP Engagement Cloud.

How Do I Rotate an OpenID Token?​

Acquire a fresh token and call linkAuthenticated(newToken).

Are Network Calls Encrypted?​

Yes. All SDK network communication uses HTTPS/TLS.

Can I Batch Custom Events Manually?​

The SDK batches network requests automatically. To reduce the number of events, group related attributes into a single event.

Call disable(), then unlink(), and clear any locally stored user data in your application.

See Deep Link Is Not Being Tracked in the Troubleshooting guide.

Where Do I Find the SDK Version?​

Call EngagementCloud.config.getSdkVersion().