Skip to main content
This guide covers the minimum steps to go from a Scanova account to live event tracking. For deeper configuration, follow the links at each step.

​
Step 1: Create a tracking site

A tracking site represents one website domain. You need one before you can install the SDK or send server events.
  1. Log in to the Scanova dashboard
  2. Go to Integrations → Conversion Tracking
  3. Click Create Site
  4. Enter a site name and add your allowed domains (e.g. yoursite.com)
  5. Save
After saving, Scanova generates a unique site_id for this site. You will use this in the snippet and in all API calls.
Add all hostnames where your tracking snippet will run — including www and non-www variants, and any staging domains you want to test on.

​
Step 2: Install the Browser SDK

  1. Open the site you just created and go to the Embed tab
  2. Configure the toggles (auto page view, auto clicks, etc.)
  3. Copy the generated snippet
  4. Paste it before </head> in your site’s HTML template
<head>
  <!-- other tags -->
  <script>
  (function(w,d,s,o,f,js,fjs){
    w['ScanovaTrackingObject']=o;w[o]=w[o]||function(){(w[o].q=w[o].q||[]).push(arguments)};
    js=d.createElement(s),fjs=d.getElementsByTagName(s)[0];
    js.id=o;js.src=f;js.async=1;fjs.parentNode.insertBefore(js,fjs);
  })(window,document,'script','scanova','https://cdn.scanova.io/ct/js/qcg.min.js');

  scanova('init', 'YOUR_SITE_ID', {
    autoPageview: true,
    autoClicks: true,
    autoForms: true,
    autoScroll: true
  });
  </script>
</head>
Using Google Tag Manager? See Install via GTM. For events to be attributed to a specific QR Code, that QR Code’s destination domain must match one of your tracking site’s Allowed Domains.
  1. Open a QR Code in the Scanova dashboard
  2. Go to its Settings or Redirect configuration
  3. Confirm the destination URL is on a domain you added in Step 1 (e.g. yoursite.com)
If the QR Code redirects to a domain that is not in the tracking site’s Allowed Domains, browser events from that domain will be rejected with 403. Attribution only works when the destination domain matches.

​
Step 4: Verify the SDK is working

  1. Open your website in a browser
  2. Open DevTools → Network tab
  3. Filter by /ct
  4. Reload the page — you should see a POST request to https://t.scanova.io/ct with a 200 response
If you see the request, the SDK is working. If not, see Browser SDK Troubleshooting.

​
Step 5: (Optional) Send server-side conversions

For purchase confirmations, sign-ups, or other backend events, generate an API key and send events from your server.
  1. Open the same tracking site → API Keys tab
  2. Click Generate API Key, give it a name, copy and store it securely
  3. Send a POST request to https://track.scanova.io/server-events:
curl -X POST "https://track.scanova.io/server-events" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "site_id": "YOUR_SITE_ID",
    "event_name": "purchase",
    "scan_session_id": "SCAN_SESSION_ID_FROM_BROWSER",
    "conversion_value": { "amount": 49.99, "currency": "USD" }
  }'
Never expose your X-API-Key in browser-side code. It is for server use only.
Full guide: Send Server Events

​
Step 6: View your data

Open Integrations → Conversion Tracking in the dashboard, select your site, and open the Analytics tab. You should see your first events appear within 30–60 seconds of verifying the SDK in Step 3.

​
Where to go next

Browser SDK Configuration

Learn all SDK options — auto-tracking toggles, debug mode, and more.

Custom Events

Track specific user actions like button clicks and form completions.

Server-Side Events

Send secure backend conversions with attribution.

SPA & Framework Guide

React, Next.js, and Vue-specific setup instructions.