Custom Domain

🚧

Caution

Custom domain - or link white-labeling - requires the Business or Enterprise Plans.

Overview

Custom domain involves white-labeling Kevel links so your domain, not Kevel's, appears in the URL. To enable this feature, please contact your account manager or Kevel Support ([email protected]).

Setting up CNAMES (Custom URLs)

By default your Kevel account will use the following URL for impression and click urls.

  • Ad requests - e-<networkId>.adzerk.net

With the Custom Domain extension, however, you can use your own URLs for ad serving.

To set up these custom URLs (or CNAMEs), use the following procedure (or have your domain administrator configure this for you):

  1. Verify you have an Enterprise/Business account. If you do not have an Enterprise/Business account, please contact your Account Manager so you can be set up with an account.

  2. Create your new Campaign Name (CNAME) record by entering the Host Name/Alias and Value/Destinations. The table below lists these values.

📘

Note

If a CNAME record for a URL prefix already exists, you must delete that record before proceeding. For example, if you want to create a CNAME record for engine, make sure to delete any existing CNAME records that contain "engine."

Host Name/Alias

Value/Destination

<your-subdomain>

e-<your-networkId>.adzerk.net

  1. When you have created your CNAME record, contact Kevel Support ([email protected]) and provide the following information to ensure your CNAME is enabled:
  • the CNAME you have created
  • the network ID

For example:

I pointed engine.employment.org to e-10231.adzerk.net.

  1. Kevel support will then begin the process of configuring your new CNAME for an SSL domain. Kevel will provide the SSL cert for you.

  2. Once your CNAME is complete, make sure to update your ad code to reflect the new domains; otherwise, your viewers will still see ads served by e-<networkId>.adzerk.net and not your domain. To update your ad code:

  • For API: use your custom domain name url for the API endpoint, and all impression, click and event urls will reflect that domain name.

Example: https://pubs.example.com/api/v2

  • For ados: add the following function to your ad code before the ados_load(); function:

Example: ados_setDomain('your-domain.com');

📘

Note

Keep in mind it may take up to 24 hours for your new CNAME to be propagated on your end.

It is also possible for you to create a CNAME for the creative/image hosting static subdomain (static.adzerk.net), although this is not recommended since we will be unable to provide you a secure certificate. Instead, Kevel provides a proprietary URL for custom creative/image hosting. Contact your account manager or Kevel support for more information on this functionality.