Tracking Script Setup Guide

Embed one script, track every click, and catch fake traffic automatically — takes just 5 minutes.

How does the tracking script work?

ClickSentinel ships a lightweight JavaScript snippet (under 10KB) that you embed on your website. Once installed, every click on a button or link is tracked in real time, scored 0–100 for quality, and automatically flagged for suspicious traffic (bots, VPN, Tor, duplicate clicks, velocity spam).

Unlike Google Analytics, which mostly counts pageviews, ClickSentinel focuses on the quality of each click: whether the IP is a VPN/proxy/datacenter, whether the same click repeats abnormally within a few minutes, and whether the click matches bot-like behavior. Everything is processed server-side the moment the request arrives — there's no waiting for a report the next day.

Set up in 5 minutes, no coding required
3-tier automatic fallback (POST → GET → pixel) — works in every browser, even with an ad blocker
Click data shows up in real time in Click Logs, not batched

Key concepts

Quality Score (0–100)

Every click is scored based on IP reputation, click speed, User-Agent and other signals. The lower the score, the more likely the click is fake traffic.

Duplicate Detection

Clicks from the same IP/device repeating within 5 minutes are flagged as duplicates — usually a sign of test clicks or click fraud.

Velocity Flag

More than 10 clicks per hour from the same source get flagged as 'velocity' — a common pattern for bot farming or ad click fraud.

3-tier Fallback

The script first tries sending data via POST; if that fails it falls back to GET, and finally to a tracking pixel — so no data is lost even in restrictive browsers.

How it works

1Sign up for a free ClickSentinel account and create your first Site (enter your website domain).
2Copy the <script> snippet generated for your site and paste it right before the closing </body> tag on every page you want to track.
3Add the data-tracking attribute (or call trackButtonClick()) to the buttons or links you want to track — e.g. 'Contact', 'Buy now', 'Call us'.
4Click the button on your live site, then check Click Logs to confirm the event was recorded along with its quality score.

Frequently asked questions

Will the tracking script slow down my website?

No. The script is under 10KB, loads asynchronously, and doesn't block page render. The impact on page load speed is essentially zero.

Do I need to know how to code to install it?

No. Just copy-paste one script snippet into your HTML/theme — WordPress, Shopify, Laravel, or plain HTML all use the exact same snippet.

Is click data real time?

Yes. As soon as a user clicks, the request is sent to the server and processed through a queue, usually showing up in Click Logs within seconds.

Does the tracking script collect sensitive personal data?

No. It only records the IP (used for quality scoring, never shown publicly), User-Agent, click timestamp and UTM parameters — there's no session replay or personal identification.