How to Setup a Custom Domain

Role Required: Administrator

Plans Supported: Agency

Before we start, it's important to understand what a Custom Domain is. 

All AdClicks customers get a dedicated sub-domain of their choosing, let's say: agencyname.adclicks.app. This is a great way to ensure your end-clients associate the domain with your Agency. However, some customers may want to take it a step further, and use a different top-level domain that is owned by them. 

For example, you could choose something along the lines of reports.agencyname.com, instead. Notice how the top-level domain is now agencyname.com, and not adclicks.app. The sub-domain is reports, but it could essentially be anything you'd like. 

Setting this up will require the help of a webmaster, unless you are tech-savvy, which is great! 

To get started, head over to Settings on the main navigation bar, and then look for Branding Settings under General Settings. 

Once there, find the Domain Configuration section, and enable the toggle labeled "Enable Custom Domain". 

You will now be prompted to provide a few pieces of information. 

1. Custom Domain URL

This will be entirely up to you. Make sure you pick something short and easy to remember for your end users. 

Please note that you must then head over to your Domain Provider and create a DNS Record (CNAME Record) that points your new sub-domain (reports.agencyname.com in this example) to your AdClicks sub-domain (agencyname.adclicks.app). Here's an example of how that looks in CloudFlare: 

Once you've created the DNS Record, you may need to wait 24-48 hours for the changes to propagate. 

2. SSL Certificate Information

While every sub-domain within AdClicks is covered under our wildcard SSL, if you choose to enable a Custom Domain, then you must provide us with your own security certificate. You can either buy it from your Domain Provider directly or obtain a free one using services such as Let's Encrypt. 

Any new SSL Certificate starts with Certificate Signing Request (or CSR), and a Private Key. Here's an example of what GoDaddy will give you when setting up a new SSL Certificate. It's important to save these values in a note as we will use them later. 

Once you continue and generate your new Certificate, there will typically be three files available (either as standalone files or as a .zip file - depending on your provider): a .crt file, a bundle.crt, and a .pem file. We will only need the first two. 

1. The Private Key we stored earlier, will be used for the SSL Certificate Key (Input 3)
2. The .crt file will be used for the SSL Certificate (Input 2)
3. The bundle.crt file will be used for the SLL Certificate Chain (Input 4) to provide compatibility for older browsers. 

Once you've entered all pieces of information, you can click on Update Domain Settings. 

That's it! You've enabled a Custom Domain for your application.