Track links with your domain

Updated

Customer.io provides link tracking by default, but you can also track links on your own subdomain. To use a custom subdomain for tracked links using HTTP in Customer.io, add a CNAME (Canonical Name) record to your DNS host that aliases our tracking subdomains. These are e.customeriomail.com or e-eu.customeriomail.com depending on your Customer.io account region.

To use a custom subdomain for tracking links using HTTPS, you’ll need to take additional steps outside of Customer.io, such as setting up a reverse-proxy server.

Automatic setup (HTTPS)

If you use HTTPS link tracking, you can click Automatic setup to configure your link tracking records without leaving Customer.io. Automatic setup uses Entri, a secure third-party service that connects to your DNS provider and applies the required records for you. Entri is SOC2 and GDPR compliant and doesn’t store your credentials or personal information.

  1. Go to Settings > Workspace Settings > Email, go to the Link Tracking tab for one of your domains, and click Automatic setup.
    The link tracking tab for a domain showing the automatic setup option
    The link tracking tab for a domain showing the automatic setup option
  2. Click Continue and log into your DNS provider when prompted. Entri applies the CNAME and TXT records automatically.
    The Entri setup window showing the continue button
    The Entri setup window showing the continue button
  3. When the setup completes, close the window. Verification can take up to 72 hours, though it typically happens much faster.

If your DNS provider isn’t supported by Entri, or if you use HTTP link tracking, use the manual setup below.

Manual setup

To configure link tracking records manually:

  1. Click Show Records within Workspace Settings > Email and navigate to the Link Tracking tab.
  2. Enter your subdomain.
  3. Find the CNAME record and add to your domain’s DNS host.
    sending_domains_link_tracking_setup.png
    sending_domains_link_tracking_setup.png
  4. Return to the Link Tracking tab of your domain and click Verify domain. We will check that the record is in place. It may take some time for changes to propogate to your workspace. A green checkmark beside the CNAME header means we verified your configuration.

 You must verify your sending domain before your tracked links can use this domain.

On the left hand side of the tab, you will see the status of your link tracking.

  • HTTP link status:
    • A green HTTP link status (shown bottom left) means we are able to connect to your CNAME domain overr HTTP without error. Unless you have successfully configured HTTPS Link Tracking, we’ll generate HTTP links whenever link tracking is enabled in your messages.
    • A red HTTP link status (shown below middle) indicates that our check found a HSTS (HTTP Strict Transport Security) policy on your domain. This means that you must set up HTTPS Link Tracking in order for your custom subdomain to resolve your tracked links correctly.
  • HTTPS link status:
    • A green HTTPS link status (shown below right) means you have successfully configured HTTPS Link Tracking and we’ll generate HTTPS links in messages sent from this domain that have link tracking enabled. The domain must also be verified before your tracked links can use this domain.
HTTP, HTTP with HSTS errors, and HTTPS status for tracked links.
HTTP, HTTP with HSTS errors, and HTTPS status for tracked links.

HTTPS Authentication

To verify HTTPS for non-mobile links, visit HTTPS link tracking. If you also need support for links to iOS or Android apps, checkout universal links.

You can revert back to tracking links through Customer.io (https://e.customeriomail.com / https://e-eu.customeriomail.com) if you’re having trouble with your custom subdomain.

  1. Go to Workspace Settings > Email and click Show Records.
  2. Click the Link Tracking tab.
  3. Under Enter your subdomain, change the Host Name to a non-existing value (ex abc).
  4. Click Verify Domain to remove the link tracking verification from your domain.
  5. Click Close to check that the domain has fallen back to default tracking:
    default-link-tracking.png
    default-link-tracking.png
Copied to clipboard!
  Contents