Getting Started
Installing Usermaven

Installing Usermaven

To integrate your website or SaaS app with Usermaven, you'll need to add a simple tracking script into the Header (<head></head>) section of your website. Make sure this snippet is present on every page that you want to track.

An example of a tracking script is shown below which you can use after replacing the data-key="YOUR_KEY" attribute with the one available in your workspace.

<script type="text/javascript">
 <script src="" 
<script>window.usermaven = window.usermaven || (function(){(window.usermavenQ = window.usermavenQ || []).push(arguments);})</script>

Finding your tracking script

After creating your account and workspace, you'll be taken to a page where your tracking script will be present. Just copy it and add it to your website's header.

If you have created a second workspace, you'll be shown a setup page where you can find the tracking script as shown below.

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

Installation methods


What is cookieless tracking and how to enable it?

Cookieless 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 cookieless 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 gives you the ability to automatically track all interactions 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.