Find out if my tag is working with UET Tag Helper

Find out if my tag is working with UET Tag Helper

UET Tag Helper is a Chrome Extension that automatically validates the implementation of the Bing Ads UET tag on any given webpage.

UET Tag Helper is a Chrome Extension that validates the implementation of the Bing Ads Universal Event Tracking (UET) tag on any given webpage. To learn about UET tag, see What is UET and how can it help me?.

UET Tag Helper allows you to:

  • Validate UET tags in real time. You can validate UET tags right in the browser instead of checking the tag status in Bing Ads UI after a few hours.
  • Quickly know if you implemented the UET tag correctly or not. Before there was no easy way for you to confirm if you successfully implemented the tag on a specific webpage, but now the UET Tag Helper icon tells you how many UET tags you have on a webpage and if they are working or not.
  • Troubleshoot what went wrong with the UET tag. If your tags are not working, the UET Tag Helper tells you what the issue is and what you can do to fix it.

Set up UET Tag Helper

You download and install the UET Tag Helper in the Chrome browser.
  1. In the Chrome Web Store, search for UET Tag Helper.
  2. Click 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

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 Chrome, go to a webpage that you want to check, and then click the UET Tag Helper icon.
  2. In UET Tag Helper, flip the toggle On, and then in Chrome, click Reload this page button Reload this page.
  3. Review the UET Tag Helper icon status. The number shows how many times there was a UET tag request from the webpage and the color shows the status.
    No badge UET 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 badge UET Tag Helper icon showing number of valid tags
    There are tags on this webpage and they are working correctly. No action required.
    Yellow badge UET Tag Helper icon showing number of tags with issues
    The tags on this webpage are working correctly but can be improved. Click the UET Tag Helper icon to see what the issue is and how you can resolve it.
    Red badge UET Tag Helper icon showing number of tags that are not valid
    The tags on this webpage are not working correctly and need to be fixed. Click 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. Click 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.

UET Tag Helper FAQ

Is the UET Tag Helper available on other browsers?expando image

Not at this time. The UET Tag Helper is only available in the Chrome browser. We will consider expanding to the Edge browser after the release of their extension store.

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 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 Chrome 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 click 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, Bing Ads 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 Bing Ads, 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. Click the Campaigns tab, and then on the left pane, click Conversion Tracking.
    Conversion tracking in the Left pane
  2. Under Conversion Tracking, click Conversion goals.
    Conversion goals in the Left pane
  3. Review the Tracking status column.

    Unverifiedexpando image

    What it is: Bing Ads hasn’t received any user activity data from the UET tag on your website. It can take up to 24 hours for Bing Ads 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: Bing Ads 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: Bing Ads has seen your UET tag and has recorded conversions within the last 7 days.

    What to do: Nothing

    Tag inactiveexpando image

    What it is: Bing Ads 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

  4. If the status is Tag inactive, go the destination URL associated with the conversion goals in Chrome, 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 click on your ads, you can validate your conversion goal. First in Bing Ads, 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. Click the Campaigns tab, and then on the left pane, click Conversion Tracking.
    Conversion tracking in the Left pane
  2. Under Conversion Tracking, click Conversion goals.
    Conversion goals in the Left pane
  3. Review the Tracking status column.

    Unverifiedexpando image

    What it is: Bing Ads hasn’t received any user activity data from the UET tag on your website. It can take up to 24 hours for Bing Ads 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: Bing Ads 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: Bing Ads has seen your UET tag and has recorded conversions within the last 7 days.

    What to do: Nothing

    Tag inactiveexpando image

    What it is: Bing Ads 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

  4. If the status is Tag inactive, in Chrome, 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 click on your ads, you can validate your conversion goal. First in Bing Ads, 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. Click the Campaigns tab, and then on the left pane, click Conversion Tracking.
    Conversion tracking in the Left pane
  2. Under Conversion Tracking, click Conversion goals.
    Conversion goals in the Left pane
  3. Review the Tracking status column.

    Unverifiedexpando image

    What it is: Bing Ads hasn’t received any user activity data from the UET tag on your website. It can take up to 24 hours for Bing Ads 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: Bing Ads 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: Bing Ads has seen your UET tag and has recorded conversions within the last 7 days.

    What to do: Nothing

    Tag inactiveexpando image

    What it is: Bing Ads 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

  4. If the status is Tag inactive, in Chrome, 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 is not blank. If the revenue is missing, you need to add the revenue code to your website. If the gv value is blank, there is something wrong with your revenue function. For more information, see How to report 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 Chrome, 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 or on the master page, 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 Bing Ads, and then add it to the webpage again.

  1. Sign in to Bing Ads.
  2. Click the Campaigns tab, and then on the left pane, click Conversion Tracking.
    Conversion tracking menu
  3. Under Conversion Tracking, click UET tags.
    UET tags page
  4. In the table, find the UET tag that you want to use and in the far right column, click View tag.
    UET tags page
  5. In the UET tag tracking code box, click Copy and then Done.
    Note: If your website doesn't support JavaScript, click the Non-JavaScript tab before you click Copy.
    UET tags page
  6. Paste the UET tag tracking code on every page of your website or on the master page, 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 report custom events with UET.

How can I fix the "UET tag can’t send data to Bing Ads" issue?expando image

Delete the current UET tag from the webpage, copy the UET tag from Bing Ads, and then add it to the webpage again

  1. Sign in to Bing Ads.
  2. Click the Campaigns tab, and then on the left pane, click Conversion Tracking.
    Conversion tracking menu
  3. Under Conversion Tracking, click UET tags.
    UET tags page
  4. In the table, find the UET tag that you want to use and in the far right column, click View tag.
    UET tags page
  5. In the UET tag tracking code box, click Copy and then Done.
    Note: If your website doesn't support JavaScript, click the Non-JavaScript tab before you click Copy.
    UET tags page
  6. Paste the UET tag tracking code on every page of your website or on the master page, 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 Bing Ads 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 Bing Ads.
  2. Click the Campaigns tab, and then on the left pane, click Conversion Tracking.
    Conversion tracking menu
  3. Under Conversion Tracking, click UET tags.
    UET tags page
  4. In the table, find the UET tag that you want to use and in the far right column, click View tag.
    UET tags page
  5. In the UET tag tracking code box, click Copy and then Done.
    Note: If your website doesn't support JavaScript, click the Non-JavaScript tab before you click Copy.
    UET tags page
  6. Paste the UET tag tracking code on every page of your website or on the master page, 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 JavaScript vs. Non-JavaScript UET tag tracking code.

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

We recommend you use the JavaScript tracking code instead. It allows you to create custom events and track variable revenue. To learn about the difference between the two different UET tag tracking codes, see JavaScript vs. Non-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. Bing Ads 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({ 'gv': 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({ 'gv': Revenue}); // Pass the computed revenue </script>

See more videos...