Test conversion goals and audiences with UET Tag Helper

UET Tag Helper is a browser extension that validates the implementation of the Microsoft Advertising UET tag and the functionality of conversion goals on any given webpage.

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:

  • Validate and troubleshoot UET tags. You can validate UET tags right in the browser instead of checking the tag status in Microsoft Advertising after a few hours. The UET Tag Helper icon tells you how many UET tags you have on a webpage and if they are working or not. If your tags are not working, the helper tells you what the issue is and what you can do to fix it.
  • Test your conversion goals. Show UET Tag Helper which conversion you want to test and then navigate your website, and it will tell you what conversion events it records, what problems it encounters, and how to fix them.
Set up UET Tag Helper expando image
Microsoft Edge:
  1. Download the UET Tag Helper in Edge.
  2. Select Get, and then Add extension.
    By installing the UET Tag Helper, you agree to the Microsoft Service Agreement and Microsoft Privacy Statement.
  3. Once installed, you will see the UET Tag Helper icon in Edge.
Google Chrome:
  1. Download the UET Tag Helper in Chrome.
  2. Select Add to Chrome, and then Add extension.
    By installing the UET Tag Helper, you agree to the Microsoft Service Agreement and Microsoft Privacy Statement.
  3. Once installed, you will see the UET Tag Helper icon in Chrome. UET Tag Helper icon in Chrome bar
Validate UET tags expando image
Once your UET tag has been on your webpage for more than 24 hours, you can use the UET Tag Helper to check to see if your UET tag is working or not.
  1. In Edge or Chrome, go to a webpage that you want to check, and then select the UET Tag Helper icon.
  2. In UET Tag Helper, flip the toggle On, and then refresh the browser page.
  3. Review the UET Tag Helper icon status. The color of the badge shows the status, and the number in the badge shows how many times there was a UET tag request from the webpage.
    Badge typeWhat it looks likeWhat it means
    No badgeUET Tag Helper icon showing no tags on webpage This can mean several things:
    • There is no UET tag installed on the page so you need to add it.
    • The UET tag is formatted incorrectly so the UET Tag Helper doesn't recognize it. You need to reinstall the UET tag.
    • The UET tag is installed on the website's conversion page only (for example, the purchase confirmation page) so you need to navigate to the conversion page with the UET Tag Helper turn on.
    Green badgeUET Tag Helper icon with green badge There are tags on this webpage and they are working correctly. No action required.
    Yellow badgeUET Tag Helper icon with 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 badgeUET Tag Helper icon with 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.
Note

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.

Fix issues

Once you know that you have an issue with your UET tag, you can use UET Tag Helper to find out what the issue is and how to fix it.
  1. Select the UET Tag Helper icon to open the tag details.
  2. On the Results tab, review the errors and the suggestions on how to fix the issue.
  3. Fix the issues and check the webpage again.
Test conversion goals expando image
UET Tag Helper can now test your conversion goals. Show it which conversion you want to test and then navigate your website, and it will tell you what conversion events it records and what problems it encounters.

  1. From the top menu, select Tools > Conversion goals.

    If you're using the new Microsoft Advertising navigation, from the navigation menu on the left, hover over Conversions and select Conversion goals.

  2. Go to the Tracking status for this conversion goal and select Test this conversion goal.
  3. Select the UET Tag Helper icon in your browser's extension menu.
  4. Enter your landing page URL in the helper and select Start test.
  5. Navigate through your website and attempt to trigger your conversion goal event.
  6. When you see either Conversion found or Problem encountered, select View report for a summary of what was passed back to Microsoft Advertising.
  7. For the Problems encountered, follow the instructions in the report to fix the issues.
  8. Wait at least 24 hours and then check to see if you're recording conversions and variable revenue accurately.
Test audience lists expando image
You can test audiences such as Dynamic remarketing lists with the UET tag helper. Show it which audience that you want to test and then navigate through your website, and the UET tag helper will tell you what events it records and what problems it encounters.

  1. From the top menu, select Tools > Audiences.

    If you're using the new Microsoft Advertising navigation, from the navigation menu on the left, select Tools > Audiences.

  2. Go to the Audience status column in the list of audiences and hover over the status of the audience that you want to test. Select Test this audience.
  3. Select the UET Tag Helper icon in your browser's extension menu.
  4. Enter your landing page URL in the helper and select Start test.
  5. Navigate through your website and attempt to trigger updates to the audience.
  6. When you are ready to see the results, select End test and select View report for a summary of what was passed back to Microsoft Advertising.
  7. For the Problems encountered, follow the instructions to resolve any issues.
