Customer Data Platform Developer Guide
jInitialization
Before the Salesforce CDP Module for the Engagement Mobile SDK can be used to invoke web
services using the API, the SDK must be configured. Use the CdpConfigBuilder
for iOS or CdpConfig.Builder for Android helper class to build your SDK
configuration by providing required settings appId and endpoint that can be obtained from your
Mobile Connector. Optionally, configuration can be provided for the settings
trackScreens, trackLifecycle, and
sessionTimeoutInSeconds.
| Setting | Field Type | Description |
|---|---|---|
| appId | string | Required. The appId setting uniquely identifies your mobile application to Salesforce CDP and must be in a valid universally unique identifier, UUID, format. An invalid appID results in an error. |
| endpoint | string | Required. The endpoint setting tells the SDK where to send the events being created and tracked. |
| sessionTimeoutInSeconds | integer | The sessionTimeoutInSeconds setting represents the number of seconds the mobile application can remain in the background before the current session is expired. When a customer launches the mobile application, the SDK starts a new session that is maintained while the app is in the foreground. If the customer sends the mobile application to the background, the SDK starts a timer to expire the current session. If the customer brings the mobile app back to the foreground before the session expiration, the timer is cleared and the session is continued. Otherwise the session expires. This field is set to 600 by default. |
| trackLifecycle | boolean | Enable trackLifecycle to automatically track AppForegrounded, AppBackgrounded, and AppVersionChanged behavior events. This field is set to false by default. |
| trackScreens | boolean | Enable trackScreens to automatically track the mobile app ScreenEntry behavior event. This field is set to false by default. |
Set up the Salesforce CDP Module.
- Configure the Salesforce CDP Module.
- Initialize the Engagement Mobile SDK with the Salesforce CDP Module.