๐ Integrate Hoppy Cookie with Microsoft Consent Mode (UET)
Microsoft Consent Mode (UET) allows Microsoft Universal Event Tracking tags to respect the cookie preferences selected by your visitors.
When connected, Hoppy Cookie automatically communicates consent choices to your existing Microsoft UET implementation, allowing Microsoft Ads tracking to respond appropriately when visitors accept or decline Analytics and Marketing cookies.
This helps maintain a more privacy-friendly tracking setup without requiring manual theme updates whenever consent preferences change.
โ ๏ธ Before You Begin
Before enabling Microsoft Consent Mode (UET), make sure:
- Hoppy GDPR EU Cookie Banner is installed and active
- Your Cookie Banner is published
- Microsoft UET is already installed on your storefront
For example, the UET tag may already exist inside:
- theme.liquid
- Theme code
- Custom tracking scripts
โ ๏ธ Important:
This integration only sends consent signals.
It does not install the Microsoft UET tag automatically.
If Microsoft UET is not already installed, the integration cannot communicate consent information.
๐ ๏ธ Step 1 โ Open the Integrations Section
Inside your Shopify Admin:
โ Open Hoppy GDPR EU Cookie Banner
โ Click Integrations
Locate:
Microsoft Consent Mode (UET)
and open the integration page.
If the integration has not been configured yet, the status will display:
โ Off
โ๏ธ Step 2 โ Enable the Integration
Inside the Microsoft Consent Mode (UET) integration page:
โ Toggle Integrate with Microsoft Consent Mode (UET) to On
Once enabled:
- The status changes to On
- Consent signals become available to Microsoft UET
- Consent is granted if visitors accept either Analytics or Marketing cookies
- Consent is denied only if both categories are declined
The app will automatically update consent information whenever visitors modify their cookie preferences.
๐พ Step 3 โ Save Your Changes
After enabling the integration:
โ Click Save
The configuration is automatically synchronized to your storefront.
No additional theme modifications are required.
๐ How the Integration Works
Once enabled, Hoppy Cookie continuously communicates visitor consent choices to Microsoft UET.
When Consent Is Accepted
If visitors accept Analytics or Marketing cookies:
โ Microsoft UET receives a consent granted signal
โ Tracking can operate normally
โ Microsoft Ads can collect permitted tracking information
When Consent Is Declined
If visitors decline Analytics or Marketing cookies:
โ Microsoft UET receives a consent denied signal
โ Tracking behavior is restricted
โ Microsoft Ads receives updated consent information
This helps align tracking behavior with visitor preferences.
๐งช Step 4 โ Verify the Integration
After saving, it's recommended to verify that the integration is functioning correctly.
Test with Cookies Declined
โ Open your storefront in an Incognito or Private browser window
โ Decline Analytics or Marketing cookies
Then:
โ Open Developer Tools
โ Open the Console
โ Enter:
window.uetq
Expected Result
You should see entries indicating:
consent: denied
This confirms Microsoft UET received the denied consent signal.
Test with Cookies Accepted
Repeat the test using a fresh Incognito window.
This time:
โ Accept Analytics or Marketing cookies
Then:
โ Open the Console
โ Enter:
window.uetq
Expected Result
You should see entries indicating:
consent: granted
This confirms Microsoft UET received the granted consent signal.
Verify Consent Updates
After changing consent preferences:
- The consent signal should update automatically
- No page reload should be required in most cases
This helps ensure Microsoft tracking remains synchronized with the visitor's latest preferences.
โ ๏ธ Common Troubleshooting
Microsoft UET Does Not Respond
Verify that the Microsoft UET tag is actually installed on your storefront.
Remember:
- Hoppy Cookie sends consent signals
- Hoppy Cookie does not install Microsoft UET
Without the UET tag, there is nothing available to receive the consent updates.
Using Google Tag Manager
If Microsoft UET is loaded through Google Tag Manager (GTM):
โ Use Google Consent Mode V2 instead
The Microsoft Consent Mode integration is intended for UET tags installed directly in the storefront theme.
Consent Signals Are Missing
Verify:
- The integration is enabled
- Changes were saved successfully
- The Cookie Banner is published
- Analytics or Marketing consent categories are enabled
Without applicable consent categories, no signal changes will occur.
Tracking Continues After Consent Is Declined
Verify:
- Microsoft UET is configured correctly
- No duplicate UET tags exist
- Another tracking implementation is not bypassing consent handling
Multiple tracking installations can cause unexpected behavior.
โ ๏ธ Important Notes
UET Must Already Be Installed
This integration does not install Microsoft UET.
A valid Microsoft UET tag must already exist on the storefront before consent signals can be sent.
Designed for Direct Theme Installations
The integration is intended for UET tags loaded directly through theme code.
Stores using GTM should generally use Google Consent Mode V2 instead.
Consent Updates Are Automatic
Whenever visitors:
- Accept cookies
- Decline cookies
- Update preferences
Hoppy Cookie automatically updates the consent signal sent to Microsoft UET.
Analytics and Marketing Categories Matter
The integration primarily responds to:
- Analytics consent
- Marketing consent
Accepting either Analytics or Marketing cookies will set consent to granted. Both categories must be declined for consent to be denied.
๐ Final Result
Once configured successfully:
โ Microsoft UET receives visitor consent signals automatically
โ Tracking behavior responds to Analytics and Marketing preferences
โ Consent changes stay synchronized with Microsoft Ads
โ Tracking can be restricted when visitors decline consent
โ No ongoing theme edits are required
โ Your Microsoft advertising setup becomes more privacy-aware
The Microsoft Consent Mode (UET) integration helps ensure Microsoft tracking respects visitor consent preferences while keeping your advertising measurement aligned with your Cookie Banner settings.
Updated on: 14/07/2026
Thank you!