For the complete documentation index, see llms.txt. This page is also available as Markdown.

Heatmap Tracking

Heatmap Tracking

It provides native support for tracking user click interactions on a webpage through the heatmap tracking command. It captures the exact element clicked, its position on the page, and contextual page information, and pushes this data to the JENTIS Datalayer for use.

Tracking Command

  • heatmap

The plugin listens for click events on the document and automatically pushes a heatmap event to window._jts for every click.

Example Push

window._jts.push({
  track: "heatmap",
  type: "click",
  provider: "piwik_pro",
  element: "#main>div.container>button.cta-button",
  url: "https://example.com/landing-page",
  title: "Landing Page",
  position_x: 482,
  position_y: 216,
  category: "Heatmap events"
}, true);

✅ The second parameter true causes the data to be automatically submitted to the server—equivalent to calling track: "submit".

Properties for heatmap

Name
Description
Type
Mandatory
Example

type

Interaction type. Currently always click.

string

no

"click"

provider

Heatmap platform identifier.

string

no

"piwik_pro"

element

CSS-like path to the clicked element (e.g. ), built from the DOM tree up to the nearest ancestor with an id, or the document root.

string

no

"#id>div.class>button.class"

url

Page URL where the click occurred

string

no

"https://example.com/product"

title

Page title

string

no

"Product X"

position_x

Horizontal click coordinate relative to the viewport

number

no

482

position_y

Vertical click coordinate relative to the viewport

number

no

216

category

Event category label, configurable per account via the Event category label plugin variable.

string

no

"play"

When to Use Heatmap Tracking

Track click events across a webpage to build heatmap visualizations to:

  • Identify high- and low-engagement areas

  • Analyze user interaction patterns per element

  • Segment audiences based on click behavior

Last updated

Was this helpful?