MaxMind Device Tracking Add-On

A thin loader package for MaxMind's minFraud device tracking system. This package dynamically loads the device fingerprinting module from MaxMind's servers at runtime, ensuring you always get the latest version without updating the npm package.

The package itself contains no fingerprinting logic — it validates inputs, loads the remote module, and returns the tracking token.

Installation

npm install @maxmind/device-tracking

Usage

import { trackDevice } from '@maxmind/device-tracking';

const result = await trackDevice({ accountId: 123456 });
console.log(result.trackingToken);

Ad-blocker bypass

If you proxy MaxMind's device tracking through your own subdomain (to avoid ad-blockers), pass the host option. The module will be loaded from your custom host, and the host value is passed to the remote module for its own use:

const result = await trackDevice({
  accountId: 123456,
  host: 'tracking.yourdomain.com',
});

Disable WebGL hash

For performance or compatibility, you can disable WebGL hash collection:

const result = await trackDevice({
  accountId: 123456,
  disableWebglHash: true,
});

API reference

trackDevice(options: TrackDeviceOptions): Promise<TrackResult>

Loads the device tracking module (if not already cached) and collects a device fingerprint.

TrackDeviceOptions

Property	Type	Required	Description
accountId	number	Yes	Your MaxMind account ID (positive integer)
host	string	No	Custom hostname for ad-blocker bypass
disableWebglHash	boolean	No	Disable WebGL hash collection

TrackResult

Property	Type	Description
trackingToken	string	Opaque device tracking token