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 Opt-in and Opt-out consent management policies, create a custom consent policy.

Implement the ConsentManagementPolicy interface.

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

Pass the ConsentManagementPolicy implementation to the ConsentPolicy.CUSTOM enum using the setCustomPolicy() method.
```
ConsentPolicy.CUSTOM.setCustomPolicy(customPolicy)
```
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)
    }
}

Usage

Consent

Set Policy

Consent Expiration

Set Full Consent

Set Partial Consent by Category

Set Declined Consent

Custom Consent

Examples