The Connect SDK for Android is configured through two files in your app's assets/ directory:
- ConnectBasicConfig.properties — primary SDK settings.
- EOCoreAdvancedConfig.json — advanced data transport and session settings.
Both files are optional — the SDK ships with built-in defaults for all settings. Override only what you need to change.
Languages: Kotlin and Java
Availability: Pro, Premium, and Ultimate
| Property | Default | Description |
|---|
AppKey | — | Your Connect application key. If set here, you can pass null to Connect.enable(). |
PostMessageUrl | — | Your Connect collector URL. If set here, you can pass null to Connect.enable(). |
The kill switch lets you remotely disable the SDK on users' devices without releasing a new app version.
| Property | Default | Description |
|---|
KillSwitchEnabled | false | Set to true to enable the kill switch. Required for production — see Prepare for production. |
KillSwitchUrl | — | Your kill switch URL. Format: https://{collector_host}/collector/switch/{app_key}. |
KillSwitchMaxNumberOfTries | 3 | Number of attempts to reach the kill switch URL before giving up. |
KillSwitchTimeInterval | 5 | Time in seconds to wait between kill switch attempts. |
| Property | Default | Description |
|---|
ScreenshotFormat | JPG | Screenshot format. Valid values: JPG, PNG. PNG ignores PercentToCompressImage. |
PercentOfScreenshotsSize | 40 | Percentage of the original screen dimensions at which screenshots are submitted. Range: 1–100. Lower values reduce data size but may affect replay clarity. |
PercentToCompressImage | 100 | JPG compression percentage. Range: 1–100. Only applies to JPG format. |
ScreenShotPixelDensity | 1.5 | Pixel density used when taking screenshots. Valid values: 1, 1.5, 2, 3. |
| Property | Default | Description |
|---|
LogViewLayoutOnScreenTransition | true | Whether to capture the screen layout on each screen transition. |
GetImageDataOnScreenLayout | false | Whether to include image data from ImageView elements in layout captures. |
| Property | Default | Description |
|---|
SetGestureDetector | true | Whether to enable gesture capture. Requires Connect.dispatchTouchEvent() to be called from your base activity. |
CaptureNativeGesturesOnWebview | false | Whether to capture native gestures on WebView elements. |
| Property | Default | Description |
|---|
SessionTimeout | 30 | Session timeout in minutes. Set to 0 to rely on cookie expiry instead. |
SessionTimeoutKillSwitch | false | Whether to request a new session ID from the kill switch URL on session timeout. |
Used for session identification. Modify only if your app requires custom sessionization.
| Property | Default | Description |
|---|
CookieUrl | — | URL used to set the session cookie. |
CookieParam | TLTSID | Cookie parameter name for the session ID. |
CookiePath | / | Cookie path. |
CookieDomain | — | Cookie domain. |
CookieExpires | false | Whether to add an expiry to the cookie. Expiry = current time + SessionTimeout. |
CookieSecure | false | Whether to create a secure cookie (HTTPS only). |
CookieExpiresFormat | ASCTIME | Date format for cookie expiry. Valid values: ASCTIME, RFC1036, RFC1123. |
| Property | Default | Description |
|---|
LogLocationEnabled | true | Whether to enable automatic geolocation logging on app start. |
LogLocationTries | 3 | Number of attempts to obtain a location fix before giving up. |
LogLocationTimeout | 30 | Time in seconds to wait for a location fix on each attempt. |
| Property | Default | Description |
|---|
LoggingLevel | 3 | Log level for SDK output. 0 = none, 1 = error, 2 = warning, 3 = verbose. |
DisplayLogging | false | Whether to print SDK log output to Logcat. Set to true for debugging. Disable before shipping to production. |
Advanced data transport and session settings. Override by placing a EOCoreAdvancedConfig.json file in your app's assets/ directory.
| Property | Default | Description |
|---|
CachedFileMaxBytesSize | 400000 | Maximum size in bytes of each cached data file (~400 KB). |
MaxNumberOfFilesToCache | 5 | Maximum number of data files to cache when the collector is unreachable. Total potential cache: ~2 MB. |
PostMessageMaxBytesSize | 2048000 | Maximum size in bytes of each outgoing message (~2 MB). |
PostMessageTimeout | 3000 | Timeout in milliseconds for establishing a connection to the collector. |
PostMessageSocketTimeout | 3000 | Timeout in milliseconds for waiting for a response from the collector. |
CompressPostMessage | true | Whether to gzip-compress outgoing messages. |
BufferPercent | 20 | Percentage of CachedFileMaxBytesSize to use as an in-memory buffer before writing to disk. |
| Property | Default | Description |
|---|
ApplicationBackgroundTimeInterval | 60 | Time in seconds the app can spend in the background before the session is considered ended. |
OrientationSensorDelay | 100000 | Delay in microseconds between orientation sensor readings. |
OrientationDelayNotificationToModules | 1000 | Delay in milliseconds before notifying modules of an orientation change. |
TurnOffCorrectOrientationUpdates | false | Whether to disable orientation correction updates. |
DefaultOrientation | 0 | Default orientation when none can be detected. 0 = portrait. |
ApplicationInBackgroundEnabled | true | Whether to continue capturing data when the app is in the background. |
