Domains
A domain is a website that belongs to your business β for example, heartland.one or shop.dinnerdelights.com. You add domains inside a Section so that Apsis One knows which websites the Section's Tracking Script should monitor, and so that visitor data flows into the right Section's Profile records.
π‘ One Section, many domains
A single Section can contain several domains β useful if your brand operates multiple country websites (e.g. heartland.se, heartland.no, heartland.dk) and you want all their visitor data to land in the same Section. Each domain is added separately and can have its own Languages and Tracking configuration.
In this article
Before you start
To add a domain you need:
Account Owner or Admin User rights.
βThe exact domain name(s) of the websites you want to track β for example, example.com or example.co.uk.
βAccess to your website's HTML or tag manager (you'll install the Tracking Script there in a later step).
βAn idea of which Section the domain should belong to. If you haven't created the Section yet, see About Sections.
β οΈ Domain β Custom domain
This article is about adding the websites you want to track for browsing data and Website tool activities. It's not the same as Custom domain, which is a separate feature for replacing Apsis's tracking domain in email and SMS link previews. Two different things, both involve domains, easy to confuse β make sure you're in the right place.
Public domain suffixes
When setting up your domain, the public suffix matters. A public suffix is a domain ending under which independent websites can be registered β for example .com, .co.uk, or .com.au.
For your domain and Tracking Script to communicate effectively, the suffix Apsis recognises must match the actual public suffix of your domain. The Public Suffix List is maintained as a community resource by Mozilla and is the authoritative reference.
β Tip β Check your suffix before you start
If your domain uses an unusual or country-specific suffix and the Tracking Script status doesn't progress past Pending, the suffix may need verification. Check it in the Public Suffix List first.
Add a domain
Click your Profile Icon and go to Settings.
Open the Section the domain belongs to.
The Domains & Languages tab opens by default in the Section's inner left menu.
Enter a Name to identify your domain β this is the friendly label you'll see in dropdowns and reports.
Enter the website address under Domain in the format example.com or example.co.uk (no https://, no trailing slash).
Click Verify.
β
β
Your domain shows as Pending until the Tracking Script is installed and detected.
Tracking and Languages
Once your domain is saved, two follow-up steps unlock β Tracking and Languages. You need to do both even if you only have one language, the selected set up will be the default if you only have one. See below.
Tracking (single language)
Even if your website is single-language, click Add Language under the domain to start collecting visitor data for the whole domain.
Languages (required, and multi-language possible)
If your website supports multiple languages, set up the languages first, then add tracking for each language separately. Apsis One needs to know how to detect each language so visitor data is tagged correctly. See Languages for the full setup.
β οΈ Tracking is per-language for multilingual sites
β
When you set up languages, the Add Tracking button only appears after you save each language. If you skip the language setup and add tracking for the whole domain instead, your Website tool activities won't be able to differentiate between language versions.
Domain status
Each domain shows a status indicating whether the Tracking Script is installed correctly. Hover over the information icon next to the status to see what each one means.
β
Status | What it means | What to do |
Pending | Apsis One is checking your domain. May take up to one hour after Script installation. | Wait. If it's still Pending after an hour, double-check the Script is on every page. |
Site Unavailable | Apsis can't reach your domain. | Check the URL is correct (no typos, correct suffix), and that the website is publicly accessible. |
No Script | The Tracking Script wasn't found on the page. | Verify the Script is installed correctly in the <head> section of every page. |
Wrong Script | The Script installed belongs to a different Section. | Replace it with the Script from the correct Section under Domains & Languages β Tracking Script. |
Connected | Successfully feeding data into Apsis One. β | Nothing β you're done. |
β Stuck on Pending or No Script?
Double-check that the Tracking Script is installed correctly. If the status still doesn't update after an hour or two, contact Customer Service.
Edit a domain
Locate the domain you want to edit in the Domains & Languages tab.
Click the pencil icon on the right end of the domain card.
βMake your changes and click Save.
Delete a domain
Locate the domain you want to remove.
Click the X icon on the right end of the domain card.
β
βClick Delete to confirm, or Cancel to abort.
β οΈ Deleting stops all incoming tracking data
Once deleted, the Tracking Script for that domain stops feeding data into the Section. Existing Profile data and historical events stay intact, but no new browsing events from that domain will be captured. If you might bring the domain back later, consider just removing the Script from the website rather than deleting the domain entirely.
Troubleshooting
Issue | Likely cause | Fix |
Domain stuck on "Pending" forever | Tracking Script not installed, blocked by ad-blockers/cookie consent, or unusual public suffix. | Verify the Script is in the <head> on every page. Check the Public Suffix List. Test in an incognito window without extensions. |
Status shows "Wrong Script" | You installed a Script from a different Section. | Open the correct Section, go to Domains & Languages β Tracking Script, copy that Script, and replace the one on your website. |
Verification rejects my domain format | The URL has https://, a trailing slash, or a path component. | Use just the domain itself: example.com, not https://www.example.com/. The protocol and path aren't part of the domain entry. |
Multilingual site only shows one language's data | Tracking was added for the whole domain instead of per language. | Set up Languages first, then add Tracking separately for each language. See Languages. |
Visitor data not appearing in Profiles | Tracking Script blocked by missing cookie consent. | Apsis only tracks visitors who accept marketing cookies. Verify your cookie banner is configured correctly. See the Website Tracking collection. |
Want to move a domain to a different Section | Domains can't be moved between Sections directly. | Delete the domain in the current Section, add it in the new Section, and replace the Tracking Script on your website with the new Section's Script. |
What's next?
Languages β Set up language detection for multi-language domains.
Tracking script β Find the script and install it on your website.
Cookie settings β Configure cookie life time and Person detection for the Section.
About Sections β The wider context for how domains fit into Sections.
β







