ANDROID KOTLIN

Consent Management

Usage

The Consent Management module is recommended and automatically enabled upon initialization. It is supported on Android mobile and Android TV.

Initialize the consent manager policy inside TealiumConfig. Then manage user consent using the Tealium instance at tealium.consentManager.

Learn more about Consent Management and consent policies.

Set Policy

Set the consent policy during initialization to one of the following:

  • ConsentPolicy.GDPR
  • ConsentPolicy.CCPA

Only one policy may be enforced on a device at any given time.

val config = TealiumConfig(...).apply {
  consentManagerPolicy = ConsentPolicy.GDPR
}

Set the expiration time for the consent selections using the consentExpiry property.

The following example sets the consent manager policy to GDPR and the expiration time to 90 days:

val config = TealiumConfig(...).apply {
  consentManagerPolicy = ConsentPolicy.GDPR
  consentExpiry = ConsentExpiry(90, TimeUnit.DAYS)
}

To trigger a callback once the consent has expired, use the onUserConsentPreferencesUpdated() method to check when the ConsentStatus is UNKNOWN:

Tealium.create(BuildConfig.TEALIUM_INSTANCE, config) {
    events.subscribe(object : UserConsentPreferencesUpdatedListener {
        override fun onUserConsentPreferencesUpdated(userConsentPreferences: UserConsentPreferences,
                                                     policy: ConsentManagementPolicy) {
            if (userConsentPreferences.consentStatus == ConsentStatus.UNKNOWN) {
                Logger.dev(BuildConfig.TAG, "Re-prompt for consent")
            }
        }
    })
}

To set full consent:

tealium.consentManager.userConsentStatus = ConsentStatus.CONSENTED

Setting full consent implicitly sets the consent categories to the full list of available ConsentCategory types.

To set partial consent, specify a subset of consent categories. This implicitly sets userConsentStatus to CONSENTED.

tealium.consentManager.userConsentCategories = setOf(ConsentCategory.ANALYTICS, ConsentCategory.EMAIL)

To decline consent set the consent status:

tealium.consentManager.userConsentStatus = ConsentStatus.NOT_CONSENTED

Alternatively, set the consent categories to null.

If your organization’s consent requirements are not covered by our standard GDPR and CCPA policies, create a custom consent policy.

  1. Implement the ConsentManagementPolicy interface.

    val customPolicy = object: ConsentManagementPolicy {
  //implement methods...
}

  2. Pass the ConsentManagementPolicy implementation to the ConsentPolicy.CUSTOM enum using the setCustomPolicy() method.

    ConsentPolicy.CUSTOM.setCustomPolicy(customPolicy)

  3. Pass the ConsentPolicy.CUSTOM option on your TealiumConfig object via the consentManagerPolicy property.

    config.consentManagerPolicy = ConsentPolicy.CUSTOM

Your custom ConsentManagementPolicy implementation may delegate existing consent management methods and properties to the provided superPolicy, which overrides the policy key with its own name on each event.

class CustomPolicy(
        val superPolicy: ConsentManagementPolicy
        ) : ConsentManagementPolicy by superPolicy {
    override val name: String = "custom_policy"

    override fun policyStatusInfo(): Map<String, Any> {
        return superPolicy.policyStatusInfo().toMutableMap().apply {
            put(ConsentManagerConstants.CONSENT_POLICY, name)
        }
    }
}

val customPolicy = CustomPolicy(ConsentPolicy.GDPR.create(
    UserConsentPreferences(ConsentStatus.UNKNOWN, null)))

After the custom consent policy is implemented, override the following properties and methods available on the ConsentManagementPolicy as needed:

Property / Method Type Description
name String Name of the ConsentManagementPolicy
userConsentPreferences UserConsentPreferences The current UserConsentPreferences that are automatically updated by the ConsentManager when the preferences change
consentLoggingEnabled Boolean Sets whether or not logging of consent changes are required
consentLoggingEventName String Sets the event name (key: tealium_event) to use when logging a change in consent
defaultConsentExpiry] ConsentExpiry Sets the default expiry time for the ConsentManagementPolicy
cookieUpdateRequired Boolean Sets whether or not to update a cookie in the TagManagement module’s webview
cookieUpdateEventName String Sets the event name to use when cookieUpdateRequired is set to true
policyStatusInfo() Map<String, Any> Returns a map of key value data to be added to the payload of each dispatch
shouldQueue() Boolean Returns whether or not to queue dispatches according to the ConsentPolicy rules
shouldDrop() Boolean Returns whether or not to drop dispatches according to the ConsentPolicy rules

Examples

The following example re-maps the policy data keys to avoid Tealium EventStream fixed consent values:

class CustomPolicy(
        val superPolicy: ConsentManagementPolicy
) : ConsentManagementPolicy by superPolicy {
    return superPolicy.policyStatusInfo().toMutableMap().apply {
        get(ConsentManagerConstants.CONSENT_STATUS)?.let { status ->
            remove(ConsentManagerConstants.CONSENT_STATUS)
            put("custom_consent_status", status)
        }
        get(ConsentManagerConstants.CONSENT_CATEGORIES)?.let { categories ->
            remove(ConsentManagerConstants.CONSENT_CATEGORIES)
            put("custom_consent_categories", categories)
        }
    }
}

The following example customizes the consent logging event name that is sent:

class CustomPolicy(
        val superPolicy: ConsentManagementPolicy
) : ConsentManagementPolicy by superPolicy {
    override val consentLoggingEventName: String
        get() {
            return when(userConsentPreferences.consentStatus) {
                ConsentStatus.CONSENTED -> "user_consented"
                ConsentStatus.NOT_CONSENTED -> "user_not_consented"
                ConsentStatus.UNKNOWN -> "user_consent_unknown"
            }
        }
}

The following example returns third-party consent values, where thirdPartyConsentProvider is a reference to another consent provider:

class CustomPolicy(
        val superPolicy: ConsentManagementPolicy,
        val thirdPartyConsentLibrary: OtherConsentProvider
) : ConsentManagementPolicy by superPolicy {
    override fun policyStatusInfo(): Map<String, Any> {
        val status = thirdPartyConsentLibrary
                .getConsent(userConsentPreferences.consentStatus == ConsentStatus.CONSENTED)
        return mapOf("my_consent_status" to status)
    }
}
Data Layer
Identity Resolution