Documentation

Guides for installing the tracker, reading the dashboard, and using the API.

Tracker

One dependency-free script collects pageviews, SPA navigations, custom events, scroll depth, reading-time evidence, and Core Web Vitals. It sets no cookies and does not write localStorage or sessionStorage.

Tokenless host install

Register the hostname, then load the shared script. Traffic from that registered origin reports to the host site, including child paths:

<script defer src="https://antics-api.turtletech.us/antics.js"></script>

A parent host such as example.com does not claim subdomain traffic. Register docs.example.com separately when that host needs its own dashboard.

data-token path install

Path-scoped sites such as example.github.io/project need data-token. Copy the snippet from Settings; the token routes events into that path site after the collector checks both the token and the page URL.

<script defer src="https://antics-api.turtletech.us/antics.js" data-token="TRACKER_TOKEN"></script>

Tokenless traffic on the same host still reports to the host site. That keeps aggregate host stats intact while a few child paths have their own dashboards. You can also bind a host install to a token when you want a revocable, site-pinned snippet.

SPA navigation

The tracker intercepts history.pushState and history.replaceState and sends a new pageview for each client-side transition. That covers React Router, Vue Router, SvelteKit, Astro, and other History API routers without an extra hook.

Custom events

Send named events from your own code after a signup, download, or other intent signal:

antics.event('signup', { plan: 'pro' });
antics.event('download', { file: 'report.pdf' });

Event properties are stored as JSON and appear on the Events page. Instrument real outcomes, not every minor click. Custom events are available on Pro and Team.

Product event prefixes

TurtleTech products share one Antics workspace. Version the prefix, not the verb. The Events page family chips filter on these prefixes.

FamilyPrefixes
Ridleyridley_*
OokCiteookcite_*
Dashboarddashboard_*
Authsignup_*, login_*, forgot_password_*

Add a new product with a new prefix. Do not rename an existing prefix.

What the script does not do

  • It does not set or read collection cookies.
  • It does not read or write localStorage or sessionStorage.
  • It does not probe canvas, fonts, or WebGL.

Collection details are in privacy. Reading-time pause rules are in reading time. Privacy ยท Reading time