DNS Settings
Configure a custom domain for your Hardal requests
Overview
Setting up a custom domain for Hardal allows you to maintain first-party data ownership and improve the reliability of your analytics data collection. This guide will walk you through the process of configuring a CNAME record for your domain.
Prerequisites
Before you begin, ensure you have:
-
Access to your domain’s DNS settings
-
Access to your Hardal dashboard
Setting up a custom domain might require for access to sensitive and technical tools, proceed with caution.
Setup Process
Get Your CNAME Details
-
Log into your Hardal dashboard
-
Navigate to Settings
-
Select the “Setup” tab
-
Scroll down to “Custom Domain Guide” section
-
Note your unique CNAME record details. It should look like following:
Name | Type | Value | Reason |
---|---|---|---|
signal | CNAME | <your-signal-id>-signal.usehardal.com | Hardal Cookieless Analytics |
capi | CNAME | capig.usehardal.com | Meta CAPI |
Add CNAME Record
Access your domain provider’s DNS settings and add a new CNAME record.
The exact location and labels for these fields may vary depending on your domain provider. Common variations include:
-
“Host” might be labeled as “Name” or “Label”
-
“Target” might be labeled as “Value” or “Destination”
Verify Setup
-
Return to your Hardal dashboard
-
Go to the Custom Domain section
-
Type your new domain into Check Status
-
Click the Check button to see if your CNAME record is working
DNS changes can take up to 72 hours to propagate, though they often complete within a few hours.
Update Hardal Endpoints
Once verified, update your Hardal endpoint URLs with the new custom domain endpoint.
After clicking Check button and get success, Hardal scripts will be updated with new endpoint URLs.
Troubleshooting
Common Issues
CNAME Verification Failed
CNAME Verification Failed
If the CNAME verification fails:
-
Verify DNS Record:
-
Check if the CNAME record was added correctly
-
Ensure there are no typos in the host or target
-
Confirm the record is saved properly
-
-
Check Propagation:
-
Use a DNS lookup tool to verify propagation
-
Wait at least 4 hours before retrying
-
Clear your DNS cache if needed
-
-
Domain Provider Settings:
-
Some providers require full domain paths
-
Check if subdomain creation is restricted
-
Verify no conflicting records exist
-
Events Not Recording
Events Not Recording
If events aren’t being recorded after setup:
-
Script Configuration:
-
Verify the endpoint URL matches your custom domain
-
Check for any console errors
-
Ensure the script is loading properly
-
-
Network Issues:
-
Verify SSL/TLS configuration
-
Check for any corporate firewall restrictions
-
Confirm DNS resolution is working
-