> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.hoppyapps.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🔗 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.

---