English
Setup Guides
Extensions
Marketing Preferences Center
Rest data API
PLATFORM API
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 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 cookie. The subdomain/domain of the cookie can be configured in
TRUST > OptionsValue
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>]@<banner_id>@<site_id>@<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 optout0: 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<banner_id>ID of the privacy banner the visitor interacted with.
12
<site_id>ID of the site in the Commanders Act Platform.
34
<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
Field
Description
0Visitor is optin.
002Visitor provided optin on banner version 002.
12Banner ID is 12.
34Site ID is 34.
1%2C3Visitor provided optin for categories 1 and 3.
4The category 4 is blocked on.
1592900933049Visitor provided optin on Tue Jun 23 2020 08:28:53.
Example 2: Optout for all categories
Field
Description
1Visitor is optout
012Visitor provided optin on banner version 012.
26Banner ID is 26.
42Site ID is 42.
Visitor provided optout to all categories.
4The category 4 is blocked on.
1592900933049Visitor provided optout on Tue Jun 23 2020 08:28:53.
Last modified 1mo ago
Export as PDF
Copy link