Integration

Introduction

In order to integrate UseItBetter, the JavaScript tracking code needs to be added to all pages you want to track. The tracking code can be added directly to the website’s code, or can be added using a tag manager. In most cases, in just a few minutes you will be able to:

  • track and measure all user interactions with your website
  • aggregate, visualize and analyse tracked data using all available reports,
  • use Triggers to track more data, implement A/B tests, personalise user experience or survey users.

The Tracking Code

The tracking code consists of:

  • a short snippet with unique project settings and customizable parameters,
  • a link to udash.min.js, a JavaScript file with the actual code responsible for tracking,
  • a link to an optional uResponses.min.js JavaScript file with the essential Responses for use with Triggers.

The tracking code is project specific and you can get it after you create an account and set up a project.

Sign up for an Account

To sign up for an account visit https://app.useitbetter.com/#/new-account and complete the registration.

Create a Project

In most cases, you will have to create a separate project for each website you want to track. However, it is possible to track multiple websites into the same project or, track certain pages on your site into separate projects.

If you are not sure if certain pages should be tracked to the same or separate projects, ask yourself these questions:

  • are your visitors likely to visit those pages within the same visit?
  • are you going to often analyze those pages in relation to each other?
  • is the code base of those pages the same?

if the answers are no, choose separate projects.

Get the Tracking Code

Once you create a project you will be asked to invite users to the project and set up the project settings. You will then be provided with your project specific tracking code.

The tracking code is available in two versions: for in-page placement and for use with tag managers. The only difference between the two versions is that the version for tag managers uses a single script (tag) which dynamically adds necessary scripts to the page.

If you need to get the tracking code again, open the navigation in the top right corner and click Get Tracking Code.

Continue reading the article for more instructions related to integration.

Implement the Tracking Code

You will need to either add the tracking code directly in the code of your pages (in-page placement), or load it through a tag manager.

If you are planning to use UseItBetter Triggers to deliver A/B testing, for personalization or for applying other changes to your website you should avoid using a tag manager and add the tracking code directly in the head tag of your pages in order to maximize the speed of loading the code. Since the code is loaded asynchronously, there is no risk that it will block loading of your pages even if, for some reason, the tracking script would not load.

If you do not intend to use Triggers you may safely remove the line responsible for loading of the uResponses.min.js.

Choose Pages to Track

You can add the tracking code either to the entire website or just selected pages. If you are planning to analyze only the transactional part of your website (registration forms, checkout on e-commerce site, credit application or insurance quotes) then make sure that you follow these guidelines for Form Analytics.

It is highly recommended that you add the tracking code to all error pages presented as a result of errors related to missing content (404), server side errors (5xx), and to custom error pages like “expired session”. If you are planning to add tracking code using a tag manager, double check that the tag manager is present on those pages, since this is often not the case.

Customize the Tracking Code Settings

You can control what data is being tracked and how by changing the tracking code settings. Even though the base tracking code is the same for all the pages you want to track into the same project, the settings can be different for each of the pages.

For the list of supported settings see “Tracking Code Settings”.

Test the Integration

Before you deploy the tracking code to production, make sure you understand how data is being tracked to avoid collection of sensitive information.

Once you add the tracking code, you should check if the tracking code is correctly added. Read “Testing Integration” for details about how to review what data is being tracked and for troubleshooting tips.

Set the Sampling

If your website has high traffic, you may want to track just a portion of your visits, for example 20% instead of 100% of visits, to reduce the cost of the service. The sampling settings are set per project.

Exclude IP Numbers from Tracking

To avoid polluting the data about real users with visits from your office or services that continuously test and monitor your website you may specify a list of IP numbers for which the tracking requests will be ignored.

Ask a Question

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>