The Connect SDK for Android is configured through four files in your app's assets/ directory:

ConnectBasicConfig.properties — credentials, kill switch, session timeout, and device identification.
ConnectAdvancedConfig.json — privacy, capture behavior, and WebView settings.
EOCoreBasicConfig.properties — Logcat output.
EOCoreAdvancedConfig.json — background session behavior.

All files are optional — the SDK ships with built-in defaults for every setting. To override a default, create the file in your app's assets/ directory and add only the keys you want to change. Anything you do not include keeps its bundled default.

Languages: Kotlin and Java

Availability: Pro, Premium, and Ultimate

ConnectBasicConfig.properties

App key and collector URL

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()`.

Kill switch

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. Must be at least `1`.
`KillSwitchTimeInterval`	`5`	Time in seconds to wait between kill switch attempts.

Capture defaults

Property	Default	Description
`MaxStringsLength`	`300`	Maximum length in characters for captured string values. Values longer than this are truncated.

Session settings

Property	Default	Description
`SessionTimeout`	`30`	Session timeout in minutes. Set to `0` to rely on cookie expiry instead.

Device identification

Property	Default	Description
`disableTLTDID`	`false`	Whether to suppress the SDK's device-ID header (`X-Connect-TLTDID`) and the `TLTDID` value appended to outgoing cookies. Set to `true` if compliance or privacy requirements prohibit persistent device identifiers. Leaving it `false` (the default) is correct for most apps — the device ID lets Connect tie multiple sessions from the same device into a single device profile.

EOCoreBasicConfig.properties

EOCore-layer settings that control Logcat output. Override by placing an EOCoreBasicConfig.properties file in your app's assets/ directory.

Property	Default	Description
`DisplayLogging`	`true`	Whether to print SDK output to Logcat. Disable before shipping to production — `ERROR`-level messages continue to surface.

EOCoreAdvancedConfig.json

Advanced session settings. Override by placing an EOCoreAdvancedConfig.json file in your app's assets/ directory.

Property	Default	Description
`ApplicationBackgroundTimeInterval`	`60`	Time in seconds the app can spend in the background before the session is considered ended.
`ApplicationInBackgroundEnabled`	`true`	Whether to continue capturing data when the app is in the background.

ConnectAdvancedConfig.json

Advanced settings for capture behavior, privacy, and WebView integration. Override by placing a ConnectAdvancedConfig.json file in your app's assets/ directory. A template is available in the sample app.

Privacy

Property	Default	Description
`RemoveIp`	`false`	Set to `true` to strip the device's IP address from all data sent to the collector. Use when privacy requirements prohibit transmitting network identifiers.
`IpPlaceholder`	`"N/A"`	The string substituted in place of the IP address when `RemoveIp` is `true`.
`RemoveAllCookies`	`false`	Set to `true` to prevent the SDK from reading or writing cookies. Use when privacy requirements prohibit cookie-based tracking.

Capture behavior

Property	Default	Description
`EditTextEnabled`	`true`	Whether to capture interactions with `EditText` fields. Disable if you prefer to rely solely on masking rules rather than suppressing capture entirely.
`DefaultAutoLayoutDelay`	`0`	Delay in milliseconds before the SDK captures the screen layout after a screen transition. Increase if your app's layouts animate or load asynchronously.

WebView

Property	Default	Description
`GoogleWebViewEnabled`	`false`	Whether to enable Connect's WebView capture integration. Set to `true` if your app embeds web content in a `WebView` and you want to capture interactions within it.
`ExtendsGoogleWebViewClient`	`false`	Set to `true` if your app subclasses `WebViewClient`. Required for the WebView integration to function correctly when a custom client is in use.
`WebViewDelay`	`"1000"`	Time in milliseconds to wait after a page loads before capturing the WebView layout. Increase if web content renders asynchronously.