Documentation
Everything you need to run Lomen well
Installation, what each metric means, and how we count without cookies, written for developers who would rather read one page than watch a video.
Getting started
- Create your account
- Sign up with your email, then add the website you want to measure by its domain. You can track as many websites as you like during the beta.
- Install the snippet
- Lomen generates a single script tag with your domain already filled in. Paste it into your site's <head>, or anywhere in the HTML, and deploy. No API key, no package to install, no build step.
- First pageview
- Load any page on your site and refresh the dashboard. The first pageview normally appears within a few seconds. If nothing arrives, check that the script tag is present in the served HTML and not blocked by a content security policy.
What Lomen measures
- Pageviews and visitors
- A pageview is one reported page load. Unique visitors are derived without cookies from a short-lived, non-reversible grouping of the request, enough to count a visit, not enough to recognise a person later.
- Pages and sources
- Paths are normalised so one page is one row, and sources are grouped by hostname. Traffic that arrives with no referrer header is reported plainly as direct rather than attributed to a guess.
- Device, browser and system
- Device class (desktop, mobile or tablet), browser family and operating system family are derived from the user agent at collection time, and the user agent itself is then discarded. No versions, no fingerprinting signals, no device identifier.
- Country
- A two-letter country code resolved at the network edge before the request reaches us. We see the country, never the IP address it was resolved from. Cities are not collected.
- Campaigns
- If a link carries utm_source, utm_medium or utm_campaign, those three values are recorded so tagged campaigns can be told apart. Nothing else from the query string is read or stored.
Privacy and data
- No cookies, no IP storage
- The script sets no cookies. It keeps one random token in the visitor's browser storage so a returning visitor is not counted twice, and IP addresses are never written to our database. Nothing that identifies a person is stored.
- Your data is yours
- Every row is scoped to your account by row-level security. Deleting a site deletes its collected pageview history along with it.
The tracking snippet
<script defer
data-site-id="your-site-id"
src="https://lomenanalytics.com/api/public/track.js"></script>That is the entire integration. The script is deferred, so it never blocks rendering, and it makes one request per pageview, including pages your site renders without a reload. It sets no cookies and reads nothing from the page beyond the path, the referrer, which of four width bands the screen falls into, and the three utm_ parameters if the link carried any.