Help Center

Creating and configuring BlueConic hostnames

Customer data that you collect and activate via BlueConic is by definition first-party customer data. Recent changes to browsers' protection technologies highlight the value of your first-party data. To ensure that your BlueConic-enabled content is appropriately recognized as first party, it is important to create a first-party BlueConic hostname in for each channel in your BlueConic tenant.

This article describes how to use the First-Party Hostname Console (FPHC) to:

For information on the benefits and importance of first-party data, see BlueConic hostnames overview. If you are migrating an existing BlueConic hostname to the new DNS protocol, see our migration guide.

Before you begin

Before starting the process below, inform your IT team about the update and ensure there are resources available to change DNS entries with your DNS provider (for example, Amazon Web Services, etc.). BlueConic will serve as the DNS provider for the first-party BlueConic hostname subdomain, so your DNS provider will need information to delegate serving the specific subdomain to BlueConic. The general process is similar for all DNS providers. In the instructions below, we use  Amazon Route 53 to illustrate adding a hostname with AWS as DNS provider. DNS records should be registered with your DNS provider within 14 days of receiving them from BlueConic.

Note: You will only be configuring DNS records for your specific subdomain, not for the entire domain. For instance, if your hostname is, these records will exist within the main zone but won't have any effect on the DNS routing for the main hostname.

Creating a BlueConic hostname

Start by creating a first-party BlueConic hostname for each channel in your BlueConic tenant.

  1. In the BlueConic navigation bar, select Settings > Channels and BlueConic hostnames. and open the First-Party Hostname Console window (FPHC). 
  2. Click the "Add BlueConic hostname" button to create a new hostname. Follow the instructions that appear in the pop-up window.
    Note: Certificates for hostnames are administered through Amazon Web Services (AWS), which no longer accepts or renews certificates for the following top-level domains: .RU, .BY, Бел - Belarus, Рф - Russian Federation, .moscow, .москва - Moscow, .SU - Soviet Union, .RU.COM, .РУС, .RU.NET. For this reason, you cannot enter these top-level domains in the hostname UI.
  3. For the BlueConic hostname, you can use the random string provided or customize it. You can use the random 4-digit string provided or customize it (up to a maximum of 253 characters). Valid characters include: a-z, 0-9 (but not as the first character), and - (but not as the first or last character). Do not use brand names or other identifiable strings that might be misconstrued as third-party hosts.
    Note: Remember to add the initial underscore for the CNAME validation record. Be sure to use the exact name/value including the underscore when entering this information.
  4. Select or enter email recipients to receive instructions for changing the NS records at your DNS provider. You can send them to yourself, your IT team, or both.
    Note: We recommend that you let your IT team know about this request to ensure they have the time and resources to help with the process. 
  5. Click Confirm BlueConic hostname and you will be brought to the hostname overview page.
    The status will show "Pending DNS change" until you or someone on your IT team updates your DNS provider with the new hostname information, and BlueConic can detect the changes propagated through the DNS.
  6. Your IT team or you should follow the instructions (detailed below) emailed by BlueConic for creating NS records in your DNS provider to give permission for BlueConic to serve as the DNS provider for this subdomain.
  7. Wait for an email notification from BlueConic that the requested DNS infrastructure changes have been made.
    Note: If the BlueConic hostname status shows "Extra validation required," contact your Customer Success Manager for more information.
  8. When you receive notice that BlueConic has created the necessary infrastructure, place the BlueConic script on every page of your channel as described in the instructions in the email.
    For details see Placing the updated BlueConic script on your site.

Configuring your DNS records

BlueConic serves as a DNS provider for your first-party BlueConic hostname. This calls for updating NS records for this specific first-party BlueConic hostname with your DNS provider. The following procedure illustrates the process using Amazon Web Services and Route 53 as DNS provider for adding records for an example BlueConic site. For other DNS providers, the general steps you follow are similar.

Email notifications

During the BlueConic hostname setup process, you can choose to send email instructions for updating the NS records. BlueConic will also send email notifications when the BlueConic hostname's status changes, for example when the hostname is ready to use, or if a problem arises.

Updating your DNS records

