Skip to content

Website analytics ​

Website analytics shows what visitors do on your public pages, such as your landing page, blog and docs. They do not need to be signed in. You see where they come from, which pages they read, how long they stay, what they click, and which sources lead to signups.

It uses the same script tag as the rest of JustOneCX. There is no extra code.

It is separate from product analytics, which counts signed-in people. Website visitors never count toward your monthly active users.

Turn it on ​

  1. Add the SDK to your site (script tag or npm).
  2. Open Analytics → Website → Settings and switch on Track visits to my website. New workspaces have it on. Existing workspaces start with it off.
  3. Open your site. Visits show up within a minute. The Check connection button on the empty page reads the live visitor count.

To keep it off on one page, call init({ webAnalytics: false }) there (script tag: data-web-analytics="false").

Several subdomains ​

By default each site keeps its own visitor id, so example.com and docs.example.com look like two visitors. Add your parent domain and they count as one:

html
<script
  src="https://app.justonecx.com/sdk/justonecx-sdk.global.js"
  data-public-key="pk_your_workspace_key"
  data-api-url="https://api.justonecx.com"
  data-cookie-domain=".example.com"
></script>

With npm, pass cookieDomain: ".example.com" to init(). This stores the visitor id in a first-party cookie on that domain (jcx_vid, up to 400 days). If you need consent before cookies, wait for consent before you call init().

What is tracked ​

WhatWhenDetails
Page viewThe page loads, and on every client-side page changePath (no query string, except utm_*), title, site, referrer, screen width
Page leaveThe visitor leaves the page or switches tabActive seconds and how far they scrolled (0 to 100)
ClickA click on a link, a button, [role="button"] or an element with data-jcx-trackThe first 80 characters of its label, the link, the page
Outbound linkA click on a link to another siteThe link, the page

Time on page counts only while the tab is visible and the visitor used the mouse, keyboard, scroll or touch in the last 30 seconds.

Mark any element you want a stable name for:

html
<a href="/signup" data-jcx-track="hero-signup">Start free</a>

Its clicks then show up as hero-signup in Clicks, whatever the button text says.

What is never tracked ​

  • Input values and anything typed in a form. Clicks on input, textarea, select and editable elements are ignored.

  • Anything inside an element with data-jcx-private. Add that attribute to hide an area:

    html
    <div data-jcx-private>…</div>
  • The IP address. It is read to find the country, then dropped. Only the two-letter country is kept.

  • Bots, crawlers and link previews are ignored.

Raw website data is kept for 12 months. IP geolocation by DB-IP.

How it is counted ​

  • Visitors are different browsers. One person on a phone and a laptop counts twice, and one browser after clearing storage counts again.
  • A visit ends after 30 minutes without activity. It also ends when the campaign source (utm_source) changes.
  • Bounce rate is visits with one page view and less than 10 seconds of active time.
  • Visit time is the average active time per visit.
  • Every number shows the change against the equally long period before.

Traffic channels ​

Each visit gets one channel, first match wins:

  1. Paid search: utm_medium is cpc, ppc, paid or paidsearch, from a search engine.
  2. Paid social: utm_medium is paid_social, or cpc from a social site.
  3. Email: utm_medium=email, or a source that contains newsletter or mail.
  4. AI assistants: ChatGPT, Perplexity, Claude, Gemini, Copilot, You.com, Phind.
  5. Organic search: Google, Bing, DuckDuckGo, Yahoo, Yandex, Baidu, Ecosia, Brave.
  6. Social: Facebook, Instagram, X, LinkedIn, Reddit, Hacker News, YouTube, TikTok, Product Hunt, Threads, Bluesky, Indie Hackers, Medium, DEV.
  7. Referral: any other source or outside referrer.
  8. Internal: a link from one of your own sites. List them under My site hostnames in Settings.
  9. Direct: no referrer and no utm_*.

Goals and first touch ​

Pick the events that matter, such as signup_completed, under Goals in Settings. The Goals panel shows how many different visitors did each one, and the rate against all visitors.

Choose a goal in the Sources or Pages panel to add a Conversions column. It credits the visitor's first visit in the period (first touch): their first channel, source or entry page. A visitor who came from a newsletter and later from search counts for the newsletter.

Funnels by source ​

Open a funnel and use Break down by: channel, UTM source, referrer, country, device or entry page. Each person is placed by their first website visit. $pageview is a funnel step, and a filter such as path contains /pricing means "visited the pricing page".

Sections: Blog and Docs ​

Under Sections in Settings, save views such as Blog (example.com, path starts with /blog) or Docs (docs.example.com). Pick one from the section menu and the Content table shows every page with visitors, average time, read-through (the share of page views that scrolled to 75%), visits that started there and conversions.

Exclude your own visits ​

In Settings → Exclude my own visits, open the link for each site in the browser you want to ignore (https://example.com/?jcx_ignore=1). That browser then sends nothing. Open ?jcx_ignore=0 to turn it back on.

Limits ​

  • A busy site is limited to 600 requests a minute per visitor address and 60,000 a minute for the whole workspace.
  • Ad blockers can stop some visits from arriving. Numbers are a close count, not an exact one.
  • Clicks and search terms do not follow the source and device filters, because they are not tied to a visit.

JustOneCX