getConsent
Functionality
The getConsent
function is used to notify the caller about the users consent when it is available, independent of the consent region. It provides a simplified consent state which is either full or no consent. If further consent details are required, use the consent region specific functions.
Syntax
function adconsent()
argument name | type | optional | value | description |
---|---|---|---|---|
command | string |
|
|
|
parameter | - | ✔️ |
| Not used |
callback | function |
|
| 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 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 rejected or restricted the consent in some way. It might be a full or partial rejection.
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 on 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 {
...
}
}
}
});