Skip to main content

Custom Subdomain

What Is Custom Subdomain Integration?​

It allows you to serve the fingerprinting script and API through your own chosen subdomain. This ensures the agent operates in a first-party context, boosting accuracy, avoiding ad-blockers, and complying with strict browser privacy features.

Key Benefits​

  • Higher accuracy & longer cookies: Especially important for Safari/Firefox where third-party storage is heavily restricted.

  • Ad-blocker evasion: Since all resources come from your domain, common ad-blockers won't interfere.

How It Works​

You set up two DNS records for your selected subdomain pointing to our service. We validate domain ownership, automatically provision SSL, and start routing traffic through it.

Important Naming Guidelines​

  • Pick a subdomain without ad-related words (e.g., avoid 'ads', 'analytics', 'stats').
  • Avoid using 'overpoweredjs' in the name.
  • The subdomain should be dedicated to the fingerprinting traffic.

Examples of good names: metrics.example.com, id.example.com, edge.example.com

Integration Steps​

1. Choose and Enter Your Subdomain​

In your dashboard:

  • Navigate to Integrations > Add Subdomain
  • Enter the desired subdomain, e.g., metrics.example.com.

Note: Once registered, subdomains cannot be edited.

2. Update Your DNS Records​

At your DNS provider (Namecheap, GoDaddy, etc.), create the following records:

TypeSubdomainTarget/Value
CNAME_acme-challenge.metrics.example.com(Target address provided in dashboard)
Ametrics.example.com67.205.129.84
  • CNAME record validates ownership and allows automatic SSL issuance.
  • A record routes fingerprinting traffic directly to our infrastructure.

Script loading​

<script src="https://metrics.example.com/opjs.min.js"></script>

Invoke the API:​

opjs({ API_KEY: 'my-api-key', ENDPOINT: 'https://metrics.example.com/fingerprint' }).then(fp => {
  console.log(fp);
});

If you're using Cloudflare, implementing the Cloudflare Integration is advised for optimal fingerprinting performance. Also it's harder for ad blockers to detect it.