/w=32,quality=90,fit=scale-down){kind=small}
Getting started
/w=3840,quality=90,fit=scale-down)
New to Squaredance
Guides
FAQsBrands
Brand Quick Start
Campaigns
Partnerships
Brand Reporting
Managing Creatives
BillingPartners
Partner Quick Start
Tracking & Integrations
Partner Reporting
Submitting Creatives
Payouts
ReferralsTechnical Docs
Tracking ChangelogBring Your Own Domain
/w=48,quality=90,fit=scale-down){kind=small}
BYOD utilizes DNS CNAME records, both as a form of verification, and as a mechanism of action. The provided CNAME record is unique to your organization, and by adding it to your DNS configuration you effectively demonstrate that you are the domain owner and that you would like to import it into our system. Functionally, the CNAME record delegates serving content on the specified hostname to us, which we will then use to fire any pixels that you configure under it in the platform. Due to the nature of DNS, and in the interest of ensuring simple, highly-available infrastructure any domains used for BYOD will be unavailable for all other purposes.
Configuring your domain to your Squaredance Account
Prior to configuring your tracking domain on the Squaredance Platform, we highly recommend you verify domain with Facebook. You can find further instructions here. You'll want to verify your TLD+1 with Facebook, which in practical terms means the domain name exactly as you purchased it.
Step 1
Go to the left sidebar of the platform and click on the “Settings” tab where you'll find the "Organization" button. Click the custom domains subheader, and select the add button at the bottom.
A new drawer will show where you can insert your custom domain. Since these domains cannot be used for other purposes, we're only supporting importing subdomains at this time. You're able to define as many subdomains as you'd like, so these will not affect your other operations. We encourage you to define a new subdomain that was not previously used.
Some examples include "log.yourdomain.com" or "events.yourdomain.com". Avoid the use of advertising-related terms, such as "ad", "track", and "pixel" as these may increase the likelihood that your domain will be blocked by ad blockers, affecting tracking accuracy.
In the case where Facebook Domain Verification applies to you, do not worry that this subdomain does not exactly match your verified domain. Any subdomain of your verified domain can be used interchangeably.
Step 2
After entering the full domain name including the subdomain, you'll be presented the DNS configuration information. You will need to log in to your domain registrar's website to add these records. Instructions shown here are from Namecheap, but most providers will be functionally similar. If in doubt, always reference the DNS configuration instructions for your registrar directly (who you purchased the domain from).
Step 4
After you log in to your domain registrar's account, choose the domain that your chosen subdomain sits under and go to settings/manage. Then click on Advanced DNS.
Step 5
Click on Add New Record. Select record type as CNAME Record. Namecheap only requires that you specify the name of the subdomain, without duplicating the root hostname. ie. for "events.mydomain.com", the hostname specified will simply be "events". The other inputs can be pasted exactly as presented in Step 3. Choose a minimal TTL to ensure maximum flexibility and save all changes once done.
Step 6
Go back to the custom domains section of your Squaredance account and click on verify. If it does not verify immediately, you may need to wait up to 72 hours for your DNS changes to fully propagate.
Step 7
You may now assign HTML/JS pixels to fire under this domain, either by editing existing pixels, or creating new ones. You're free to use as many custom domains as needed per campaign, but bear in mind that end-users will be subject to an additional HTTP request for each pixel that utilizes a custom domain.
Common Issues
- Some registrars expect DNS records to only include the hostname portion that is not part of the TLD+1. If this is the case, you would modify the "host" value of your record to be only the name of your subdomain. ie. if you want to register events.domain.com, then the required host value will simply be “events”, or in some cases, “events.@”
- DNS CNAME records cannot be combined with records of any other type. This means the domain you want to import cannot have any other active
TXT,A,AAAA, orCNAMErecords, else your DNS provider will give you an error. We recommend you import previously unused names, which you can confidently dedicate to this purpose. - Choosing a domain name that implies that it used for tracking purposes by using words such as “track”, “ad”, “pixel”, or other ad-industry lingo is a likely way to be preventatively blocked by adblocking systems. We cannot control the effect ad-blockers will have on the name that you choose, and bad choices may result in poor tracking accuracy that cannot be resolved.
- Please verify your TLD+1 with Facebook using the domain verification method. For example you'll verify test.com not jb.test.com on Facebook.