Installing the Qualified JavaScript snippet on your website is required for the system to function. In this article, we'll cover:
- An overview of the Qualified JavaScript snippet
- Pages you need to place the snippet on
- How to install the snippet
- How to add website domains you install the snippet on in Qualified
- How to test successful installation
1) An Overview of the Qualified JavaScript Snippet
The JavaScript snippet is a small piece of code that recognizes visitors, communicates to the Qualified application, and takes appropriate actions. When you initially add the Qualified JavaScript to your site, there's no visible change on your website. After the JavaScript is installed, create and activate your Experiences for the Qualified messenger to appear.
To find the JavaScript snippet for your organization, navigate to Settings > Setup.
It's important to note that each JavaScript snippet has a token that is unique to your account. The snippet looks like this:
For Single Page Application (SPA) websites
If your website is a Single Page Application, you will need to add this extra line of code whenever a new "page" is loaded (usually referred to as a rout transition or navigation).
qualified("page");
Delete
2) Pages to Place the Snippet On
The JavaScript snippet must be placed on every page on your marketing site that you wish to track leads and have conversations. Many companies have a team of web developers who have access to the website infrastructure, and only these folks are allowed to add JavaScript. It's important to note that accurate instructions must be given to install the snippet on all marketing web properties to make sure the system is functioning properly. Consider the following pages on your website which may be running on different platforms or CMS systems:
- Marketing website (usually www.company.com)
- Marketing landing pages (might be running on a landing page service)
- Blogs (which usually run on a separate CMS system)
- Any other web pages served by another app (eg, Marketing Automation)
3) How To Install the JavaScript
For Qualified to function properly, it's important to place the JavaScript snippet on all marketing pages, just before the end of the </head> section of your website. You can either add this manually to your website, or if you are using a hosting system or other CMS, there is commonly an area where you can paste this into your <head> section.
Please note that placing the JavaScript within Google Tag Manager can cause Qualified to be blocked by third-party ad blockers. Consider placing them directly on your website, rather than within mission-critical apps in your tag management system. The downside to this action is that depending on the app or script in question, it might still get blocked.
4) How to add website domains you install the snippet on in Qualified
Once the Javascript has been installed, you'll need to add the website domains it has been installed on within Qualified.
To add the website domains for your organization, navigate to Settings > Setup. Next, click on the + button under the "Add website domains" section. You'll minimally need to add two domains to the list:
- Add your website domain without the "www" prefix.
- Add your website domain with a wildcard (*) as the prefix to cover for "www" and any subdomains.
If you have multiple domains (ie. qualified.co.uk) be sure to add these as well.
Example:
Once the website domains have been added, click Save in the upper right-hand corner.
5) How to Test Successful Installation
You'll know the installation is successful by signing into the Qualified application to see your live website traffic. It's a good idea to do a quick test by opening an incognito window and testing all of the sections on your website, including your main marketing site, landing pages, blog pages, and pages served by other apps, such as content pages. You'll see the visitors on your site on the main map, as seen below.
Website Performance
The Qualified JavaScript fires asynchronously on your website after first content paint, so there will be no (or technically a negligible) performance impact to site load time.
The remainder of the loading sequence also happens asynchronously to serve the personalized Experience.
.svg)
