Skip to main content

Program Domain Setup

Updated over a month ago

Adding a Program Domain

Program Domain set up provides a way for you to manage information about your website and program. This information is independent of any individual referral campaign you might be running.

To configure or look up your site's information, navigate to the Tech Center and use the pencil icon to edit your program domain or the + New Domain button to add one.

Screenshot 2024-08-19 at 10.37.17 AM.png

Configuration Options

On the creation page, you will see the following configuration options.

Screenshot 2024-08-22 at 1.27.17 PM.png

Configuration

Description

Program Domain Name

This is the name of your program. It can be whatever makes sense to you. Some ideas: US Refer a Friend, Production Refer a Friend, Staging Refer a Friend, etc.

Referral Domain

A Referral Domain is used in sharing URLs and the location where your landing pages are hosted (Promote Links). This URL will start out similar to "yourcompany.extole.io" but should be updated to your domain. The best practice is to use "refer.yourcompany.com" or "share.yourcompany.com". This process is referred to as branding a program URL and can be done using your Client Services Manager.

Production Sites Extole Should Support Requests From

Here you can add all production sites that Extole should be supporting requests from. This should include only your production domains as events coming from sites in this container will be counted in your program analytics. Note: by putting ".companyname.com" Extole will accept requests from all subdomains. This is important as we also use these sites to detect spam - if someone tries to send a share message with a domain not listed in this site field, Extole will not send the message to protect your users.

Testing Sites Extole Should Support Requests From

Here you can add all testing and staging sites that Extole should be supporting requests from, but events coming from these sites should not be counted in analytics. This should include all of your testing and staging domains. Note: by putting ".companyname.com" Extole will accept requests from all subdomains.

Automatically inject a program label onto this domain (toggle)

This allows you to specify a single Extole program for the domain.

Disable program domain and redirect traffic (toggle)

This is a way to forward all traffic. We do not allow you to delete program domains because there might be links in the wild with the domain you are trying to delete. Instead of deleting the domain, and causing those links to fail, we allow you to redirect them to a different program.

Advanced Configuration

You can open the Advanced menu on the domain configuration screen to access SSL settings.

Screenshot 2024-08-22 at 1.27.30 PM.png

SSL Settings

Private Key

Extole will automatically generate a certificate for your domain using Let's Encrypt.

Public Certificate

Certificate Chain

Did this answer your question?