Skip to content
usertraxusertraxDocumentation

Quick Start Guide

This guide takes you from the dashboard to your first conversion. Work through it end to end, or jump to the section you need.

At a glance

Section titled “At a glance”

Domain & API key

Create a domain in the dashboard and copy the key for your tracking script.

One-line script

Drop cvs.js into your <head> — lightweight, no cookies.

Track conversions

Use the JavaScript API or data attributes on buttons and links.

Cookie-free

No cookie banner required — attribution via click IDs and context.

1. Create a domain and install the script

Section titled “1. Create a domain and install the script”

  1. Sign in to the dashboard

    Open the usertrax dashboard and sign in.

  2. Create a domain

    Go to Domains, create a new domain, and copy your API key.

  3. Install the script

    Add this line to your site’s <head> (replace the key):

    <script
      src="https://usertrax.io/cvs.js"
      data-key="YOUR_API_KEY"
      defer
    ></script>

    The script is ~5kb gzipped and sets no cookies — GDPR/CCPA-friendly by default.

2. Track your first conversion

Section titled “2. Track your first conversion”

Method 1: JavaScript API

Section titled “Method 1: JavaScript API”
window.usertrax = window.usertrax || [];
window.usertrax.push({
  event: "purchase",
  total: 99.99,
  currency: "EUR",
  // Optional: order ID for deduplication
  id: "ORDER-123",
});

Method 2: Data attributes

Section titled “Method 2: Data attributes”
<!-- Track button click -->
<button
  data-usertrax="purchase"
  data-usertrax-total="99.99"
  data-usertrax-currency="EUR"
  data-usertrax-id="ORDER-123"
>
  Buy now
</button>


<!-- Track link click -->
<a
  href="/checkout"
  data-usertrax="checkout_start"
  data-usertrax-total="99.99"
  data-usertrax-currency="EUR"
>
  Checkout
</a>

3. Verify the conversion

Section titled “3. Verify the conversion”

  1. Fire the event – Click the purchase button or run the API call on your thank-you page / in the console.

  2. Check the dashboard – The conversion should appear in the event explorer / conversion list.

  3. If nothing shows up – Is the script loaded? Correct API key? Hard-refresh / clear cache and try again.

4. Optional: good next moves

Section titled “4. Optional: good next moves”

What is captured automatically?

Section titled “What is captured automatically?”
  • Click IDs (gclid, msclkid, …) from URL parameters
  • Source URL and referrer
  • Timestamp
  • Conversion value (when you send total / currency)

Next steps

Section titled “Next steps”
Conversion TrackingEvents, sessions, identify, and configuration.
Proxy guidesFirst-party delivery for common servers and frameworks.
Google Ads exportSend conversions to Google Ads.
Microsoft Ads exportSend conversions to Microsoft Advertising.
A/B TestingExperiments with real conversion metrics.
Website integrationDeeper HTML install guide.