- 2 Minutes to read
- Print
- DarkLight
Domain Name Setup
- 2 Minutes to read
- Print
- DarkLight
To ensure tracking works reliably across browsers, Mapp Fashion content is delivered via a subdomain of your own domain. This prevents it from being treated as third-party content, which could be restricted by browser privacy settings.
A prerequisite for using any Mapp Fashion functionality (including tracking) is setting up appropriate DNS records and provisioning matching HTTPS certificates. This dedicated domain will serve Mapp Fashion content and enable Customer Journey Tracking.
DNS Configuration
Mapp Fashion content should be served from a subdomain of your own domain.
For example, if your main site is www.example.com
, you might configure a subdomain such as mappfashion.example.com
.
Your DNS provider must create an A record for this subdomain, pointing it to the appropriate Mapp Fashion IP addresses:
Region | IPs |
---|---|
Europe | 15.197.250.114 and 3.33.201.218 |
Australia | 52.223.29.75 and 35.71.155.195 |
HTTPS Certificates
Mapp Fashion services and APIs are only accessible over HTTPS. There are two main ways to provide the required certificates. Our preferred method is via Amazon Certificate Manager (ACM) with DNS validation.
Option 1: Via Amazon Certificate Manager (preferred)
In this setup, Mapp Fashion requests the certificate directly from Amazon. Amazon then verifies domain ownership through DNS validation:
Amazon provides us with a CNAME record.
We sends this CNAME to you.
Once you add it to your DNS configuration, Amazon validates the domain and issues the certificate.
More information on DNS validation
Certificates are always Domain Validated (DV) and valid for approximately one year.
Option 2: Via Your Usual Certificate Provider
If you prefer using your own certificate provider, we can support that process:
We generate a Certificate Signing Request (CSR) with your specified values (organization, country, locality, state).
You send the CSR to your certificate provider.
Once the certificate is issued, you return it securely to us, and we install it on our servers.
This option gives you full control over the certificate type (e.g., EV, DV, validity period, etc.) and the issuing authority.
Frequently Asked Questions
When should DNS records & certificates be set up?
As soon as possible to avoid delays in development.
I have multiple test/development environments - how should this be set up?
You should configure a separate namespace and domain for each environment to avoid your test data influencing the recommendations. The IP addresses above are the same.
I have multiple TLDs in use for different countries (example-clothing.co.uk, example-clothing.com, etc.) - how should this be set up?
There should be an A record for a Mapp Fashion host under each of these domains: mappfashion-production.example-clothing.co.uk, mappfashion-production.example-clothing.com, etc.
What about certificates for test environments?
We can provide these ourselves via Let's Encrypt.
Why are subdomains required?
The main purpose of the CNAME is to avoid 3rd party cookie issues and to allow Mapp Fashion to set cookies that you can read.
Can we still test tracking even though DNS records / HTTPS have not been configured yet?
No, we can't test end-to-end tracking without having the DNS configuration and HTTPS certificates in place.