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 _CNAME_s), 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 Canonical 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/AliasValue/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 the new CNAME to be propagated.

Kevel does not offer CNAME for the creative/image hosting static subdomains. For more information about this limitation, please refer to the Ad Blocker page.