How do I point a subdomain at Convultra?
The step-by-step for setting up a first-party tracking subdomain such as track.yourdomain.com with a single CNAME record.
On this page · 5 sections
You point a subdomain at Convultra by adding it under Settings → Tracking → Custom tracking domains and creating one CNAME record at your DNS provider. Convultra provisions the SSL certificate. Once the domain is active, the tracking script and every event request come from track.yourdomain.com instead of a Convultra host, which keeps tracking first-party and off the blocklists that ad blockers use.
Do I need this?
No. The default hosts, cdn.convultra.com for the script and tracking.convultra.com for events, work without any setup. A custom subdomain is worth doing when:
- a noticeable share of your visitors use ad blockers or strict browsers
- your security policy requires every request on your pages to be first-party
- you want the tracking domain to be one you control
What you need
- Access to your domain’s DNS records
- A subdomain you are not using for anything else, such as
track.yourdomain.comoranalytics.yourdomain.com - Five minutes
The steps
-
Add the domain in Convultra. Open Settings → Tracking → Custom tracking domains, enter
track.yourdomain.comand click Add Domain. The domain appears in the list with the status Add CNAME record and shows the record you need. -
Add the CNAME record at your DNS provider:
Type Name Value CNAME track.yourdomain.comtracking.convultra.comSome providers want only the subdomain part (
track) in the name field. Use whichever form your provider expects. -
Wait for it to go Active. The page checks every 15 seconds. When it sees the record the status changes to Provisioning SSL, and 1 to 2 minutes later to Active. If you would rather not wait for the next check, click Check Now.
-
Swap the script URL on your site. The Active domain’s panel shows the complete snippet; the only change from the default is the
src:
<script async src="https://track.yourdomain.com/v1/ultra.js" data-convultra-key="YOUR_API_KEY"></script>
The SDK notices it was loaded from your domain and sends all events there.
How to confirm it works
- Open
https://track.yourdomain.com/v1/ultra.jsin a browser. You should see the script. - Visit your site, then check Overview for new visitors.
- Back in Settings, the Active domain shows when it last received an event.
- If you use the API or MCP server,
get_tracking_healthlists the custom tracking domains that are live.
Common mistakes
- Pointing the record somewhere else. The value must be exactly
tracking.convultra.com, notcdn.convultra.com, not an IP address, and not your own site. - Using an A record. It has to be a CNAME.
- Using the bare domain. Use a subdomain.
yourdomain.comitself is serving your website. - Forgetting to change the snippet. Adding the domain does nothing until pages load the script from it.
- A proxy in front of the hostname. If another service answers for
track.yourdomain.com, Convultra cannot provision the certificate and the domain shows Error. Point the record straight at Convultra.
If a domain sits in Error and the message is not clear, email support@convultra.com with the subdomain and we will check it from our side. For the background and the full status table, see Custom tracking domains.