← Back to Documentation

Getting Started with IterOps

Install the IterOps snippet on your website in under two minutes. One script tag gives you click heatmaps, scroll depth tracking, rage click detection, and no-code A/B testing.

Installation

  1. 1

    Create an account and add your website

    Sign up at iterops.com/register. After signing in, click Add Website on your dashboard and enter your domain. You can track up to 3 websites on the Pro plan.

  2. 2

    Verify ownership

    IterOps verifies ownership via a meta tag you add to your site's <head>. The tag contains your API key so IterOps can confirm you control the domain. Verification confirms you own the domain before tracking begins.

  3. 3

    Install the tracking snippet

    Copy the script tag from your website settings page and paste it before the closing </body> tag on every page you want to track.

    <!-- IterOps tracking snippet -->
    <script src="https://yoursite.com/js/heatracker.js"
        data-api-key="YOUR_API_KEY"
        data-api-url="https://iterops.com"
        defer></script>

    The snippet uses sendBeacon for reliable delivery and adds minimal overhead to page load.

  4. 4

    View your heatmap

    Once clicks start arriving, visit any tracked page with your view token appended as a query parameter to see the heatmap overlay on your live site:

    https://yoursite.com?_heatmap=YOUR_VIEW_TOKEN

    Your view token is available on the website settings page in your dashboard. Keep it private -- anyone with the token can view your heatmap data.

How the snippet works

Two attributes, zero configuration

The snippet requires only data-api-key (your write-only API key) and data-api-url (the IterOps endpoint). Everything else -- click tracking, scroll depth, rage click detection -- is enabled automatically.

Click coordinates as percentages

Clicks are recorded as page percentages rather than pixel coordinates. This means heatmap data stays accurate regardless of viewport size or responsive layout changes.

Dual-mode operation

The snippet runs in record mode by default, capturing visitor interactions. When a page is loaded with ?_heatmap=TOKEN, it switches to view mode and renders the heatmap overlay instead of recording.

Reliable delivery with sendBeacon

Click and scroll data is sent using the browser's sendBeacon API, which guarantees delivery even when users navigate away from the page or close the tab.

Security separation

Your API key is write-only and safe to embed in public HTML. It can only send click and scroll data. Your view token is read-only and should be kept private -- it controls who can view your heatmap overlays.

Frequently asked questions

Does the snippet slow down my website?
No. The snippet is loaded with the defer attribute, so it does not block page rendering. Click and scroll data is sent asynchronously using sendBeacon, which has no impact on page performance.
Do I need to install the snippet on every page?
Yes -- the snippet only tracks pages where it is installed. Most sites add it to a shared layout template so it loads on every page automatically.
What is the difference between the API key and the view token?
The API key is write-only and embedded in your public HTML. It can only send tracking data. The view token is read-only and private -- it lets you view heatmap overlays on your site. This separation ensures visitors cannot access your analytics data.
Does IterOps work with single-page applications?
Yes. The snippet listens for click events on the document, so it works with dynamically rendered content in React, Vue, Angular, and other SPA frameworks.

Start tracking clicks for free

One snippet. 7-day free trial. No credit card required.

Get started free
Support Chat
Support team currently unavailable. Leave a message and be sure to include your email address and we will follow up with you shortly!
Send a message to start a conversation with our support team.