UET Tag Helper is a browser extension that validates the implementation of the Microsoft Advertising Universal Event Tracking (UET) tag—and the functionality of conversion goals—on any given webpage. It is available in Microsoft Edge and Google Chrome. To learn more about UET tags, see What is UET and how can it help me?
UET Tag Helper allows you to:
Badge type | What it looks like | What it means |
---|---|---|
No badge | ![]() |
This can mean several things:
|
Green badge | ![]() | There are tags on this webpage and they are working correctly. No action required. |
Yellow badge | ![]() | The tags on this webpage are working correctly but can be improved. Select the UET Tag Helper icon to see what the issue is and how you can resolve it. |
Red badge | ![]() | The tags on this webpage are not working correctly and need to be fixed. Select the UET Tag Helper icon to see what the issue is and how you can resolve it. |
The number in the badge indicates how many times there was a UET tag request from the webpage. So the first time you visit a webpage, it shows you the number of UET tags on that webpage but if you refresh the webpage again the number increases.
Yes, UET Tag Helper can be installed on computers with standard access privileges. However, you need the Edge or Chrome browser installed on your computer and it might require admin approval to install.
UET Tag Helper validates one webpage at a time. To troubleshoot your entire website, you need to run UET Tag Helper on each webpage in the your browser.
When there is an update available, it will be automatically installed within 24 hours of release.
The Events tab shows the UET events that were triggered on the webpage. There are three types of events you can see:
The tracking code for each UET tag.
Most of the time, the webpage you go to after you select the ad and where the UET tag is firing from (Referrer URL) is the same. This might not be the case if you use an iFrame.
An iFrame or Inline Frame is used to embed another document within the current HTML page. If the UET tag is embedded in an iFrame, the Referrer URL of the webpage and the iFrame can be different. In this case, Microsoft Advertising might receive two different Referrer URLs. This is why we should always use the P parameter when checking for Destination URL.
After you have installed the UET tag on your webpage, waited 24 hours, and received clicks on your ad, you can validate your conversion goal. First in Microsoft Advertising, you want to find out the conversion goal status, and then if the status is Tag inactive, you can use UET Tag Helper to validate if the issue is caused by the UET tag.
What it is: Microsoft Advertising hasn’t received any user activity data from the UET tag on your website. It can take up to 24 hours for Microsoft Advertising to verify. If you still see this status, you either have not added the UET tag tracking code to your website or there is an issue with the setup that you need to fix.
What to do: Nothing
What it is: Microsoft Advertising has seen your UET tag, but haven't recorded any conversions in the last 7 days. This is most likely because you either have created the goal incorrectly, have not tagged your entire website, especially the pages that have the conversion action or you don't have any users converting on your site.
What to do: Nothing
What it is: Microsoft Advertising has seen your UET tag and has recorded conversions within the last 7 days. If your conversion window is greater than 7 days and you are filtering on the last 7 days, you may see this status even if no conversions are shown in the Conversions column, as conversions are reported at the time of the select.
What to do: Nothing
What it is: Microsoft Advertising has not received any user activity data from the UET tag in the last 24 hours. Make sure that the UET tag tracking code is still on your website.
What to do: Validate with UET Tag Helper
If the conversion goal uses a Begins, Contains or Regx operator to define the destination URL, you will need the specific URL for the conversion page (for example, the purchase confirmation page) or navigate to the conversion page with the UET Tag Helper turn on.
After you have installed the UET tag on your website, waited 24 hours and received select on your ads, you can validate your conversion goal. First in Microsoft Advertising, you want to find out the conversion goal status, and then if the status is Tag inactive, you can use UET Tag Helper to validate if the issue is caused by the UET tag.
What it is: Microsoft Advertising hasn’t received any user activity data from the UET tag on your website. It can take up to 24 hours for Microsoft Advertising to verify. If you still see this status, you either have not added the UET tag tracking code to your website or there is an issue with the setup that you need to fix.
What to do: Nothing
What it is: Microsoft Advertising has seen your UET tag, but haven't recorded any conversions in the last 7 days. This is most likely because you either have created the goal incorrectly, have not tagged your entire website, especially the pages that have the conversion action or you don't have any users converting on your site.
What to do: Nothing
What it is: Microsoft Advertising has seen your UET tag and has recorded conversions within the last 7 days. If your conversion window is greater than 7 days and you are filtering on the last 7 days, you may see this status even if no conversions are shown in the Conversions column, as conversions are reported at the time of the select.
What to do: Nothing
What it is: Microsoft Advertising has not received any user activity data from the UET tag in the last 24 hours. Make sure that the UET tag tracking code is still on your website.
What to do: Validate with UET Tag Helper
After you have installed the UET tag on your website, waited 24 hours and received select on your ads, you can validate your conversion goal. First in Microsoft Advertising, you want to find out the conversion goal status, and then if the status is Tag inactive, you can use UET Tag Helper to validate if the issue is caused by the UET tag.
What it is: Microsoft Advertising hasn’t received any user activity data from the UET tag on your website. It can take up to 24 hours for Microsoft Advertising to verify. If you still see this status, you either have not added the UET tag tracking code to your website or there is an issue with the setup that you need to fix.
What to do: Nothing
What it is: Microsoft Advertising has seen your UET tag, but haven't recorded any conversions in the last 7 days. This is most likely because you either have created the goal incorrectly, have not tagged your entire website, especially the pages that have the conversion action or you don't have any users converting on your site.
What to do: Nothing
What it is: Microsoft Advertising has seen your UET tag and has recorded conversions within the last 7 days. If your conversion window is greater than 7 days and you are filtering on the last 7 days, you may see this status even if no conversions are shown in the Conversions column, as conversions are reported at the time of the select.
What to do: Nothing
What it is: Microsoft Advertising has not received any user activity data from the UET tag in the last 24 hours. Make sure that the UET tag tracking code is still on your website.
What to do: Validate with UET Tag Helper
For remarketing lists, you need to verify that the UET tag on the webpage defined in the remarketing list is working.
You need to move the UET tag into the head or body section of the webpage.
Paste the UET tag tracking code on every page of your website, either in the head or body sections.
In the image, the UET tag is pasted at the top of the body section of the webpage.
The UET tag tracking code can be added anywhere on the webpage, in the head section (before the closing head tag </head>) or the body section (before the closing body tag </body>).
Delete the current UET tag from the webpage, copy the UET tag from Microsoft Advertising, and then add it to the webpage again.
Enter a value between 0 and 9999999 with up to 3 decimal places for the revenue value. To learn more, see How to report variable revenue with UET.
Enter the currency code for the variable revenue defined in the conversion goal. To find the complete list of currencies available for conversion goals, see Conversion Goal Revenue Currencies.
Enter a value between 0 and 9999999 with up to 3 decimal places for the event value. To learn more, see How to track custom events with UET.
Make sure that the tag ID you're using contains only numerals. To find the correct UET tag ID:
Delete the current UET tag from the webpage, copy the UET tag from Microsoft Advertising, and then add it to the webpage again.
We can’t find the UET tag tracking code on this webpage but Microsoft Advertising received tracking data. Most likely you are using a tag management tool to manage your tags. If this is what you want to do, you can ignore this message. If you want to add a UET tag tracking code to your website, follow these instructions.
You should remove the Non-JavaScript UET tag tracking code from this webpage. To learn about the difference between the two different UET tag tracking codes, see Using the JavaScript UET tag tracking code.
We recommend that you place your UET tag outside of an iFrame and use a JavaScript tracking code. This placement will ensure that your conversions are accurately tracked and measured.
We recommend that you use the JavaScript tracking code instead. This will ensure your conversions are accurately tracked and measured. It also means that you don’t have to update the JavaScript code if Microsoft Advertising releases future changes to the UET tag tracking code. To learn more about the difference between the two different UET tag tracking codes, see Using the JavaScript UET tag tracking code.
If you have more than one UET tag on the page, we recommend that you have a different name for each event.
By default, the global event tracker object created by Universal Event Tracking script is named uetq. If needed the global event tracker can be renamed to a desired value by replacing the default event tracker name parameter value in the original tracking code. Microsoft Advertising does not support any customization of the Non-JavaScript UET tag tracking
Example:
Here is what the code would look like if there are two different UET tags sending revenue value from the same webpage.
Account 1: X12345678
UET tag 1 (JavaScript):
<script>
(function(w,d,t,r,u){var f,n,i;w[u]=w[u]||[],f=function(){var o={ti:"12345678"};o.q=w[u],w[u]=new UET(o),w[u].push("pageLoad")},n=d.createElement(t),n.src=r,n.async=1,n.onload=n.onreadystatechange=function(){var s=this.readyState;s&&s!=="loaded"&&s!=="complete"||(f(),n.onload=n.onreadystatechange=null)},i=d.getElementsByTagName(t)[0],i.parentNode.insertBefore(n,i)})(window,document,"script","//bat.bing.com/bat.js","uetq1");
</script><noscript><img src="//bat.bing.com/action/0?ti=12345678&Ver=2" height="0" width="0" style="display:none; visibility: hidden;" />
</noscript>
Revenue Tracking for Account 1
<script>
window.uetq1 = window.uetq1 || [];
window.uetq1.push({ 'revenue_value': Revenue}); // Pass the computed revenue
</script>
Account 2: X87654321
UET tag 2 (JavaScript):
<script>(function(w,d,t,r,u){var f,n,i;w[u]=w[u]||[],f=function(){var o={ti:"87654321"};o.q=w[u],w[u]=new UET(o),w[u].push("pageLoad")},n=d.createElement(t),n.src=r,n.async=1,n.onload=n.onreadystatechange=function(){var s=this.readyState;s&&s!=="loaded"&&s!=="complete"||(f(),n.onload=n.onreadystatechange=null)},i=d.getElementsByTagName(t)[0],i.parentNode.insertBefore(n,i)})(window,document,"script","//bat.bing.com/bat.js","uetq2");</script><noscript><img src="//bat.bing.com/action/0?ti=87654321&Ver=2" height="0" width="0" style="display:none; visibility: hidden;" />
</noscript>
Revenue Tracking for Account 2
<script>
window.uetq2 = window.uetq2 || [];
window.uetq2.push({ 'revenue_value': Revenue}); // Pass the computed revenue
</script>