Custom Domain Alias
By default, we serve all the static assets relating to Transcend Consent (JavaScript, CSS, HTML files) from a Transcend CDN. The two most important assets are:
- airgap.js: Core JavaScript module which collects and enforces user consent.
- Sync Endpoint: A HTML file that can facilitate syncing of consent records across subdomains.
The HTML snippet present in your Consent Settings Installation tab displays the corresponding parameters:
src
: the URL at which airgap.js is hosted.data-sync-endpoint
: the URL at which the sync endpoint is hosted.
We offer the ability to easily serve all Consent assets from your own custom domain! There are a several advantages doing this:
- Avoids any potential impact of Transcend being categorized as a tracker by a browser extension or other client-side technology.
- Allows consent to be synced across subdomains of where the sync endpoint is hosted.
- If you want to sync across
foo.example.com
andbar.example.com
, then you need to host your syncEndpoint atconsent-sync.example.com
(we recommend being explicit with your subdomain naming, but any subdomain of example.com would work for hosting the sync endpoint). - If you want to sync across
foo.acme.com
andbar.acme.com
, then you need to host your syncEndpoint atconsent-sync.acme.com
.
- If you want to sync across
Thanks to “CNAME Flattening”, this custom domain alias solution was tested to be on average as fast as direct reference to the Transcend hosted script.
If you want to host airgap.js, follow the steps below
- Contact Transcend if your alias domain is different from your main domain - If your custom domain is different from the root domain used to set up your Transcend account, get in touch with your CX contact and share your URLs so they can be allow-listed.
- CNAME Setup - Depending on your need, create CNAME entries for the following
- Pointing to
www.transcend-cdn.com
to load airgap modules. - Pointing to
www.sync-transcend-cdn.com
to load the sync endpoint. - For example, if you are running Transcend Consent on
acme.com
, we would recommend usingconsent.acme.com
for airgap modules, andconsent-sync.acme.com
for the sync endpoint, so that you can sync consent state across subdomains ofacme.com
.
- Update Custom Domain in Admin Dashboard
- Navigate to Developer Settings > Installations.
- Configure your custom domain and custom sync domains. If setting up multiple sync domains, you can choose which one to use as the “default” sync endpoint that is configured for your bundle.
- Continuing from the example step 2, you would use
consent.acme.com
forairgap.js & Other Consent Modules Domain
, andconsent-sync.acme.com
forClient-side Sync Endpoints
. - At this point, click the
Test
button to ensure that everything resolves correctly using these new custom domains!
- Update your airgap script - Once your Transcend contact confirms your URL is allowed, update the
src
ordata-sync-endpoint
parameter in your airgap loading script and you are set!
- Note: If you are only using a single sync endpoint, that endpoint will be included in your bundle configuration by default, and you do not need to explicitly specify data-sync-endpoint.