Microsoft Consent Mode (UET)
Enabling Microsoft Consent Mode in Gravito CMP (New) - TCF Component
TCF CMP Component supports two ways to enable Microsoft's Universal Consent Mode:
1. Using Configurator
- Login to the Gravito Admin Portal.
- Click on the CMP tab.
- Select the Gravito CMP (New) Configurator from the option.
- On the CMP Config listing page, click the New Configuration button to create a new CMP config.
-
Give config an appropriate name and choose TCF CMP as Framework. After that, click Get Started to proceed.
-
Now navigate to TCF CMP tab and TCF Settings sub-tab for UET related setup.
- You can enable UET by checking the checkbox labeled Microsoft's Universal Event Tracking (UET).
- After enabling UET, an additional field will appear for configuration.
Microsoft's Consent Signal Mapping:
You’ll now see default mapping for the consent signal : ad_storage
The signal is pre-mapped to the TCF purposes based on Microsoft's requirements and should not be changed.
Note: This mapping for the ad_storage
signal is common across both GCMv2 & UET.
You may continue filling out the other CMP configuration steps, or jump directly to the Deployment tab for publishing your config.
2. Without Configurator
-
Enable UET Mode:
Add theuseUET
flag under thewindow.gravito.config.cmp.tcf.core
section of your configuration and set its value totrue
.window.gravito = { config: { cmp: { tcf: { core: { useUET: true, // ... other configurations } } } } };
-
Add
adsConsentId
You must also define the
adsConsentId
property in your configuration. This is required to map consent values for Microsoft UET. There are two cases:-
If Google Consent Mode is already configured:
The
adsConsentId
property will already be available in your config. -
If not configured:
Add the
adsConsentId
property under thewindow.gravito.config.cmp.tcf.core
section of your config manually.
-
-
Define
adsConsentId
Based on CMP TypeThe
adsConsentId
should be an Array containing the IDs of TCF Purposes. It's value should be set to[1]
Example:
window.gravito = { config: { cmp: { tcf: { core: { adsConsentId: [1], // ... other configurations } } } } };
This example maps the consent value of Purpose 1 (typically used for storing and accessing information) to UET consent.
-
How Pro TCF CMP Handles UET Consent
Once the above configuration is complete:
- Microsoft UET mode is considered enabled.
- Gravito CMP adds the corresponding ads consent value (
denied
orgranted
) to the globaluetq
window object. - By default, the value is
denied
. - After consent is obtained, the CMP updates the value based on the mapping defined in
adsConsentId
.
Microsoft reads this value from the
uetq
object to determine whether tracking is allowed.Gravito CMP's follow the approach mentioned Here