English
Setup Guides
Extensions
Marketing Preferences Center
Knowledge Base
Rest data API
PLATFORM API
consent.get
Method to receive TrustCommander consent and consent metadata OnSite via JavaScript.
The Commanders Act OnSite API stub has to be installed before using any of the OnSite API functions.
1
cact('consent.get', function (result) { ... });
Copied!
The
consent.get method takes one callback JavaScript function as an argument that gets called with the Consent Object that is currently stored on the browser. The callback is called once after TrustCommander JavaScript loaded and validated the stored consent.The OnSite API works asynchronous. In case you need the consent synchronous (e.g. in the
<head> of a document for AB Testing or personalisation solutions) it is recommended to cache the object in the localStorage of the browser. In this case it is crucial to implement the consent.onUpdate method to keep the cached consent in sync.Examples
Executing code based on the consent setting of a category
In this example the Analytics category was configured with the consent category id 2 in TrustCommander.
1
cact('consent.get', function (result) {
2
3
const ANALYTICS_ID = 2;
4
const analyticsCategory = result.consent.categories[ANALYTICS_ID] || {};
5
6
if (analyticsCategory.status === 'on') {
7
8
// Consent was provided for the category.
9
10
} else {
11
12
// Consent was not provided for the category.
13
14
}
15
16
});
Copied!
Executing code based on the consent setting of a category and vendor
In this example the Analytics category was configured with the consent category id 2 and the vendor Google with vendor id 5 in TrustCommander.
1
cact('consent.get', function (result) {
2
3
const ANALYTICS_ID = 2;
4
const analyticsCategory = result.consent.categories[ANALYTICS_ID] || {};
5
6
const GOOGLE_ID = 5;
7
const googleVendor = result.consent.vendors[GOOGLE_ID] || {};
8
9
if (analyticsCategory.status === 'on' && googleVendor.status === 'on') {
10
11
// Consent was provided for the category.
12
13
} else {
14
15
// Consent was not provided for the category.
16
17
}
18
19
});
Copied!
Check if consent was already set by the visitor
1
cact('consent.get', function (result) {
2
3
if (result.consent.status === 'unset') {
4
5
// Consent was not yet provided.
6
7
} else {
8
9
// Consent was accepted or refused.
10
11
}
12
13
});
Copied!
Checking when the current consent expires
1
cact('consent.get', function (result) {
2
3
const dateExpires = result.meta.dateExpires;
4
5
});
Copied!
Last modified 10mo ago