Documentation

Quick Start

Follow these simple steps to start tracking your website:

Create a free account - Sign up at abstracts.top/register
Add your website - Add your domain and get your tracking token
Copy the script tag - Get your unique tracking code
Paste before </head> - Add the script to your website's HTML

Installation

Add this script tag to your website before the closing </head> tag:

<script src="https://abstracts.top/tracker.js" 
        data-token="YOUR_TOKEN"
        data-scroll-thresholds="25,50,75,100"></script>

Features

Automatic Tracking

Pageviews - Every page load is automatically tracked
Referrers - See where your traffic comes from
Device data - Browser, OS, screen resolution, device type
Languages - Visitor language preferences

Event Tracking

Scroll depth - Track at 25%, 50%, 75%, 100% automatically
Button clicks - All buttons automatically tracked
Outbound links - Links leaving your site, automatically tracked
Downloads - PDF, ZIP, DOCX and other file links, automatically tracked
Form lifecycle - Start, abandon and submit tracked automatically
JavaScript errors - Runtime errors tracked automatically
Custom events - Use the JavaScript API to track anything

Click & Feature Tracking

The tracker automatically tracks button clicks, outbound links and file downloads — no configuration needed.

Automatic events

Event	Trigger	Data sent
`button_click`	Click on `<button>` or `[role="button"]`	`label` (text, aria-label or id)
`outbound_link`	Click on link leaving your domain	`host` (e.g. instagram.com)
`download`	Click on file link (.pdf, .zip, .docx …)	`file` (filename)
`form_start`	First field focused in a form	`id`, `name`
`form_submit`	Form submitted	`id`, `name`, `elapsed_sec`
`form_abandon`	Form started but page left without submitting	`id`, `name`, `elapsed_sec`
`js_error`	Uncaught JavaScript error	`msg`, `file`, `line`
`unhandled_promise`	Unhandled promise rejection	`msg`

Name buttons precisely with `data-abs-track`

Add the data-abs-track attribute to any element to give it a clear name in your dashboard — instead of relying on button text:

<button data-abs-track="signup-hero">Get started for free</button>
<a href="/pricing" data-abs-track="view-pricing">See plans</a>
<div class="tab" data-abs-track="tab-features" onclick="...">Features</div>

Opt out with `data-abs-ignore`

Add data-abs-ignore to any button or form you do not want tracked:

<button data-abs-ignore>Internal action</button>
<form data-abs-ignore> ... </form>

Disable all auto-events

Set data-autoevents="off" on the script tag to disable all automatic event tracking (pageviews are still sent):

<script src="https://abstracts.top/tracker.js"
        data-token="YOUR_TOKEN"
        data-autoevents="off"></script>

JavaScript API

Track custom events using our simple API — useful for videos, modals, filters, and any interaction not covered by automatic tracking:

// Video play
video.addEventListener('play', function() {
  abstracts.track('video_play', { title: video.title });
});

// Modal opened
abstracts.track('modal_open', { modal: 'pricing' });

// Search performed (never log the actual query — privacy!)
abstracts.track('search', { results: resultCount });

// CAPTCHA solved
function onCaptchaDone(token) {
  abstracts.track('captcha_solved', { provider: 'recaptcha_v2' });
  submitMyForm(token);
}

Privacy & Compliance

Abstracts is built with privacy in mind:

No cookies used
No cross-site tracking
No personal data collected
GDPR & CCPA compliant out of the box
No consent banner required in most cases

Platform Support

Abstracts works with any platform that allows custom HTML/JavaScript:

WordPress
Shopify
Wix
Squarespace
Webflow
Ghost
Custom HTML sites
React, Vue, Angular, Next.js, etc.

Need Help?

Contact us at support if you have any questions.