Retrieve your DNS instructions, and follow these steps:

  1. Retrieve the email from BlueConic with details on your site's BlueConic hostname.
    This information is also available in the BlueConic UI, by opening Settings > Channels & BlueConic hostnames, and under DNS instructions, clicking Show.
    Under the heading Value, you can see the "Value" of the NS records you need to add.
    Note that you can also export all of the DNS records from the BlueConic hostnames page (choose Settings > Channels & BlueConic hostnames), as shown here:
  2. Open Amazon Web Services (or your web provider), and in the Management Console, open Route 53.
  3. In Route 53, open your hosted zones.
  4. Find your domain's records and open them.
  5. Select your domain and click Create record.
  6. Create a new NS record (record type) and use the NS record values you received from BlueConic: the value(s), TTL, and record name(s). Click Create records.
    BlueConic will poll the DNS server to see when these records have been added. This can take up to 48 hours to propagate. The Status field in BlueConic shows "Pending DNS change." 
    Note: If you are using a different DNS provider, you may need to enter the hostname prefix that BlueConic generates to the Name field when you add NS records.
    Once the change takes place, BlueConic will set up the infrastructure for requests to be sent to BlueConic servers. On Route 53, you can select the new hosted zone to view its details.
    BlueConic-FPHC-hosted-zone-details.pngThe BlueConic infrastructure setup changes can take a several hours for all DNS records and servers to sync across the Internet.
    Note: When adding NS records, adding a dot at the end of the domain name is required to make the domain name absolute (fully qualified) rather than relative. If your DNS provider doesn’t add a dot, make sure you add one as above to make these absolute domain names rather than relative.

ACM validation requests: If the BlueConic hostname status shows "Extra validation required," contact your Customer Success Manager for more information.

Updating your Content Security Policy

If you have a Content Security Policy (CSP) on your website, update it to include the BlueConic URLs. Once the BlueConic hostname is ready to use, traffic will arrive via the BlueConic hostname (independent of whether you have updated the BlueConic script on your website).

Place the updated BlueConic script on your site

  1. Once your infrastructure is ready, you can place the updated BlueConic script on your site.

  2. Click Show in the BlueConic hostnames window, or retrieve the email BlueConic sent containing your JavaScript tag.
  3. Follow the instructions on this page to update your script: Placing the BlueConic tag on your site.

Updating existing BlueConic channels with a new BlueConic script

To update existing BlueConic channels with new BlueConic hostnames, you need to update the BlueConic script to use your new custom hostname. If your BlueConic script currently references the standard BlueConic hostname and script, you would update this to the newly suggested script. When you use custom first-party BlueConic hostnames, your script follows this format:

<script src="https://[]/script.js"></script>

For example, you would update

<script src=""></script>

on all pages to

<script src=""></script>

There are several ways to update or add a BlueConic hostname for your channels:

  • Open the Settings > BlueConic hostnames page and select the existing domain.
  • For new channels, you would use the Channel wizard that appears when you click the Add channel button in the Settings > Channels page.
  • Use the Settings > Channels page. The best process for updating existing channels is shown here:
  1. In the BlueConic Settings menu, select Channels and hostnames. 
  2. Open the Channels window and select a BlueConic channel to customize.
  3. Click BlueConic hostname to customize the hostname for this channel.
    You can use the string BlueConic provides or customize it yourself. Best practice is to use a unique string of letters and numbers. Avoid using brand names.
  4. Select whether to email instructions to yourself (recommended) and your IT team (also recommended). Add the email addresses and click Apply.
  5. Save your changes.
    The new first-party BlueConic hostname has been created. Next steps are for your IT team to configure your DNS records with your DNS provider. See Configuring your DNS records for detailed steps.
    Once your DNS records are updated with your web provider, you can replace your existing BlueConic script with the updated script using a BlueConic hostname.

Troubleshooting tips for configuring hostnames

Reverting while troubleshooting

If your DNS records are incorrectly changed, you will receive an email indicating there are problems. Note that you can either revert to your old records or fix the new records.

Add the initial underscore for the CNAME validation record

Remember to add the initial underscore for the CNAME validation record, and be sure to use the exact name/value including underscore when entering the CNAME validation record.

If you have questions about any part of this process, see our FAQ or contact BlueConic Support for assistance.


Was this article helpful?
2 out of 4 found this helpful