Setting up a subdomain for your website to host iframes is an essential step to let customers complete purchases on your website.
In this article, we’ll explain what a Website Subdomain (Custom Domain) is, why it’s required, and how you can use it within your website integration to provide a seamless online booking experience for customers.
TIP: A Website Subdomain is usually a subdomain of your main website (your primary domain) intended to host Spektrix iframes on your website. You may also need to set up subdomains for use with Dotdigital, System Emails and Spektrix Subsites. To find out more about the different types of subdomains required for Spektrix, read our Support Centre article on Subdomains.
Why use a Website Subdomain?
Setting up a Website Subdomain is an integral part of your Website Integration.
Your website domain is the address or URL where your website can be found. For example,
www.mywebsite.com
When you integrate your website with Spektrix, the default web address for iframes and Web Components is generated using your client name and the domain system.spektrix.com. For example,
https://system.spektrix.com/[yourclientname]/website/…
Because this domain does not match your website’s domain, during the purchase path when a customer is handed over from your website address to the iframe address, some web browsers, such as Safari, will block this request. Since using the iFrame is the only way to process payments through Spektrix on your website, this impacts all your websites that integrate with Spektrix.
If the request is blocked, your customer will receive this Cookie Message which explains why the error has occurred:
To book tickets online, we use Cookies to keep track of your shopping basket while you move around our site. These Cookies don’t collect personal information and aren’t used for advertising. Because of recent changes to the way your browser handles Cookies, you may not be able to complete your booking on this page; read below for assistance.
Here is an example of that image including some suggestions for resolving the issue:
This can occur because the browser assumes that the cookies of the iframes are ‘third party’ and are being used to track the user's behaviour. As a result, the browser will block Spektrix from reading the cookies, which will stop customers when they are trying to purchase tickets online.
-
- What are Cookies?
A cookie is a small amount of data sent from a website which is stored on a user’s web browser. Websites use these temporary files to store information that allows them to identify a user for the duration of the time they spend on the site. These are known as ‘session cookies’.- Why does Spektrix need session cookies?
Spektrix uses session cookies any time a customer interacts with the booking iframe on your website (or any Spektrix venue’s website). This lets us keep track of each customer’s session so that we know which customer’s basket/cart to display.
These cookies let customers move between the different areas of a website without losing information about their authentication (login), or basket/cart contents.
As a solution to this problem, you must use a Website Subdomain which will let your customers stay within a single domain and browse and buy items. When using a Website Subdomain, Safari and other browsers see the cookies as ‘first party’ (coming from your site), rather than ‘third party’.
What is a Subdomain?
A Website Subdomain in Spektrix allows you to use your existing domain (mywebsite.com) for the Spektrix iframes.
This is achieved by adding a short prefix such as tickets. to your website domain.
For example, https://tickets.mywebsite.com/[myclientname]/
This gives you a range of benefits, including:
- A smooth online customer experience: no need for customers to change browser settings.
- Avoid classification as a ‘cross-domain tracker’: customers can browse and buy across a single domain.
- Easier analytics: in Google Analytics, transactions happening end-to-end on one domain mean that conversion tracking is more accurate and far easier to configure.
- Easier for password managers: a simpler experience for any customers who use password managers (applications which store and manage all of your online passwords).
Running multiple websites on one Spektrix system
If you’re using your Spektrix system to run multiple websites from separate domains then you’ll need to set up separate subdomains for each site.
This will mean that customers have separate sessions (i.e. separate baskets/carts) across both sites, although their login credentials will remain the same across both sites.
TIP: A session is the period between when a customer starts and stops interacting with your website, wherein the session will timeout. Sessions can contain multiple page views and transactions.
How to set up a Website Subdomain
To set up a website subdomain, you’ll need the assistance of your web developer.
Follow these steps to set up your website subdomain:
- Choose a subdomain.
- Ask your web developer to complete the required network configuration.
- Contact our Support Team with your new subdomain details.
- Ask your web developer to update or set the references in your web integration.
- Complete the Domain Specific Config for your new Domain.
In the next sections of this article, we’ll go into more detail on what’s required at each stage. Your web developer can find all of the technical documentation they'll need on our Integration Portal.
Choosing a subdomain
The first step for you to think about is what subdomain you want to use. You can use anything you want, but we suggest you add tickets to the start of your existing domain. For example, if your website is mywebsite.com then use tickets.mywebsite.com as your subdomain.
If you are setting up a Spektrix Subsite and your subdomain is purchase.mywebsite.com, then your sub-subdomain would be tickets.purchase.mywebsite.com.
Network configuration
Once you’ve decided upon a subdomain, you’ll need to ask your web developer - or whoever controls your domain/DNS such as your IT team - to complete some network configuration to create your website subdomain.
REMINDER: If you’re creating a subdomain for use with a Spektrix Subsite, you’ll need to set up two different subdomains, as outlined in the How to set up a Spektrix Subsite article.
- Ask your web developer to set up your subdomain and create a CNAME record which points to customers.spektrix.com. You can find more technical documentation for your web developer on our Integrations Portal.
Name Subdomain Domain CNAME iframe subdomain For example: tickets. YOURDOMAIN customers.spektrix.com. - Ask your web developer to check whether there are any CAA records set up for your website. If you already have a CAA record, then in order for your site’s SSL certificate to be issued successfully, your developer will need to add additional new CAA records to your main domain (not your new subdomain) for the following:
- digicert.com
- letsencrypt.org
Website Subdomain request
Next, you or your web developer will need to contact Support to let us know the details of the subdomain you have chosen. This is so that we can configure your new subdomain within your system.
Make sure you include the following information:
- The name of the subdomain you’ve chosen
- Your Spektrix clientname
- Your web developer’s name and contact details
- Confirmation that your web developer has created a CNAME record for this subdomain and pointed it to customers.spektrix.com
- The date you need everything switched on by
- Any other notes about what you need
Once you have this information, fill in the Support Request form.
REMINDER: Please make sure you submit this information the Support Request form, rather than in an email or over the phone.
Update references
Once you’ve had confirmation from the Spektrix Support team that this work is completed, the last thing to do is ask your web developer to ensure your web integration references the new subdomain.
If you’re setting up a new website, make sure your web developer sets all of the references using the correct subdomain from the outset.
If you’re moving to a subdomain from system.spektrix.com, a full list of the references that need to be changed can be found on our Integration Portal.
Once complete, your new subdomain should be up and running within the next 24 hours.
REMINDER: It can take up to 24 hours for references to change over.
Domain Specific Config
Finally, complete the Domain Specific Config for the primary domain.
Domain Specific Config can be found in the Website Admin Interface. This is where you can apply settings which relate to your website integration.
Under Domain Specific Config you will set:
- Style Sheet (CSS)
- Checkout link
- My account link
- Custom / basket cart link
- Website javascript options
- Basket / cart book more tickets link
Follow the steps under the Domain Specific Config section in the Website Admin Interface article.
Additional considerations
If you have been using system.spektrix.com and are now moving to a new subdomain, there are a number of other considerations. We’ve listed them here and linked out to where you can find more information on each topic.
REMINDER: These considerations may not be applicable if you're already using a subdomain instead of system.spektrix.com for your web integration.
Cookies policy
If you have a cookies policy on your website, and if this policy mentions cookies set by system.spektrix.com, you should update this to refer to your new subdomain.
The names of the cookies set, and their usage, will be the same as before, so if you don’t specifically mention the domain in your policy, then you won’t need to change anything.
You can read more about Spektrix Cookies on our Integration Portal.
Password managers
Some of your customers may use password managers in their own browsers to store their login details to your site.
These tools will likely have been storing customers’ credentials against system.spektrix.com, therefore any customers using them will need to re-save their credentials against your new subdomain.
Further Reading
To continue learning about Web Integrations, take a look at the Integrate your Website with Spektrix category on the Support Centre.