Time to read: 10 min.

The article covers the following topics:

Affise provides you with the opportunity to set up your own tracking domains that are available only to you. You are able to add new domains from your panel in Affise, by using the tracking domain feature. This domain is for Affise tracking links, which you use to send clicks to the advertiser. Custom tracking domain allows you to show your brand name in it.

Custom tracking domain implementation

Step 1. Buying the domain on the hosting provider side

Check if your domain includes no less than three levels (ex. tracking.rocketcompany.com.).

Step 2. Verifying the DNS configuration of the domain

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

Use 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 client.rocketcompany.com client.rocketcompany.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 client.rocketcompany.com ╤хЁтхЁ: router Address: (IP address) ╚ь : rocketcompany.affise.com Address: (IP address) Aliases: 
client.rocketcompany.com

Step 3. Buying and verifying SSL certificate (optional)

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 Profile section -> Tracking domains tab and click the Add new domain button.

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

    Affise will check the added domain 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 will 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 a kind of 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. You should set up Certificate and Private key 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 Add new domain.

There is a list of common mistakes that you can make while setting custom tracking domains:

1) 'Certificate is required for HTTPS domain' - you didn't enter the certificate. Enter it into the correspondent field.

2) 'Key file is required for HTTPS domain' - you didn't enter the private key. Enter it into the correspondent field.

3) '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.

After saving the domain, you get the following message 'Your request has been sent to the moderation'.

You can see all added domains on the Tracking domains tab:

Where:

  • Domain - the domain address.

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

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

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

Once you added a new tracking domain, it takes the status Verifying, which means moderation is in progress.

The changing from Verifying to Active status means that the manager approved the domain.

You can see the reason for rejection by clicking the 'i' sign.

The changing from Verifying to Rejected status can mean:

  • The manager rejected the domain.

In this case, you can click Edit to change the settings of the domain and send it to moderation again.

  • The system rejected the domain.

Read how to fix it here.

You completed the domain's implementation.

Step 6. 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, go to the offer and select the needed domain in the Domain field.

❗ You can select the domain with the status Active only in the 'Domain' field.

You can see this domain in the tracking link below.

❗ In case you set the domain in the offer as a default, but then decided to edit it in the Tracking domains tab (to update the Certificate), these actions of status changing (Active -> Verifying -> Active) will not affect the tracking process.

Troubleshooting

There are some reasons why your domain can get Rejected status after approving it by the manager:

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.

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?