Skip to main content

Domains

Add your websites to a Section so the Tracking Script can capture visitor behaviour

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

  1. Click your Profile Icon and go to Settings.

  2. Open the Section the domain belongs to.

  3. The Domains & Languages tab opens by default in the Section's inner left menu.

  4. Enter a Name to identify your domain β€” this is the friendly label you'll see in dropdowns and reports.

  5. Enter the website address under Domain in the format example.com or example.co.uk (no https://, no trailing slash).

  6. 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

  1. Locate the domain you want to edit in the Domains & Languages tab.

  2. Click the pencil icon on the right end of the domain card.
    ​

  3. Make your changes and click Save.


Delete a domain

  1. Locate the domain you want to remove.

  2. Click the X icon on the right end of the domain card.
    ​
    ​

  3. 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?

  1. Languages β€” Set up language detection for multi-language domains.

  2. Tracking script β€” Find the script and install it on your website.

  3. Cookie settings β€” Configure cookie life time and Person detection for the Section.

  4. About Sections β€” The wider context for how domains fit into Sections.


​

Did this answer your question?