Custom Domain Setup

How to setup custom domains for the Swaarm Platform

Updated over a week ago

IMPORTANT

You can only use domains that you own.

It is advised to not use trackswaarm or anything similar in your custom domain.


You can customize your App, Tracking, Feed API, Partner Platform, Postback, SQL Studio and Explorer domain with Swaarm.

How to setup your custom domain:

Before you can update the custom application domain setting, you will need to update the DNS for the domain. Add the CNAME to your Swaarm subdomain for your choice of App, Tracking, Feed API, Partner Platform, Postback, SQL Studio or Explorer.

CNAME: lb.internal.swaarm.com

Once the CNAME is set, please enter your custom domain in the field. Once verified you will be able to use that domain. (Verification takes a few minutes to an hour).

You can have up to a max of 5 custom domains per section.

  • Application domain

This allows you to host your Swaarm platform on a custom domain.

Example: affiliates.yourcompany.com

  • Tracking domain

This allows you to host your tracking URLs on a custom domain.

Example: tracking.yourcompany.com

  • Feed API domain

This allows you to host your feed API for your partners to access on a custom domain.

Example: feedapi.yourcompany.com

  • Partner Platform domain

This allows you to host your Swaarm partner platform on a custom domain.

Example: partners.yourcompany.com

  • Postback domain

This allows you to host your postback URLs on a custom domain.

Example: postback.yourcompany.com

  • SQL Studio domain

This allows you to host your SQL Studio on a custom domain.

Example: sqlstudio.yourcompany.com

  • Explorer domain

This allows you to host your data Explorer on a custom domain.

Example: explorer.yourcompany.com

  • Creatives domain

This allows you to host your creatives on a custom domain.

Example: creatives.yourcompany.com

Subdomains

You can create subdomains typically from wherever you manage your domain. This could be GoDaddy, NameCheap, or any service you use to manage your domain.

Here are links to some external platforms that will help guide you on setting up a subdomain:

Why would you add a subdomain?

Besides the ability to customize your domain with subdomains, such as "track.adnetwork.com" or "postback.adnetwork.com". You may want to add a subdomain to diversify your URLs for external partners.


Tracking Domains per Entity

You can now enable different custom tracking domains per advertiser, publisher and offer. For example you may have your default domain exampledomain.com but for one specific publisher you want their tracking links to be under trackingdomain.com. Keep in mind your domains must be verified before setup and as always you must own the domain.

  1. Go to the entity you want to change domains

  2. Click Edit in the top right corner

  3. Go to the Tracking Domains tab

  4. Select the tracking domain you want displayed

  5. Click save

In the feed API and in the push tool the newly saved domain will be shown.

The hierarchy is as follows:

  • Offer

  • Publisher

  • Advertiser

  • Global

This means that if you change a domain for both the specific Offer and Publisher, the Offer will take priority.

💡Note: Advertiser postback link should show the original domain and not be impacted by the custom domain.

Did this answer your question?