UET Tag Helper FAQ expando image

Can UET Tag Helper be installed on computers that don't have admin privileges?expando image

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.

Will the UET Tag Helper validate my entire website?expando image

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.

How can I get the latest version of the UET Tag Helper?expando image

When there is an update available, it will be automatically installed within 24 hours of release.

What does the Events tab show?expando image

The Events tab shows the UET events that were triggered on the webpage. There are three types of events you can see:

  • Page load event: If you added a JavaScript UET tag to your webpage, this will show for conversion goals and remarketing lists that don't have a custom event. The URL of the current page is recorded in this event with the ‘P’ parameter (Page URL):
    Page load event
  • Custom event: If you added a JavaScript UET tag to your webpage, this will show for conversion goals and remarketing lists that have a custom event. The event parameters passed in the custom event script can be found in the ec (category), ea (action), el (label) and ev (value) parameters:
    Custom event
    Variable revenue will also show in a custom event. The recorded revenue value will be recorded in the gv parameter:
    Beacon event
  • Beacon: If you added a Non-JavaScript UET tag to your webpage, this will show for all conversion goals and remarketing lists.
    Beacon event
What does the Tracking code tab show?expando image

The tracking code for each UET tag.
Tracking code tab

Why do I need to check P parameter? expando image

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.

How to validate a destination URL conversion goal? expando image

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.

  1. From the top menu, select Tools > Conversion goals.

    If you're using the new Microsoft Advertising navigation, from the navigation menu on the left, hover over Conversions and select Conversion goals.

  2. Review the Tracking status column.

    Unverifiedexpando image

    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

    No recent conversionsexpando image

    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

    Recording conversionsexpando image

    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

    Tag inactiveexpando image

    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

  3. If the status is Tag inactive, go the destination URL associated with the conversion goals in your browser, turn UET Tag Helper ON, and then validate if the tag is working or not.
    • If the UET tag is working, check the Events tab to make sure there is a Page Load event and the P parameter matches the URL define in the conversion goal.
    • If the UET tag is not working, use UET Tag Helper to troubleshoot the issue.
Note

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.

How to validate a custom event conversion goal? expando image

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.

  1. From the top menu, select Tools > Conversion goals.

    If you're using the new Microsoft Advertising navigation, from the navigation menu on the left, hover over Conversions and select Conversion goals.

  2. Review the Tracking status column.

    Unverifiedexpando image

    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

    No recent conversionsexpando image

    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

    Recording conversionsexpando image

    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

    Tag inactiveexpando image

    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

  3. If the status is Tag inactive, in your browser, turn UET Tag Helper ON, complete the steps needed to trigger the custom event, and then validate if the tag is working or not.
    • If the UET tag is working, check the Events tab to make sure there is a Page Load event and a Custom event and that the custom event matches what is defined in the custom event conversion goal.
    • If the UET tag is not working, use UET Tag Helper to troubleshoot the issue.
How to validate a conversion goal with variable revenue? expando image

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.

  1. From the top menu, select Tools > Conversion goals.

    If you're using the new Microsoft Advertising navigation, from the navigation menu on the left, hover over Conversions and select Conversion goals.

  2. Review the Tracking status column.

    Unverifiedexpando image

    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

    No recent conversionsexpando image

    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

    Recording conversionsexpando image

    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

    Tag inactiveexpando image

    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

  3. If the status is Tag inactive, in your browser, turn UET Tag Helper ON, complete the steps needed to trigger the conversion goal, and then validate if the tag is working or not.
    • If UET tag is working, check the Events tab to make sure there is a Page Load event and a Custom event, revenue isn't missing, and gv and gc are not blank. If the revenue is missing, you need to add the revenue code to your website. If the gv or gc value is blank, there is something wrong with your revenue function. For more information, see How to track custom events with UET
    • If the UET tag is not working, use UET Tag Helper to troubleshoot the issue.
