Skip to Content
Getting StartedInstalling Usermaven

Installing Usermaven

To integrate your website or SaaS app with Usermaven, you’ll need to incorporate a tracking script into the Header (<head></head>) section of your website. Ensure that this snippet is included on every page you wish to track.

Here’s an example of a tracking script that you can utilize, but be sure to substitute the data-key="YOUR_KEY" attribute with the one provided in your workspace.

<script type="text/javascript">
    (function () {
        window.usermaven = window.usermaven || (function () { (window.usermavenQ = window.usermavenQ || []).push(arguments); })
        var t = document.createElement('script'),
            s = document.getElementsByTagName('script')[0];
        t.defer = true;
        t.id = 'um-tracker';
        t.setAttribute('data-tracking-host', "https://events.usermaven.com")
        t.setAttribute('data-key', 'YOUR_KEY');
        t.setAttribute('data-autocapture', 'true');
        t.setAttribute('data-randomize-url','true');
        t.src = 'https://t.usermaven.com/lib.js';
        s.parentNode.insertBefore(t, s);
    })();
</script>

Finding your tracking script

Upon successfully creating your account and workspace, you’ll be directed to a page where your tracking script will be readily available. Simply copy the provided script and insert it into the header section of your website.

In the event that you have created a second workspace, you’ll be shown a setup page displaying the tracking script as shown below.

At any time after the initial installation, you can find the tracking script in Workspace Settings > Setup menu.

Cookie-less tracking (also known as anonymized tracking) is a way to capture information about visits to your page without needing to store user-identifiable data in a privacy-friendly manner.

If you want to enable cookie-less tracking, make sure that the data-privacy-policy="strict" attribute is present in the tracking script.

What is autocapture and how to enable it?

Autocapture empowers you to effortlessly track all interactions that users or customers have with your website or app across every visit. There’s no need to rely on manual tracking for capturing page views, button clicks, link clicks and form submissions, etc…

Although, Usermaven supports both autocapture and manual tracking of events. We recommend using autocapture from the moment of installation to gather all the important events without needing assistance from a developer.

If you want to enable autocapturing of events, make sure that the data-autocapture="true" attribute is present in the tracking script.

What is Pixel white-labeling and how to enable it?

Most of the analytics tools like Google Analytics, Mixpanel, and others are blocked by ad-blockers which results in incomplete or inaccurate stats. Usermaven allows you to white-label the tracking pixel URL with a custom domain option.

Here’s a complete guide on how to connect your custom domain and enable pixel white-labeling.

We recommend that all customers should enable white-labeling to avoid losing traffic stats from visitors who use ad-blockers.

If you installed the Usermaven tracking script on your website before enabling pixel white-labeling, you’ll have to replace the code after connecting a custom domain and enabling white-labeling.

Last updated on
Event tracking setupPixel white-labeling with a custom domain