ConsentManager | API Reference | Preview of Tealium Docs

Class: `ConsentManager`

The following summarizes the commonly used methods of the ConsentManager class.

Method	Description
`getPolicy()`	Returns the current policy
`getUserConsentCategories()`	Returns the current consent categories of the user
`getUserConsentPreferences()`	Returns the UserConsentPreferences object
`getUserConsentStatus()`	Returns the current consent status of the user
`resetUserConsentPreferences()`	Resets user consent consent preferences
`setPolicy()`	Overrides the default policy parameter (default: gdpr)
`setUserConsentCategories()`	Sets the user’s consent status and categories
`setUserConsentStatus()`	Sets the user’s consent status
`setUserConsentStatusWithCategories()`	Sets the consent status and categories in a single call

`getPolicy()`

Returns the current policy.

final String currentPolicy = tealiumInstance.getConsentManager().getPolicy();

Returns	Return Type
User’s current policy	`String`

`getUserConsentCategories()`

Returns the current consent categories of the user.

final String[] userCategories = tealiumInstance.getConsentManager().getUserConsentCategories();

Returns	Return Type
User’s current consent categories	`String[]`

`getUserConsentPreferences()`

Returns the user’s consent preferences.

final UserConsentPreferences userPreferences = tealiumInstance.getConsentManager().getUserConsentPreferences();

Returns	Return Type
User’s consent preferences	`UserConsentPreferences`

`getUserConsentStatus()`

Returns the current consent status of the user.

final String userStatus = tealiumInstance.getConsentManager().getUserConsentStatus();

Returns	Return Type
User’s current consent status	`String`

`resetUserConsentPreferences()`

Clears stored consent preferences, resets user preferences to defaults, and sets consent status to UNKNOWN with no categories.

tealiumInstance.getConsentManager().resetUserConsentPreferences();

`setPolicy()`

Overrides the default policy parameter. Default is gdpr.

tealiumInstance.getConsentManager().setPolicy(policy);

Parameter	Type	Description	Example
`policy`	`String`	Policy to set	`"custompolicy"`

`setUserConsentCategories()`

Sets the user’s consent status and categories. Call this method from your consent management preferences screen in your app. This method automatically sets the user’s consent status to CONSENTED if any number of categories are set.

tealiumInstance.getConsentManager().setUserConsentCategories(categories);

Parameter	Type	Description	Example
`categories`	`[String]`	Categories to set	`String[]`

The following static constants are the complete list of supported consent categories:

AFFILIATES
ANALYTICS
BIG_DATA
CDP
COOKIEMATCH
CRM
DISPLAY_ADS
EMAIL
ENGAGEMENT
MOBILE
MONITORING
PERSONALIZATION
SEARCH
SOCIAL
MISC

`setUserConsentStatus()`

Sets the user’s consent status. Call this method from your consent management preferences screen in your app when the user opts in or opts out of tracking. If true, automatically enables all categories. If false, all categories automatically disabled.

If the user’s status is set to CONSENTED using this method, the Consent Manager automatically subscribes the user to ALL available consent categories (subset of categories not allowed).

tealiumInstance.getConsentManager().setUserConsentStatus(status);

Parameter	Type	Description	Example
`status`	`String`	Status to set the user’s consent	[`ConsentManager.ConsentStatus.CONSENTED`, `ConsentManager.ConsentStatus.NOT_CONSENTED`]

These static constants are the complete list of supported consent statuses.

CONSENTED
NOT_CONSENTED
UNKNOWN

UNKNOWN
The UNKNOWN status is the default setting for the Consent Manager. In this state, the Consent Manager queues events locally until an affirmative CONSENTED/NOT_CONSENTED status is provided.

tealiumInstance.getConsentManager().setUserConsentStatus(ConsentManager.ConsentStatus.UNKNOWN);

CONSENTED
The CONSENTED status is set when the user has consented to tracking. In this status, the Consent Manager dequeues any previously-queued track calls and allow all subsequent tracking calls to continue as normal.

tealiumInstance.getConsentManager().setUserConsentStatus(ConsentManager.ConsentStatus.CONSENTED);

NOT_CONSENTED
The NOT_CONSENTED status is set when the user has declined tracking. In this state, the Consent Manager purges any previously-queued track calls and drops all subsequent tracking calls from being further processed by the SDK.

tealiumInstance.getConsentManager().setUserConsentStatus(ConsentManager.ConsentStatus.NOT_CONSENTED);

`setUserConsentStatusWithCategories()`

Sets the consent status and categories in a single call.

tealiumInstance.getConsentManager().setUserConsentStatusWithCategories(status, categories);

Parameter	Type	Description	Example
`status`	`String`	Status to set the user’s consent	[`ConsentManager.ConsentStatus.CONSENTED`, `ConsentManager.ConsentStatus.NOT_CONSENTED`]
`categories`	`[String]`	Categories to set	`new String[]{ConsentManager.ConsentCategory.ANALYTICS, ConsentManager.ConsentCategory.BIG_DATA}`

See setUserConsentStatus() and setUserConsentCategories() for a list of constant supported.

Class: ConsentManager

getPolicy()

getUserConsentCategories()

getUserConsentPreferences()

getUserConsentStatus()

resetUserConsentPreferences()

setPolicy()

setUserConsentCategories()

setUserConsentStatus()

setUserConsentStatusWithCategories()