Platform X Documentation Welcome to Success

consent.get

Method to receive Commanders Act consent and consent metadata OnSite via JavaScript.

PreviousGetting Started Nextconsent.update

Last updated 11 months ago

Was this helpful?

consent.get

Method to receive Commanders Act consent and consent metadata OnSite via JavaScript.

The Commanders Act has to be installed before using any of the OnSite API functions.

cact('consent.get', function (result) { ... });

The consent.get method takes one callback JavaScript function as an argument that gets called with the that is currently stored on the browser. The callback is called once after Commanders Act CMP 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

In this example the Analytics category was configured with the consent category id 2 in Commanders Act banner.

cact('consent.get', function (result) {

   var ANALYTICS_ID = 2;
   var analyticsCategory = result.consent.categories[ANALYTICS_ID] || {};
   
   if (analyticsCategory.status === 'on') {
         
      // Consent was provided for the category. 
      
   } else {
      
      // Consent was not provided for the category.
   
   }
        
});

In this example the Analytics category was configured with the consent category id 2 and the vendor Google with vendor id 5 in Commanders Act CMP.

cact('consent.get', function (result) {
   
   var ANALYTICS_ID = 2;
   var analyticsCategory = result.consent.categories[ANALYTICS_ID] || {};

   var GOOGLE_ID = 5;
   var googleVendor = result.consent.vendors[GOOGLE_ID] || {};
   
   if (analyticsCategory.status === 'on' && googleVendor.status === 'on') {
         
      // Consent was provided for the category. 
      
   } else {
      
      // Consent was not provided for the category.
   
   }
        
});

cact('consent.get', function (result) {
   
   if (result.consent.status === 'unset') {
         
      // Consent was not yet provided.
      
   } else {
      
      // Consent was accepted or refused.
   
   }
        
});

cact('consent.get', function (result) {

    var dateExpires = result.meta.dateExpires;
                
});

PreviousGetting Started Nextconsent.update

Last updated 11 months ago

Was this helpful?

The Commanders Act has to be installed before using any of the OnSite API functions.

cact('consent.get', function (result) { ... });

Examples

In this example the Analytics category was configured with the consent category id 2 in Commanders Act banner.

cact('consent.get', function (result) {

   var ANALYTICS_ID = 2;
   var analyticsCategory = result.consent.categories[ANALYTICS_ID] || {};
   
   if (analyticsCategory.status === 'on') {
         
      // Consent was provided for the category. 
      
   } else {
      
      // Consent was not provided for the category.
   
   }
        
});

In this example the Analytics category was configured with the consent category id 2 and the vendor Google with vendor id 5 in Commanders Act CMP.

cact('consent.get', function (result) {
   
   var ANALYTICS_ID = 2;
   var analyticsCategory = result.consent.categories[ANALYTICS_ID] || {};

   var GOOGLE_ID = 5;
   var googleVendor = result.consent.vendors[GOOGLE_ID] || {};
   
   if (analyticsCategory.status === 'on' && googleVendor.status === 'on') {
         
      // Consent was provided for the category. 
      
   } else {
      
      // Consent was not provided for the category.
   
   }
        
});

cact('consent.get', function (result) {
   
   if (result.consent.status === 'unset') {
         
      // Consent was not yet provided.
      
   } else {
      
      // Consent was accepted or refused.
   
   }
        
});

cact('consent.get', function (result) {

    var dateExpires = result.meta.dateExpires;
                
});

Examples

Executing code based on the consent setting of a category

Executing code based on the consent setting of a category and vendor

Check if consent was already set by the visitor

Checking when the current consent expires

Examples

Executing code based on the consent setting of a category

Executing code based on the consent setting of a category and vendor

Check if consent was already set by the visitor

Checking when the current consent expires