Skip to main content
Zenovay
Free5 minutesBeginner

How do I install the tracking script on my website?

A 5-step checklist to add Zenovay to any website — get your tracking code, paste the script tag, deploy, verify, and confirm events are flowing.

installquickstartscriptchecklistfirst-time
Last updated:

The Zenovay tracker is a single <script> tag. Adding it to any website is a 5-step process.

The 5 steps

  1. Get your tracking code

    Sign in to app.zenovay.com, open the website you want to track, and go to Settings → Tracking Code. Copy the value — it looks like zv_abc123xyz.

  2. Paste the script tag in your site's HTML head

    The default install is a single tag in the <head> section of every page:

    <script
  defer
  src="https://api.zenovay.com/z.js"
  data-tracking-code="YOUR_TRACKING_CODE"
></script>

    Replace YOUR_TRACKING_CODE with the value from step 1.

  3. Deploy the change

    The exact deploy step depends on your platform — push the commit, hit Save in your CMS, or republish your no-code site. Wait until the change is live on your real domain (not just on staging).

  4. Visit your site and watch the Live tab

    Open your site in an incognito window. Within 30 seconds, your visit should appear in the Live tab of your Zenovay dashboard with the correct location.

  5. If nothing shows up — diagnose

    If your visit didn't appear after 60 seconds, check the install with first event not appearing. The most common causes are: tracking code mismatch, ad blocker on the test browser, or testing on localhost.

Platform-specific guides

Pick the page that matches your stack:

PlatformGuide
WebflowInstall on Webflow
WordPressWordPress integration
ShopifyShopify integration
Next.jsNext.js integration
React (Create React App, Vite, etc.)React integration
VueVue integration
Google Tag ManagerInstall via GTM
Anything elseCustom framework

Where the script tag should go

The script tag goes in the <head> of every page you want to track. The exact location varies by platform:

  • Hand-coded HTML — directly inside <head>, just before </head>
  • WordPress — theme's header.php or via wp_head action
  • Shopify — theme.liquid, just before </head>
  • Next.js — <Script> in your root layout, with strategy="afterInteractive"
  • Webflow — Site settings → Custom code → Head code
  • GTM — Custom HTML tag with All Pages trigger

What the defer attribute does

defer tells the browser: "Load this script while parsing the page, but don't execute it until the page is parsed." This means the tracker doesn't slow down your page render at all — Lighthouse scores stay clean.

What's NOT required

You don't need to:

  • Install an npm package (unless you're using a bundler — see npm installation)
  • Add a cookie banner just for Zenovay (cookieless mode is the default — see do I need a cookie banner)
  • Configure a privacy policy entry (recommended, but the tracker works without one)
  • Whitelist anything in your CSP unless you have a strict CSP — in which case allow https://api.zenovay.com in script-src and connect-src

Related articles

Installing the Tracking Script

Learn how to add the Zenovay tracking script to your website using various methods including HTML, npm, and CMS integrations.

How long does it take for events to show up?

Real-time views (Live tab, globe) update in under 5 seconds. Pre-aggregated reports refresh on a 1-2 minute cycle. Here's the full timing breakdown.

Free Tier Limitations

Understand what's included in Zenovay's Free plan and its limitations to help you decide when to upgrade. Learn about free in this getting started guide.

Was this article helpful?