Install the tracking script

Trace collects data with a single script tag. Once it's on your pages, pageviews, sessions, outbound links, file downloads and form submissions are recorded with no further code.

1. Add your siteCopy Anchor Link

Sign up at https://data.whos1.bid/signup, then add a website from the dashboard with its Domain (for example example.com), a Name and a Timezone. Adding sites is available to workspace owners and admins.

2. Paste the snippet into the head of every pageCopy Anchor Link

Copy your site's snippet from Settings → General. It looks like this:

<script
  defer
  data-website-id="YOUR_WEBSITE_ID"
  data-domain="example.com"
  src="https://data.whos1.bid/script.js"
></script>

Put it inside the <head> of every page. In a framework, add it once to the root layout — for example Next.js app/layout.tsx or the index.html of a Vite or React app.

Both data-website-id and data-domain are required. The script sends nothing if either is missing. Events are only accepted from your site's domain (and its subdomains) and any additional domains you allow in Settings → General.

3. Check it's workingCopy Anchor Link

• Open your site in another tab. The green online counter in the dashboard header should go up within a few seconds.
• Use Verify installation in Settings → General (a banner offering the same check also appears on the dashboard while the site has no visitors). Trace loads your live site at https://example.com (then https://www.example.com), checks that the script is on the page and running, and sends a test event. The test isn't counted as a visitor.
• Add data-debug="true" to the script tag to have the script log what it does (and why an event was rejected) in the browser console.

If verification fails, the banner tells you why and offers Check again and Try another URL:

Local development is ignoredCopy Anchor Link

Tracking is off on localhost, 127.0.0.1, *.local and *.localhost hostnames, and on pages opened from file://, so your own testing never pollutes real data. To test the install locally, add:

<script
  defer
  data-website-id="YOUR_WEBSITE_ID"
  data-domain="example.com"
  data-allow-localhost="true"
  src="https://data.whos1.bid/script.js"
></script>

Use data-allow-file-protocol="true" for pages opened from file://.

Calling Trace before the script loadsCopy Anchor Link

The script is loaded with defer, so code that runs earlier can't call it yet. Add this stub before your own code and any calls are queued, then sent once the script is ready:

<script>
  window.datafast = window.datafast || function () {
    (window.datafast.q = window.datafast.q || []).push(arguments);
  };
</script>

Excluding your own visitsCopy Anchor Link

To stop recording visits from your own browser, open the browser console on your site and run:

localStorage.setItem("df_ignore", "true");

Events from that browser are then ignored on that site. Remove the item to be tracked again. To exclude whole IP addresses or countries for everyone, use Settings → Exclusions.

Good to knowCopy Anchor Link

• The script does nothing inside an iframe, so a page embedded in another page doesn't double-count.
• The same URL viewed again within one minute in the same tab isn't counted as a second pageview.
• Headless and automated browsers (WebDriver, Puppeteer, Playwright and similar) are ignored by the script before anything is sent.

Next stepsCopy Anchor Link