The Fresh Relevance tracking script must be added to all pages of your website or app to enable Fresh Relevance to track user activity and provide the JavaScript API for your use.

Simply add the following script tag to all pages of your website or app in either the head or body elements. The URL to the tracking script is personalized and therefore you must include your custom domain and account ID in the URL for the account you are recording data for.

<script async src="//Your loader script domain/Your account ID.js">

You need to replace:

• Your loader script domain with the correct domain. To find this, in Fresh Relevance, expand the User menu, then go to Settings > System configuration > Custom domains and copy the Loader Script Domain value.
• Your account ID with your account ID. To find your account ID in Fresh Relevance, expand the User menu and copy the Account ID value.

---

Script deployment options

The tracking script can be added to pages by modifying the source, typically the header or footer template that generates the pages. This is the method we advise you to use, as some browsers can block scripts deployed through tag managers.

If necessary however, you can use a tag manager to deploy the script to your site.

Instructions differ for the various tag managers you could choose, but as an example here are the details for:

• Google Tag Manager
• Tealium Tag Manager
• Adobe Tag Manager

JavaScript frameworks

The tracking script doesn't require a JavaScript framework and works on any reasonably modern browser. However, if we’re customizing the script to collect data from your website, this is easier if we can use a JavaScript framework.

🚧

Depending on your site and the amount of data we need to capture, there may be additional charges if we cannot use a framework for the data capture.

Supported JavaScript frameworks are:

• jQuery
• Prototype
• MooTools

If you don't already have one of these frameworks on your site, it's easy to install jQuery . You should choose a CDN-hosted version, as it's usually already in the browser cache increasing page load performance.

Learn more in this third-party jQuery guidance article .

📘

Single page applications

If your website is built as a Single-page application, you can ask your site developers to add some JavaScript API calls to inform Fresh Relevance of important events and updates using our the JavaScript API.

---

Site performance

We’re very conscious of the importance of performance and have optimized our script to reflect this. The script has been minified, meaning it’s stripped of all unnecessary characters, such as spaces, to decrease the size, and is served from a content delivery network (CDN) for maximum speed.

The script also uses both the async and defer attributes, which means it isn’t loaded until after the page has finished rendering. This is so it doesn’t block the loading of any other elements and so shouldn’t affect the speed at which the rest of the page is displayed.

---

Underlying technology

Our script scrapes data from your site pages using JavaScript, either to extract it from existing JavaScript variables or objects, or by extracting information from the markup on the page. This is then reported back to Fresh Relevance using WebSockets.

A hidden iframe is used for those browsers that don’t support WebSockets.

All information is transmitted over the same protocol - for example, http or https - as the page the customer is on.

The script also inserts your chosen SmartBlocks and personalization into your site if you are using Client-side Personalization.