Microsoft Universal Event Tracking (UET) – Installation

Overview

As of release 2023.12 (v4.8.0), Microsoft Universal Event Tracking (UET) and conversions are now supported in core product.

This article will cover how you can install Microsoft UET on your site, and any notables around this integration.

Create UET Tag

Full instructions on Microsoft’s website:

From the top menu of your Microsoft Advertising account, select Tools > UET tag.
Select Create UET tag and then enter a name.
Optionally, enter a description.
Optionally, clear the Enable Microsoft Clarity checkbox.
Select Save.
In the View UET tag tracking code box, copy the tag ID
1. This is the bold value below in the code snippet after the URL for ti:
  1. //bat.bing.com/action/0?ti=TAG_ID&Ver=2

Enter the UET Tag to Your CIMcloud Website

Login to your CIMcloud Worker Portal
Navigate to Customer Sites, then select “Edit” on the site/domain you would like to track
Click on the Analytics tab
Click “Yes”, under “Use Microsoft UET Tracking?”
Enter your UET Tag ID
Click Submit

Global Script Automatically Added

The following script is automatically included on all pages, where TAG_ID_HERE will be replaced with the value entered above:

<script> 
(function(w,d,t,r,u) {
    var f,n,i;w[u]=w[u]||[], f=function(){
        var o={ti:"TAG_ID_HERE", enableAutoSpaTracking: true};
        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","uetq"); 
</script>
<noscript>
    <img src="//bat.bing.com/action/0?ti=<%=TAG_ID_HERE%>&Ver=2" height="1" width="1" style="display:none;"/>
</noscript>

Purchase Event Automatically Tracked

When a customer places an order on your site, you should now see purchase data sent to your Microsoft UET account within the next 48 hours.

Please enter a ticket to Extranet to track other events, or to modify the purchase event.

The following format is used to send purchase events:

<script>	
	window.uetq = window.uetq || [];
	window.uetq.push('event', 'purchase', { 
		'transaction_id': 'TRANSACTION_ID',
		'ecomm_prodid': ['PRODUCT_ID', 'PRODUCT_ID', …], 
		'ecomm_pagetype': 'purchase',
		'ecomm_totalvalue': ORDER_TOTAL,
		'revenue_value': ORDER_TOTAL,
		'currency': 'CURRENCY',
		'items': [ 
		    { 
		      'id': 'PRODUCTID', 
		      'quantity': QUANTITY, 
		      'price': SELLING_PRICE 
		    }, 
		    { 
		      'id': 'PRODUCT_ID', 
		      'quantity': QUANTITY, 
		      'price': SELLING_PRICE 
		    } 
		  ] 
		}
	);
</script>

References

Was this article helpful

Yes No