How to validate a remarketing list? expando image

For remarketing lists, you need to verify that the UET tag on the webpage defined in the remarketing list is working.

  • If you selected one of the Visitor of a page options, go the destination URL defined in the remarketing list, turn UET Tag Helper ON, and then validate if the tag is working or not.
  • If you selected the Custom events, in your browser, turn UET Tag Helper ON, complete the steps needed to trigger the custom event, and then validate if the tag is working or not.
How can I fix the "UET tag outside of head or body" issue?expando image

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.

UET tag
Note

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>).

How can I fix the "UET tag contains incorrect HTML" issue?expando image

Delete the current UET tag from the webpage, copy the UET tag from Microsoft Advertising, and then add it to the webpage again.

  1. Sign in to Microsoft Advertising.
  2. From the top menu, select Tools > UET tag.

    If you're using the new Microsoft Advertising navigation, from the navigation menu on the left, hover over Conversions and select UET tag.

  3. In the table, find the UET tag that you want to use and in the far right column, select View tag.
    UET tags page
  4. In the UET tag tracking code box, select Copy and then Done.
    Note: If your website doesn't support JavaScript, select the Non-JavaScript tab before you select Copy.
    UET tags page
  5. 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.
    UET tag
How can I fix the "Incorrect variable revenue value" issue?expando image

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.

How can I fix the "Incorrect currency code" issue?expando image

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.

How can I fix the "Incorrect event value" issue?expando image

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.

How can I fix the "UET tag ID is invalid" issue?expando image

Make sure that the tag ID you're using contains only numerals. To find the correct UET tag ID:

  1. Sign in to Microsoft Advertising.
  2. From the top menu, select Tools > UET tag.

    If you're using the new Microsoft Advertising navigation, from the navigation menu on the left, hover over Conversions and select UET tag.

  3. In the table, find the UET tag that you want to use and in the far right column, select View tag.
  4. Copy the numerals that appear next to ID.
How can I fix the "UET tag can't send data to Microsoft Advertising" issue?expando image

Delete the current UET tag from the webpage, copy the UET tag from Microsoft Advertising, and then add it to the webpage again.

  1. Sign in to Microsoft Advertising.
  2. From the top menu, select Tools > UET tag.

    If you're using the new Microsoft Advertising navigation, from the navigation menu on the left, hover over Conversions and select UET tag.

  3. In the table, find the UET tag that you want to use and in the far right column, select View tag.
    UET tags page
  4. In the UET tag tracking code box, select Copy and then Done.
    Note: If your website doesn't support JavaScript, select the Non-JavaScript tab before you select Copy.
    UET tags page
  5. 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.
    UET tag
How can I fix the "There is no UET tag on this webpage" issue?expando image

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.

  1. Sign in to Microsoft Advertising.
  2. From the top menu, select Tools > UET tag.

    If you're using the new Microsoft Advertising navigation, from the navigation menu on the left, hover over Conversions and select UET tag.

  3. In the table, find the UET tag that you want to use and in the far right column, select View tag.
    UET tags page
  4. In the UET tag tracking code box, select Copy and then Done.
    Note: If your website doesn't support JavaScript, select the Non-JavaScript tab before you select Copy.
    UET tags page
  5. 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.
    UET tag
How can I fix the "The JavaScript and Non-JavaScript UET tag tracking code on this webpage have the same tag ID" issue?expando image

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.

How can I fix the “UET event is fired from within an iFrame” issue?expando image

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.

How can I fix the "Non-JavaScript UET tag tracking code on this webpage" issue?expando image

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.

How can I fix the "Multiple UET tags on this webpage use the same event name" issue?expando image

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>

What if the Microsoft Click ID (MSCLKID) is lost due to URL redirection?expando image
If server redirects are causing the Microsoft Click ID (MSCLKID) to be missing from your landing page’s URL, have your webmaster or developer edit your web server redirect configuration and confirm that the Microsoft Click ID (MSCLKID) parameter is being passing through to your landing page. Please note that the Microsoft Click ID (MSCLKID) helps to ensure conversions are accurately tracked and measured.

See more videos...