clusterUUID

clusterUUID is a unique identifier assigned to a browser or device. It enables associating multiple requests with the same user session across page loads and visits.

Tracking Modes

clusterUUID can be generated in two modes—Basic and Advanced—each balancing reach and precision. Each mode is chosen when creating an API key in your dashboard.

Basic

Basic mode relies solely on first-party signals gathered from the browser itself. It does not incorporate third-party network intelligence, so multiple users may share the same clusterUUID. This results in broader clustering and lower uniqueness.

Advanced

Advanced mode augments browser signals with MaxMind IP intelligence. By factoring in attributes such as anonymization services, connection type, and ISP, it delivers the highest level of uniqueness while dramatically reducing false positives. Advanced mode is especially effective at distinguishing users behind privacy-preserving networks like iCloud Private Relay.