Time to read: 15 min.

The article covers the following topics:

Affise provides you with the opportunity to add and use your custom tracking domain in addition to the default one. You are able to set new domains yourself now, without contacting support.

The feature is available for clients with all plans, but the limit on custom tracking domains depends on the type of plan. Read more about Affise plans here.

To increase the number of custom tracking domains, you should buy a bundle of domains. The bundle can contain 5, 10, and 20 domains. To buy the bundle, contact your Customer Success manager.

Custom tracking domain implementation

Go to the Settings section > Tracking domains section > Default URL's tab:

The adding/changing the tracking domain includes the next steps:

Step 1. Buying the domain on the hosting provider side

Check if your domain includes no less than three levels (ex. tracking.rocketcompany.com) and the domain name has at least 5 characters.

Step 2. Verifying the DNS configuration of the domain

Check if the CNAME record of your domain is set up to be an alias to your default domain name.

You can easily do that in one of the following ways:

  • Check it on your provider's side.

  • Check it on your own according to your operating system:

For macOS:

If the OS of your computer is iOS, you need to navigate to Launchpad > Other > Terminal and use the ‘host’ command. Type the following command: 'host your domain', click on the Enter button. The response should contain the Affise default domain as an alias.

Ex.:

host admin.rocketcompany.com admin.rocketcompany.com is an alias for offers-rocketcompany.affise.com. offers-rocketcompany.affise.com is an alias for rocketcompany.affise.com. rocketcompany.affise.com has address (here your IP-address)

For Windows:

For Windows users, the command prompt (command line) is used.

Type the following command: 'nslookup your custom domain', click on the Enter button. The response should contain the Affise default domain as an alias.

Ex.:

C:\Users\HP>nslookup admin.rocketcompany.com ╤хЁтхЁ: router Address: (IP address) ╚ь : rocketcompany.affise.com Address: (IP address) Aliases: 
admin.rocketcompany.com offers-rocketcompany.affise.com

Step 3. Buying and verifying SSL certificate (optional)

Kindly note that Affise strongly recommends using trusted domain hosting services such as Verisign, DigiCert, Comodo, Godaddy, etc. We do not recommend using Free SSL certificates services such as Let's Encrypt, which can issue and result in browser warnings. Please, remember, that untrusted certificates setup may potentially cause traffic losses.

  1. Purchase SSL-certificate (.crt), Private Key (.key), bundle (.crt) for the domain name from the hosting side.

    • SSL-certificate (.crt) - a security protocol that secures data between two computers by using encryption.

    • Bundle (.crt) - the file that contains root and intermediate certificates. It's used in the procedure of SSL certificate implementation. ❗ We highly recommend adding a bundle file to ensure stable clicks flow. Some browsers can block clicks if the domain doesn't contain the bundle file.

    • Private Key (.key) - a separate file that’s used in the encryption/decryption of data sent between your server and the connecting clients.

  2. Ensure the files above match each other and the domain name itself. For this purpose, do one of the following:

    • Check it on your provider's side.

    • Check it on any open source as, for example, on this one:

https://www.sslshopper.com/certificate-decoder.html

If you've faced with several options of the Software existing when trying to get a certificate and key, choose one of the following options:

  • Apache

  • Nginx

Step 4. Adding custom tracking domain

  1. Go to the Settings section > Tracking domains section > Tracking domains tab and click Add new domain.

  2. In the open window, enter your domain name to the correspondent field.

    The added domain will be checked automatically by four requirements which you can see in the picture.

  3. According to the connection type that you want to use, do one of the following:

    • Enable the HTTP checkbox and proceed to point 6.

    • Enable the HTTPS checkbox.

  4. Enter your SSL-certificate (.crt) and Private Key (.key) into the SSL-certificate (.crt) and Private Key (.key) mandatory fields respectively. If you have a bundle file (.crt), which must contain two certificates, insert both of them to the SSL-certificate (.crt) field right below the SSL-certificate without any spaces.

    ❗ Affise doesn’t store SSL-certificate and Private Key to protect this private data. So if you change the domain name, you have to add this data again.

  5. If you use Cloudflare, enable the correspondent checkbox.


    Cloudflare is a network that serves for domain protection from malicious activity and speeding up websites. It also helps to secure APIs, Internet applications, and protect corporate networks, employees, and devices. It's kind of a mediator between the user and the hosting service.

    If you use Cloudflare and enable the correspondent checkbox, you don't need to specify the Certificate and Private key fields when selecting the HTTPS connection. Certificate and Private key should be set by you on the Cloudflare side. Otherwise, the domain will get the 'Rejected' status after saving.

    If you use Cloudflare but don't enable the Cloudflare checkbox, you'll have to specify the Certificate and Private key fields.

    In case if you don't use Cloudflare but enable the correspondent checkbox, the domain will get the 'Rejected' status after saving.

  6. Click Save.

