Consent Cookie

Format of the TrustCommander consent cookie.

The Consent Object received via the onsite API is now the official way to access the consent settings of TrustCommander with JavaScript. The direct usage of the consent cookie is deprecated.
TrustCommander stores the consent of website visitors in a 1st party JavaScript cookie.
This article only explains the consent cookie. Here you can find a list of all TrustCommander cookies.
Name
The default name of the consent cookie is TC_PRIVACY. It can be configured in TRUST > Options.
Domain
The cookie is set as a 1st party JavaScript cookie. The subdomain/domain of the cookie can be configured in TRUST > Options
Value
The value consist of multiple fields separated by @ symbols. The separator can be configured in TRUST > Options .
The consent cookie format is not 100% guaranteed to stay stable. We try to keep the format as stable as possible and extend it with "append only approach (adding new information with a new @)", but changes might happen in the unforeseeable future due to limited storage space in cookies.
The cookie value follows following pattern (optional elements are wrapped in []). 
<status>@<privacy_version>[|<tcf_version>]@<consent_categories>@<blocked_on_categories>@<creation_timestamp>[@<vendor_consent_string>]
Field
Description
Example Value
<status>
Status that indicates if a visitor provided his optin or optout.
1: Visitor is optout
0: Visitor is optin
<privacy_version>
Version of the privacy banner the visitor interacted with.
008
<tcf_version>
Version of the IAB TCF framework. Only available in case IAB is activated for the account and an IAB banner is used to manage consent. It follows this format:<tcf_global_vendor_list_specification_version>|<tcf_policy_version>|<tcf_global_vendor_list_version>
2|2|42
<consent_categories>
Comma-separated-list of optin, or optout categories. Meaning depends on <status> field. E.g. when <status> is 0 then the visitor provides consent for the listed categories. The value is URL encoded. Therefore the comma separator is replaced with %2C. Some old banner versions might have the value ALL in case all categories are opted out.
2%2C12%2C13
<blocked_on_categories>
Comma-separated-list of blocked on categories.  The value is URL encoded. Therefore the comma separator is replaced with %2C.  These categories are not repeated in the <consent_categories> field.
2%2C12
<creation_timestamp>
UNIX Epoch timestamp in milliseconds when the consent was provided. 
1592900933049
<vendor_consent_string>
Vendor consent information (e.g. for IAB TCF vendors).   Only available when vendors are activated for the account and in case vendors are used in the banner. The value is compressed and encoded to keep the cookie size small.
AAAAAjkb23...
Examples
Example1: Optin for some categories
[email protected]@1%[email protected]@[email protected]
Field
Description
0
Visitor is optin.
002
Visitor provided optin on banner version 002.
1%2C3
Visitor provided optin for categories 1 and 3.
4
The category 4 is blocked on.
1592900933049
Visitor provided optin on Tue Jun 23 2020 08:28:53.
Example 2: Optout for all categories
[email protected]@[email protected]@[email protected]
Field
Description
1
Visitor is optout
012
Visitor provided optin on banner version 012.
​
Visitor provided optout to all categories.
4
The category 4 is blocked on.
1592900933049
Visitor provided optout on Tue Jun 23 2020 08:28:53.
​

Knowledge Base - Previous

Consent Object

Next - Knowledge Base

IAB TCF V2.0 Consent

Last updated 4 months ago

Field	Description	Example Value
`<status>`	Status that indicates if a visitor provided his optin or optout.	`1`: Visitor is optout `0`: Visitor is optin
`<privacy_version>`	Version of the privacy banner the visitor interacted with.	`008`
`<tcf_version>`	Version of the IAB TCF framework. Only available in case IAB is activated for the account and an IAB banner is used to manage consent. It follows this format:`<tcf_global_vendor_list_specification_version>\|<tcf_policy_version>\|<tcf_global_vendor_list_version>`	`2\|2\|42`
`<consent_categories>`	Comma-separated-list of optin, or optout categories. Meaning depends on `<status>` field. E.g. when `<status>` is `0` then the visitor provides consent for the listed categories. The value is URL encoded. Therefore the comma separator is replaced with `%2C`. Some old banner versions might have the value `ALL` in case all categories are opted out.	`2%2C12%2C13`
`<blocked_on_categories>`	Comma-separated-list of blocked on categories. The value is URL encoded. Therefore the comma separator is replaced with `%2C`. These categories are not repeated in the `<consent_categories>` field.	`2%2C12`
`<creation_timestamp>`	UNIX Epoch timestamp in milliseconds when the consent was provided.	`1592900933049`
`<vendor_consent_string>`	Vendor consent information (e.g. for IAB TCF vendors). Only available when vendors are activated for the account and in case vendors are used in the banner. The value is compressed and encoded to keep the cookie size small.	`AAAAAjkb23...`

Field	Description
`0`	Visitor is optin.
`002`	Visitor provided optin on banner version 002.
`1%2C3`	Visitor provided optin for categories 1 and 3.
`4`	The category 4 is blocked on.
`1592900933049`	Visitor provided optin on Tue Jun 23 2020 08:28:53.

Field	Description
`1`	Visitor is optout
`012`	Visitor provided optin on banner version 012.
	Visitor provided optout to all categories.
`4`	The category 4 is blocked on.
`1592900933049`	Visitor provided optout on Tue Jun 23 2020 08:28:53.