TealiumConfig

Class: TealiumConfig

The TealiumConfig class provides methods to set configuration options for the main Tealium class. The following document summarizes the commonly used methods and properties of the TealiumConfig class for Kotlin. Individual modules may also provide their own extensions for the TealiumConfig class if they are enabled - these are documented in the relevant module’s own document.

adobeVisitorAuthState

Sets the current authentication state for the visitor.

Example:

config.adobeVisitorAuthState = AdobeAuthState.AUTH_STATE_AUTHENTICATED
config.adobeVisitorAuthState = AdobeAuthState.AUTH_STATE_LOGGED_OUT
config.adobeVisitorAuthState = AdobeAuthState.AUTH_STATE_UNKNOWN

adobeVisitorCustomVisitorId

Sets the known visitor ID to the Adobe ECID, if it’s known at initialization time. If the ECID changes in the future, call linkECIDToKnownIdentifier to update the visitor ID.

config.adobeVisitorCustomVisitorId = "20381482060927465156359999806251989655"

adobeVisitorDataProviderId

Sets the data provider ID, provided by Adobe, which is required when linking an ECID to a known ID.

config.adobeVisitorDataProviderId = "01"

adobeVisitorExistingEcid

Sets the existing ECID from a previous installation to be used, such as the Adobe SDK, instead of requesting a new ECID.

Example:

config.adobeVisitorExistingEcid = "20381482060927465156359999806251989655"

adobeVisitorOrgId

String containing the Adobe Org ID including the @ portion. If the Org ID is not provided, the module is not initialized and no visitor ID is retrieved. Tracking calls continue as normal without an Adobe ECID.

config.adobeVisitorOrgId = STRING_VALUE

Example:

config.adobeVisitorOrgId = "1A2A111A111150AA0A110A12@AdobeOrg"

adobeVisitorRetries

The number of allowed invalid visitor ID retries before a request fails, which results in tracking calls being sent anyway without an ECID.

Example:

config.adobeVisitorRetries = 5

Collectors

Collectors are modules that gather supplemental information from the device and append it to the data layer before it’s transmitted to the Tealium Customer Data Hub. Some collectors are included in the core library, while others are optional and installed as separate modules.

The following table lists the available collectors. Default collectors are denoted by a * next to the collector name.

These modules are enabled or disabled using the TealiumConfig collectors property.

The following example adds to existing list of collectors you’re using:

val config = TealiumConfig(collectors = mutableSetOf(Collectors.AdobeVisitor))

consentExpiry

Sets the expiration time of the user consent selections. Set this property prior to Tealium initialization. The default expiration times for consent selections are:

• CCPA: 395 days
• GDPR: 365 days

The following sets the consent expiry to 90 days.

config.consentExpiry = ConsentExpiry(90, TimeUnit.DAYS)

consentManagerEnabled

Sets whether the ConsentManager module is enabled or not. It is also required to set a Policy via consentManagerPolicy.

config.consentManagerEnabled = true  // enable

consentManagerPolicy

Sets the ConsentPolicy that is adhered to within the app. This policy controls whether or not Dispatches are queued and dropped throughout the SDK in accordance with the relevant legal requirements.

config.consentManagerPolicy = ConsentPolicy.GDPR

consentManagerLoggingEnabled

Sets whether changes in consent preferences need to be sent to a remote server to be recorded.

config.consentManagerLoggingEnabled = true

consentManagerLoggingUrl

Sets the URL used when logging consent preference changes.

config.consentManagerLoggingUrl = url

deepLinkTrackingEnabled

Enables or disables automatic tracking of standard deep links, such as links to the app from Facebook or other sources, as well as QR trace. Enabled by default.

config.deepLinkTrackingEnabled = true

hostedDataLayerMaxCacheTimeMinutes

Sets an expiration on the hosted data layer data. If this property isn’t set, hosted data layer items persist for 7 days by default, and are re-downloaded from the CDN once this period has expired.

hostedDataLayerMaxCacheTimeMinutes = 30

If your hosted data layer is frequently updated, setting a lower value may impact battery life due to increased network requests.

hostedDataLayerEventMappings

Sets the hosted data layer keys (lookup variables) used by the hosted data layer module when retrieving data layer IDs. The key is the value in the tealium_event key of a dispatch.

hostedDataLayerEventMappings = mapOf("pdp" to "product_id")

logLevel

Sets the log level property, which controls how much information is logged, to one of the following values:

Logger.logLevel = LogLevel.DEV

View your development logs in the Android Studio using LogCat. View your production logs with LogCat app by connecting your Android device.

TealiumConfig

Constructor method that creates a TealiumConfig instance.

val config = TealiumConfig(
      application,
      account,
      profile,
      environment);

The TealiumConfig instance is configured with the following parameters:

The following is an example:

// Assuming execution is within Application.onCreate()
val config = TealiumConfig(this, "ACCOUNT_NAME", "PROFILE_NAME", Environment.PROD)

// Add required Dispatchers
config.dispatchers.addAll(setOf(CollectDispatcher, TagManagementDispatcher))

// Add required Modules
config.modules.add(VisitorService)

timedEventTriggers

A list of EventTrigger objects for automatically tracking timed events.

val config = TealiumConfig(…).apply {
  timedEventTriggers = mutableListOf(
     EventTrigger.forEventName(
       start_event,
       stop_event,
       timed_event_name)
  )  
}

The following are EventTrigger parameters: