For the complete documentation index, see llms.txt. This page is also available as Markdown.

Microsoft Consent Mode (TCF)

Microsoft Consent Mode is a framework that ensures Microsoft Advertising Universal Event Tracking (UET) tags comply with an end-user's consent choices. In this article, we will cover how to utilize the IAB TCF integration with Microsoft Consent Mode.


When your organization leverages the IAB TCF integration with Microsoft Consent Mode, the Didomi web SDK will not push a default consent or update consent call to window.uetq. Instead, Didomi will write the end-user's consent decisions to the TC string and expose it so that the UET tag can read whether the end-user has provided consent to the vendor Microsoft Advertising (IAB Vendor ID: 1126) and all of its required purposes.

The status for ad_storage will be set based on the end-user's decision for Microsoft Advertising (IAB Vendor ID: 1126) and all of its required purposes as recorded in the TC String.

In order to successfully implement Microsoft Consent Mode (TCF) for the regulation, your organization must configure the following:

Click Regulations Manager on the left-hand panel.

Navigate to a regulation that utilizes a data collection scope by vendor on the subsequent table and click the Edit icon inline with the regulation name.

Navigate to the Frameworks card on the Global Settings page. Ensure that IAB TCF and Microsoft Consent Mode is enabled.

By enabling the Microsoft Consent Mode framework for the regulation, Didomi will automatically add the following vendor to the regulation:

  • Microsoft Advertising (API ID: microsoft-6zPzfpLt)

Navigate to the Vendors & Purposes tab and use the provided vendor x purpose matrix to configure processing rules, remove one of the purposes, etc... for Microsoft Advertising (API ID: microsoft-6zPzfpLt). See Configure regulation (by vendor) for more information.

Finally, navigate to the Frameworks tab and expand the Microsoft Consent Mode accordion to configure any details of the framework.

Review the table below for information on each toggle in the integration configuration:

Toggle
Description

Set the default status of Microsoft Consent mode when page loads

Will set a default consent status for ad_storage prior to the end-user making a consent choice. Unless otherwise configured, the default of this setting is denied.

Enable ad_storage before user gives consent

Will set the default of ad_storage to granted before end-user provides consent choice.

Enable IAB TCF integration with Microsoft Consent Mode

Ensure this toggle is activated to enable the IAB integration with Microsoft Consent Mode.

Click Save when finished to confirm the edits to the regulation.

Configure UET tag

Since Microsoft Consent Mode relies on the TC String to control the status of ad_storage when utilizing the IAB TCF integration, your organization can implement the UET tag as it normally would.ysh

Last updated