Tracking with UTT: JavaScript Functions

Published on: Mon, 21 Aug, 2023 at 2:31 AM | Updated on: Fri, 22 Mar, 2024 at 5:52 AM

`identify` function

The identify function is used to identify users accurately across your site, particularly across devices. Supply identifiers so impact.com can map users to conversion events for attribution. You can learn more about the identify function here.

<script type="text/javascript">               
ire('identify', {customerId: 'Customer Id', customerEmail: 'SHA1 Email Address', customProfileId: 'UUID'});
</script>

Note: The customerId, customerEmail , and customProfileId values should be dynamically populated on your site if a user is logged in, or left blank if they cannot be populated.

`generateClickId` function (Direct Tracking)

The generateClickId function can be used to obtain the impact.com clickId value whenever accessing the clickId value from the landing page URL’s query string parameters is not possible.

<script type="text/javascript">
ire('generateClickId', function(clickId) {   
    // use clickId here
});
</script>

Direct Tracking Example:

<script type="text/javascript">
ire('generateClickId', function(clickId {   
    var myClickId = clickId;   
    alert(myClickId);
});
</script>

`trackCart` function (Last to Cart crediting)

Last to Cart is similar to Last Click crediting in that one of the last steps a customer takes in the conversion path will determine which partner receives all the credit and payout for the conversion.

With Last to Cart crediting, the last time a customer adds an item to their cart will determine the winning partner. Implementing the trackCart function is required to support usage of the Last to Cart credit policy. See Last to Cart Credit Policy Explained for more details.

Add this function to the Add to Cart button.

<script type="text/javascript">
ire('trackCart', [event_id], {customProfileId: 'UUID'});
</script>

Conversion Pixel

Lead Tracker Example:

<script type="text/javascript">

ire('trackConversion', ACTIONTRACKERID, {           
          orderId: "Your Order Id here",
          customProfileId: "Your Custom Profile Id here",           
          customerId: "Your Customer Id here",           
          customerEmail: "Your Customer Email here",            
          customerStatus: "A Status here",            
          orderPromoCode: "Your Promo Code here"        
            },
{verifySiteDefinitionMatch:true});
</script>

Sale Tracker Example:

<script type="text/javascript">

ire('trackConversion', ACTIONTRACKERID, {           
          orderId: "Your Order Id here",     
          customProfileId: "Your Custom Profile Id here",        
          customerId: "Your Customer Id here",           
          customerEmail: "Your Customer Email here",            
          customerStatus: "A Status here",            
          orderPromoCode: "Your Promo Code here",            
          currencyCode: USD           
          items: [                  
                 {                                
                        subTotal: 100.00,                                
                        category: "Category here",                                
                        sku: "SKU here",                                
                        quantity: 2                   
                  },                
                  {                                  
                        subTotal: 50.00,                                 
                        category: "Category here",                                 
                        sku: "SKU here",                                 
                        quantity: 1                
                   }          
                ]
            },                   
{verifySiteDefinitionMatch:true});
</script>

Note: The Event Type ID must be your tracker-specific ID found under Tracking Settings → Event Types. The parameters should be dynamically populated with values from the conversion.

identify function

generateClickId function (Direct Tracking)