Functionality

The getConsent function returns if we have full consent or not from the user, and which consent zone is currently active.

Syntax

function adconsent()

argument name	type	optional	value	description
command	string		`'getConsent'`
parameter	-	✔️	`null` \| `undefined`	Not used
callback	function	✔️	`function(result:ConsentData, success:boolean)`	The callback function that is called with the function call result and whether or not the call was successful.

`ConsentData`

ConsentData = {
  fullConsent: true | false,
  region: <active consent region>
}

`ConsentData.fullConsent`

When fullConsent is true, it means the user has expressed full consent in the consent zone where he’s in. This might mean different things in the different consent zones, i.e., the user has given consent for all purposes, vendors and publisher purposes in GDPR, or the user simply didn’t oppose to the sale of his personal data in CCPA. The exact implications of the full consent given will depend on the applicable regional privacy law - however the true value means that the user didn’t oppose or restrict the consent in any way.

A false value for the fullConsent means that the user has opposed or restricted the consent in some way. It might be a full opposal or just a partial one.

`ConsentData.region`

The consent region can have the following values:

<empty> (no consent region)
'tcfeuv2' (GDPR)
'uspv1' (CCPA)

Other regions that can appear:

'tcfcav1' (PIPEDA - Canada)
'usnat' (US National)
'usca' (US California)
'usco' (US Colorado)
'usct' (US Connecticut)
'usva' (US Virginia)
'usut' (US Utah)

Description

When the function is called, the callback will be called once AdConsent resolves consent (either by having a previously saved consent or waiting for the user to interact with the GUI when no previous consent was in place). Subsequent calls will be returned immediately.

If for some reason the user reopens the GUI, while in the GUI any calls to getConsent will return the same previous consent value. Only after closing the GUI the consent will be updated and a new call to getConsent will reflect the new value.

Scope

The function can be called as soon as AdConsent is declared in the page, which means it can be called right after AdConsent stub is created. The callback will be called once AdConsent resolves consent for the first time.

Example

Get consent to execute an action that relies on consent

adconsent('getConsent', null, function(consent, success) {
  if (success) {
    if (consent.fullConsent) {
      // We have full consent, do whatever that needed consent from the user
    } else {
      // We have no full consent, but it might be that we still want to do
      // some stuff for particular regions. 
      if (consent.region == 'tcfeuv2') {
        // do something that doesn't need full consent in GDPR
      } else if (consent.region == 'uspv1') {
        // do something that doesn't need full consent in CCPA
      } else {
        ...
      }
    }
  }
});