There is a list of common mistakes that can be made while setting custom tracking domains:

1) 'You are over the limit. To extend the current limit, please purchase a bundle by contacting your dedicated Customer Success manager' - the limit is exceeded, contact your Customer Success manager to buy a bundle.

2) 'Certificate is required for HTTPS domain' - certificate is missed, enter your сertificate into the correspondent field.

3) 'Key file is required for HTTPS domain' - private key is missed, enter your private key into the correspondent field.

4) 'Error: The given private_key is not correspond to the certificate' - check if your private key and certificate are valid and ensure they match each other and the domain name itself. Read more about that here.

Step 5. Ensuring your tracking domain' status has changed from Verifying to Active

Once you add a new tracking domain, it takes the status Verifying, which means validation is in progress (it takes up to 5 minutes to check the domain and change the status from Verifying to the relevant one).

The changing from Verifying to Active status means that validation was successful.

If your domain changed status to Rejected, it means that validation wasn't successful and the domain is not set.

Read how to fix it here.

The domain's implementation is completed. But you may need to perform some extra steps:

  • Proceed with step 6 to make your custom tracking domain as default.

  • Proceed with step 7 to make your custom tracking domain as default for a particular offer.

Step 6. Making custom tracking domain as default (optional)

If you want to make your tracking domain a default one so that all your tracking links and tracking pixels use your new domain by default, click the Set as default button:

Step 7. Making custom tracking domain as default for a particular offer (optional)

If you want to set your tracking domain as a default for tracking links and pixels of a particular offer, do the following:

  1. Go to the offer and select the needed domain in the Tracking domain URL field.

  2. Click the Check domain button.

  3. Click Save.

❗ The domain with the status Active only can be set in the 'Tracking domain URL' field. Otherwise, you can see the message 'Domain is not active, please try again later'.

You can see this domain on the offer preview page:

❗ In case you set the domain in the offer as a default, but then decided to edit it in the Setting (e.g. update the Certificate), these actions of status changing (Active > Verifying > Active) don't affect the tracking process.

Custom tracking domain implementation by affiliate

Affiliate domains setting allows affiliates to add tracking domains that they can use from their side. As they can do it themselves, you only need to approve or decline the affiliate's domain. It saves your time and makes the whole process easier.

How it works

Once affiliates implement tracking domains on their side, you see their domains in the Requests tab (Settings section > Tracking domains section):

You have two options:

  • If you want to approve the domain, click Approve.

    ❗ Keep in mind that each approved affiliate’s tracking domain is counted towards your domains' limit.

  • If you want to decline the domain, click Decline.
    In this case, you have to describe the decline reason:

Once you approve or decline the domain, the system moves it to the Affiliates domains tab:

Where:

  • Domain - the domain address.

  • Affiliate - the affiliate who added the domain.

  • Status - the domain's status (active or rejected).

  • HTTP/HTTPS - the type of connection in the domain.

If you approved the domain, the domain gets the Active status.

If you see the Rejected status, two cases are possible:

  • You rejected the domain.

  • The system rejected the domain.
    You can see the note 'Rejected by the system' when clicking the 'i' sign.

Troubleshooting

There are some reasons why your domain can get Rejected status:

1) The domain is not an alias to your default domain name.

Solution: fix the CNAME of the domain in the domain settings on your side. Read more about verifying the DNS configuration of the domain here.

2) There is no connection with the domain either via HTTP or HTTPS.

Solution: check your domain and all documents on the hosting provider side where you bought your domain.

FAQ

1) How can I see logs related to the domains?

In the User activity log, you can find information about actions done with domains. Go to Users > User activity log.

All available types for domains:

  • Adding domain

  • Deleting domain

  • Changing domain schema

  • Setting the default domain

  • Delete the default domain

  • Domain update

  • Adding affiliate domain update

  • Affiliate domain update

  • Deleting affiliate domain

  • Review affiliate domain

2) If I change the domain name, will the counter reduce the number of domains in the limit?

Yes, changing the domain name affects your domains' limit.

3) If I change the connection type, SSL certificate, will the counter reduce the number of domains in the limit?

No, only changing the domain name affects your domains' limit.

You may also find helpful the following articles:


Should you have any further doubts or questions on custom tracking domains adding, feel free to contact our support team via [email protected] operating 24/7 for your convenience.

Did this answer your question?